Pigeons

This was made in haste, and the product of procrastination by Physics Group consisting of

1. Chan
2. Hills
3. Ren
4. Kuya Wince

Description

Pigeons! is a 2D projectile-shooting game where you hurl stones at flying birds across a nighttime cityscape. It leverages Pygame’s rendering and audio capabilities to deliver sprite animations, background music, and sound effects (Wikipedia). The physics engine models realistic gravity­influenced trajectories, and each hit awards points and extra ammo.

Features

• Physics-based projectile motion with adjustable angle and velocity.
• Animated sprites for birds and the zombieboy character, using frame-by-frame animations.
• Dynamic leaderboard persisted in JSON, showing top 5 high scores with timestamps.
• Soundtrack and SFX: continuous background music plus throw, explosion, selection, and high-score sounds.

Installation

1. Ensure Python 3.8+ is installed on your system (Wikipedia).

2. Clone this repository:

   git clone https://github.com/yourusername/pigeons.git
   cd pigeons

3. Install dependencies via pip:

   pip install pygame

   (GitHub)

Usage

1. Run the main game script:

   python main.py

   (Reddit)

2. On game over, enter your name (up to 10 alphanumeric characters) to record your score on the leaderboard (Wikipedia).

Controls

• ↑ / ↓: Increase / decrease launch angle (Reddit).
• ← / →: Decrease / increase launch velocity (Reddit).
• SPACE: Throw a stone (if ammo remains) (Reddit).
• ENTER: Confirm name input on game over (Reddit).

Contributing

Contributions are welcome! Please fork the repo, create a feature branch, and submit a pull request (Wikipedia). Adhere to existing code style, include clear commit messages, and document any new functionality in this README (Medium).

License

This project is licensed under the MIT License. See LICENSE for details (Wikipedia).