clupasq/word-mastermind
Word Mastermind is an open-source web game that functions as an endless clone of Wordle combined with the mechanics of the classic board game Mastermind. Unlike the original Wordle which restricts players to one puzzle per day, this software allows for unlimited gameplay sessions. It challenges users to deduce a hidden target word by submitting letter guesses and interpreting visual feedback. The core mechanic involves entering valid words from a built-in dictionary, after which the system evaluates each letter position. Letters in the correct position are highlighted in green, while letters present in the target word but misplaced are marked in yellow. Letters that do not appear in the target word remain unmarked. To assist players, an on-screen keyboard dynamically updates to reflect the status of every letter, showing which characters are confirmed present, confirmed absent, or still unknown. A key feature of the software is its flexibility regarding language and vocabulary. It supports custom dictionary files, enabling the game to be played with various languages and specific word lengths. Pre-configured versions are available for English, Romanian (including 5-letter and 6-letter variants), Swedish, and Dutch. This modularity allows developers and users to easily add or modify word sets to suit different needs or skill levels. The application is built using Node.js and can be deployed via two primary methods. The first and most straightforward approach involves using Docker containers. Users can either pull the pre-built image from the GitHub Container Registry or build it locally from the source code. Once the image is ready, a container can be started to expose the application on port 3333. The second deployment option requires a local Node.js environment with a specific version requirement of 16 or higher, along with the Yarn package manager. After cloning the repository, users install dependencies via Yarn and start the server with a single command. Both methods expose a web interface accessible through any standard browser at the local host address. This software is suitable for hobbyists, developers, or teachers looking for a customizable word-guessing tool that can be self-hosted. Its ability to run in isolated containers or local node environments makes it accessible for diverse technical skill levels. Whether used for entertainment, vocabulary practice, or as a template for game development, Word Mastermind provides a robust and extensible platform for word-based puzzle solving. The codebase is publicly available on GitHub, allowing for community contributions and further customization of gameplay rules or dictionary contents.