Simplify Build Game with Amazon Q CLI on WSL

Hiep Nguyen Dong Thanh — Thu, 29 May 2025 09:12:42 +0000

Rhythm Game

This Pygame-based rhythm game offers an engaging musical experience where players hit falling notes represented by animated animals across multiple tracks. The game features adaptive difficulty progression, responsive design scaling, and a comprehensive scoring system that rewards precise timing and accuracy.

The game combines classic rhythm game mechanics with unique animated characters (bird, frog, rabbit, and cat) that respond dynamically to player input. Each difficulty level introduces new challenges through adjusted note speeds, spawn rates, and timing thresholds, creating an engaging progression system that keeps players motivated to improve their skills. The game automatically scales to the player's screen resolution while maintaining playability and visual clarity.

Repository Structure

.
├── requirements.txt     # Python package dependencies with version specifications
└── rhythm_game.py      # Main game implementation with animation and gameplay logic

Usage Instructions

Prerequisites

Python 3.6 or higher
The following Python packages (specified in requirements.txt):
- pygame >= 2.0.0
- pygame_gui >= 0.6.0
- Pillow >= 8.0.0
- numpy >= 1.19.0
- boto3 >= 1.26.0
- requests >= 2.25.0

Installation

Clone the repository:

git clone https://github.com/hiepnguyendt/Rhythm-Game
cd Rhythm-Game

Install required packages:

pip install -r requirements.txt

Quick Start

Run the game:

python rhythm_game.py

Game Controls:
Use the corresponding keys to hit notes in each track when they reach the target line
Aim for perfect timing to maximize your score
Progress through difficulty levels by maintaining high accuracy

More Detailed Examples

Scoring System:
Perfect hits: Notes hit within 5-20 pixels of the target line (varies by difficulty)
Good hits: Notes hit within 10-40 pixels of the target line (varies by difficulty)
Score multipliers increase with consecutive successful hits
Difficulty Progression:

# Example difficulty settings
'normal': {
    'note_speed': 5,
    'spawn_rate_min': 0.5,
    'spawn_rate_max': 1.5,
    'perfect_threshold': 15,
    'good_threshold': 30,
    'notes_to_pass': 100,
    'accuracy_to_pass': 75
}

Troubleshooting

Audio Latency Issues
Problem: Note hit timing feels off
Solution: Adjust audio buffer size in pygame.mixer.pre_init()

pygame.mixer.pre_init(44100, -16, 2, 512)  # Reduce audio latency

Performance Issues
Problem: Game running slowly
Solution: Check your screen resolution settings

# Adjust screen scale in game settings
SCREEN_WIDTH = max(800, int(user_screen_width * 0.8))  # Default screen scale

Display Scaling Issues
Problem: Game elements appear too large/small
Solution: Modify scaling factors

SCALE_X = SCREEN_WIDTH / BASE_WIDTH
SCALE_Y = SCREEN_HEIGHT / BASE_HEIGHT

Data Flow

The game processes input and updates game state in a continuous loop, handling note spawning, movement, collision detection, and scoring.

[User Input] -> [Input Processing] -> [Game State Update]
      ^                                      |
      |                                     v
[Display Update] <- [Animation Update] <- [Physics Update]

Key component interactions:

Input handler processes keyboard events for note hits
Note spawner creates new notes based on difficulty settings
Animation system updates animal positions and states
Collision detection system checks note timing accuracy
Scoring system calculates points and tracks progression
Display system renders all game elements with proper scaling
Difficulty manager adjusts game parameters based on player performance

DEV Community: Hiep Nguyen Dong Thanh