https://github.com/vaandcob/esp32-masternind
An implementation of the Mastermind board game on an ESP32-S3 with a 7" touch display, including full source code and 3D case files.
https://github.com/vaandcob/esp32-masternind
7inch arduino board esp32 esp32-s3 game mastermind touchscreen waveshre
Last synced: 8 months ago
JSON representation
An implementation of the Mastermind board game on an ESP32-S3 with a 7" touch display, including full source code and 3D case files.
- Host: GitHub
- URL: https://github.com/vaandcob/esp32-masternind
- Owner: VaAndCob
- License: mit
- Created: 2025-10-05T12:59:03.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T13:49:33.000Z (8 months ago)
- Last Synced: 2025-10-05T15:25:59.826Z (8 months ago)
- Topics: 7inch, arduino, board, esp32, esp32-s3, game, mastermind, touchscreen, waveshre
- Language: C
- Homepage:
- Size: 23.6 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ESP32-S3 Mastermind Game
This repository contains the source code for a classic Mastermind board game, implemented on the WaveShare 7-inch Touch LCD for the ESP32-S3. The project includes the game logic, user interface created with SquareLine Studio, and drivers for the specific hardware.
A custom 3D-printable case was also designed for this project to provide a clean and integrated final product.
## Features
* **Classic Mastermind Gameplay**: Try to guess the secret 4-peg color code in 12 attempts or less.
* **Timed Mode**: A 60-second countdown timer for each guess adds a layer of challenge.
* **Touch Interface**: A fully touch-based UI for selecting colors and checking your guess.
* **Engaging UI**: A retro-themed interface designed with SquareLine Studio and powered by the LVGL graphics library.
* **Hardware-Specific Drivers**: Includes configurations for the LovyanGFX graphics driver and the CH422G I/O expander used on the WaveShare board.
* **Custom 3D-Printed Case**: STL files for a custom-designed case are available to house the electronics.
## Hardware
This project is specifically designed for the following hardware:
* **Main Board**: [WaveShare ESP32-S3 7-inch Capacitive Touch LCD (800x480)](https://www.waveshare.com/7inch-capacitive-touch-lcd-f.htm)
* **3D-Printed Case**: The STL files for the case can be found in the `/3d-print` directory of this repository.
## Software & Dependencies
Plase read README.md file in "sketch" folder
## How to Play
1. When the device powers on, it will display a "Restart" button. Press it to begin a new game.
2. A secret code of 4 colored pegs is generated.
3. Tap the pegs in the current row to cycle through the available colors.
4. Once you have set your 4-peg guess, press the checkmark button on the right to submit your guess.
5. Feedback pegs will appear:
* **White Peg**: Correct color in the correct position.
* **Black Peg**: Correct color but in the wrong position.
6. You have 12 attempts to guess the code.
7. A 60-second timer will count down for each guess. If you don't submit your guess in time, you lose the game.
8. If you guess the code, you win! If you run out of attempts, you lose. The secret code will be revealed at the end of the game.
## License
This project is open-source. Please feel free to use, modify, and distribute the code. If you create something cool, I'd love to hear about it!