PyWeek Challange Entry - Theme: Skyscraper City

Title: Delivery Drone

Objective: 

Control a delivery drone and try to devlier as many packages to the appropriate buildings as possible.
Each package may be red, green, or blue and must match the corresponding building.
While delivering packages, you must avoid colliding with passing birds and planes.
You will have three batteries (lives) that deplete upon collisions or missing the correct buildings.
How many packages can you deliver?

Requirements:

- Python 3
- Pyxel Library
- Microphone (Optional for voice commands)

Installation:

- pip install pyxel
- pip install SpeechRecognition
- pip install pyaudio

Running the Game:

- May be run straight from browser
Or
- python main.py

Game Info:

- Lives: 3
- Timer: Continuous
- Score: High Buildings +5 or -5 if wrong color package
            Medium Buildings +10 or -10 if wrong color package
                Low Buildings +15 or -15 if wrong color package
- Game Length: Designed for 30 minutes of play, or however long you can survive

How to Play:

- Match the packages with the corresponding buildings.
- Avoid birds and planes.
- Don't Miss!
- You have three batteries (lives)

Controls:

- Keyboard Controls
    - Arrow Keys - Left, Right, Up, Down
    or
    - W,A,S,D - Left (A), Right (D), Up (W), Down (S)
    - Tab - Cycle through Package Colors [Red -> Blue -> Green]
    - Spacebar - Drop package
    - P - Pause
    - ESC - Quit

- Voice Commands (if enabled)
    - Say "red" - Drop red package
    - Say "green" - Drop green package
    - Say "blue" - Drop blue package
    - Say "drop" - Drop currently selected package

Gameplay Tips:

- Pay attention to the birds and planes as they keep coming!
- Account for package drop speed when aiming for the building.
- Take your time and save your lives!
- Voice Commands work, but are delayed. Still fun to give it a shot!

Features:

- Voice Recognition [Not incorported in Pyweek submission as it is not compatible with Pyxel HTML]
- Multiple Control Options
- Varying Building Height
- All images stored in Pyxel Image Banks for ease of access

Troubleshooting:

    Speech Recognition Not Working? [This is left for Standalone applications and will not be incorporated in Pyweek submission]

    - Does not typically work in web browser.
    - Use keyboard controls - Tab + Spacebar works identically to voice commands
    - Speak clearly - Say color names distinctly: "Red," "Blue," "Green"
    - Check microphone - Test in another application first

    Game Won't Start?

    - Ensure Python 3.XX installed
    - Install pyxel SpeechRecognition pyaudio
    - Use command line to see error messages
    - Try running directly in browswer

    Game Running Slowly?

    - Close other applications utilizing the microphone
    - Disable Voice Commands

Credits:

- Developer: TiredDadBod
- Pyweek Challenge: PyWeek 40 (20th Anniversary Edition) 2025
- Theme: Skyscraper City

Special Attributions:

- Animated Birds attributed to MoikMellah on opengameart.org
- City Parallax Background with Buildings Pixel Art attributed to FisherG on opengameart.org

Known Issues:

- Building hitboxes are smaller than expected
- If player drops package while in building, score can increase/decrease drastically
- Speech Recognition is slow to respond and may not work properly

Areas of Improvement (Future):

- May work to enhance speech Recognition capabilities and responsiveness
- May store and load high scores
- May incorporate power-up or "wild" package to be used on any building