| name | pygame-sudoku |
| description | Minimal Sudoku game prototype built with Pygame featuring backtracking solver, puzzle generation, and keyboard/mouse input. Use when asked to play Sudoku, test the Sudoku game, or debug puzzle logic. |
Pygame Sudoku
A minimal Sudoku game prototype built with Pygame.
When to Use
- Play a game of Sudoku
- Test or debug the Sudoku game logic
- Verify game rules: number placement, conflict detection, backtracking solver, puzzle generation
Prerequisites
- Python 3.10+
- Pygame (see requirements.txt)
Usage
python pygame_sudoku.py [--difficulty DIFFICULTY] [--cell-size N] [--log-level LEVEL]
Options
| Option | Default | Description |
|---|
--difficulty | medium | Puzzle difficulty: easy, medium, hard |
--cell-size | 60 | Cell size in pixels |
--log-level | INFO | Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL |
Controls
- Arrow keys: Move selection
- Mouse click: Select cell
- 1-9 keys: Place number in selected cell
- Backspace/Delete: Clear selected cell
- R key: Reset puzzle (same difficulty)
- N key: New puzzle (same difficulty)
- ESC / Close window: Exit
Game Rules
- Fill the 9x9 grid so each row, column, and 3x3 box contains digits 1-9
- Pre-filled clues are fixed (shown in black)
- Player-entered numbers appear in gray
- Conflicts are highlighted in red
- Completing the grid without conflicts wins the game
