(Note that all content in this repository is released under the MIT license. Please carefully read the LICENSE file and properly credit the content before reusing, copying, or adapting it.)
Minesweeper Determinator is a Java application that analyzes the screen to detect the current state of a running Minesweeper game. It determines whether the next move requires guessing or if a logical step can be taken. When guessing is not necessary, it suggests all the next safe moves and can help you click if you want.
Currently, it only focuses on the fitness of the website https://minesweeper-pro.com/. The website is fully functionally cloned in the repository MinesweeperPro and is deployed at https://zhmgczh.github.io/MinesweeperPro/.
- 📷 Screen Capture and Analysis: Automatically captures and recognizes the current Minesweeper board state from the screen.
- 💣 Mine Counter Detection: Identifies the number of remaining mines.
- 🧠 Guess Detection Logic: Determines whether a guess is required to proceed.
- ✅ Safe Move Suggestion & Autoplay: Provides all safe moves and clicks for you when logical deduction is possible.
- ⚙️ Cross-Platform (Java): Runs on any system with Java installed.
- OpenJDK 25 or above
- A browser with the website https://minesweeper-pro.com/ (or https://zhmgczh.github.io/MinesweeperPro/) open
- Desktop environment (not headless)
-
Clone this repository:
git clone https://github.com/zhmgczh/MinesweeperDeterminator.git cd MinesweeperDeterminator -
Run the project through the main class in
Main.java, or simply run it via JAR:java --enable-native-access=ALL-UNNAMED -jar minesweeper-determinator.jar
-
Make sure the Minesweeper window is visible on your screen when running the program.
-
Follow on-screen instructions to let the program analyze the game state and suggest your next move. The best zoom-in percentage is 200%. The board needs to be completely shown on screen.
- Add support for different Minesweeper themes and resolutions.
- Improve OCR accuracy for board state and mine counter detection.
This project is not affiliated with or endorsed by any official Minesweeper developer.