The Clicker Challenge

A responsive Tkinter and pygame target-clicking game for Windows. The project uses the actively maintained pygame-ce distribution, which keeps the standard pygame import API and supports current Python releases.

Originally created as a CS 108 final project in Fall 2024, the game uses event-driven desktop UI and audio programming to test reaction speed and precision.

Features

• Four difficulties with the original 30-second game format
• Responsive 16:9 presentation using the original artwork
• Pause, resume, restart, level select, and main-menu navigation
• Accuracy, combo, and up-to-4x score multipliers
• Persistent per-difficulty leaderboards
• Music/SFX volume, mute, fullscreen, and player-name settings
• Local user data stored in %LOCALAPPDATA%\ManteGames\ClickerChallenge

Run From Source

Python 3.11 or newer is recommended.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
python main.py

The original project-level leaderboard.json is imported automatically the first time the improved version runs.

Controls

• Click targets to score.
• Click inside the playfield without hitting a target to record a miss.
• Escape: pause or resume during a round.
• R: restart the current round.
• The settings screen controls audio, mute, and fullscreen mode.

Tests

python -m pip install -r requirements-dev.txt
python -m pytest

Windows Build

Build the windowed PyInstaller distribution and ZIP archive:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\build.ps1

Outputs:

dist\ClickerChallenge\ClickerChallenge.exe
releases\ClickerChallenge-Windows.zip

The ZIP uses PyInstaller's onedir format. Keep all extracted files together.

Website Download Link

Place ClickerChallenge-Windows.zip in your website's public downloads folder:

<a href="/downloads/ClickerChallenge-Windows.zip" download>
  Download The Clicker Challenge for Windows
</a>

A normal browser link downloads the game; it does not directly execute a local Python file.

Author

Nhyira Nana Yaw Mante
Computer Science Student, Calvin University (Class of 2028)
LinkedIn | GitHub

License

Released under the MIT License for learning and modification.