This is a simple Sudoku game built using Python and PyQt5. The application allows users to play Sudoku puzzles, providing features such as:
- Sudoku Puzzle Generation: Randomized puzzles with a unique solution.
- Cell Highlighting: Custom colors to highlight selected cells.
- Error Handling: Alerts and messages for invalid moves or when the player loses.
- Timer: Tracks time taken to solve the puzzle.
- Interactive Interface: A grid-based interface using PyQt5.
- Sudoku Solver: Automatically solves the Sudoku puzzle using Optimazed Backtracking with Lookahead.
- User Interface: A graphical user interface (GUI) built with PyQt5 that mimics a traditional Sudoku board.
- Game Over & Win Notifications: Provides feedback when the player wins or loses.
-
Clone the repository to your local machine:
git clone https://github.com/your-username/sudoku-game.git
-
Navigate to the project directory:
cd sudoku-game -
Install the required dependencies:
pip install -r requirements.txt
-
Run the application:
python main.py
-
Select new game with specified difficulty.
-
The Sudoku grid will be displayed with pre-filled numbers and empty cells.
-
Click on the empty cells to input numbers (1-9).
-
Once the puzzle is solved, the timer will stop, and a congratulatory message will appear.
-
If the player makes three incorrect moves, a "Game Over" message will be shown.
-
Start a New Game with selected difficulty: A new randomized Sudoku puzzle is generated each time the new game is selected.
-
Solve Puzzle: The user solves the puzzle manually.
-
Game Over: After three mistakes, the user loses and a message is shown.
-
Puzzle Solved: When the puzzle is completed correctly, a congratulatory message will appear with the time taken.
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Make your changes.
- Commit your changes (
git commit -am 'Add feature'). - Push to the branch (
git push origin feature-branch). - Create a new Pull Request.