15
Intermediate
Project guide

Linked Playground Notes

  • By Flobio
    Pyboom - A game for the Fruit Jam

    Py-Boom

    Py-Boom is a fast-paced, 8-bit-style arcade game written in CircuitPython for the Adafruit Fruit Jam and other compatible display boards.

    This game is a modern take on a classic "catcher" formula, featuring both a single-player mode against an AI and a competitive two-player versus mode.

    Game Modes

    At the title screen, you can select your game mode:

    • 1-Player Mode: You control the Bucket (P1) at the bottom of the screen. An AI-controlled Bomber moves at the top, dropping bombs at an increasing rate. Your goal is to catch as many bombs as possible to survive the level.

    • 2-Player Mode: Player 1 controls the Bucket, and Player 2 controls the Bomber. P1's goal is to survive, while P2's goal is to drop bombs strategically to make P1 miss.

    How to Play

    P1 (Bucket) - The Catcher

    • Goal: Catch every bomb that is dropped. If you miss a bomb, you lose one of your buckets (lives). If you lose all three, the game is over.

    • Winning: If you (P1) successfully catch all bombs in a level (e.g., 10 bombs in Level 1), you win the round and advance to the next, more difficult level.

    P2 (Bomber) - The Attacker

    • Goal: Make P1 miss! You have a limited number of bombs per level. Use your movement and timing to drop bombs where P1 isn't.

    • Winning: If you (P2) successfully make P1 lose all three of their buckets, you win the game!

    Controls

    Action

    Player 1 (Bucket)

    Player 2 (Bomber)

    Move Left

    A key

    Left Arrow key

    Move Right

    D key

    Right Arrow key

    Drop Bomb

    N/A

    Down Arrow key

    Start / Ready

    Space bar

    Enter key

    Other Controls

    • Select Mode: On the title screen, press the 1 or 2 key.

    • Restart Game: On the "Game Over" screen, press the R key to return to the title screen.

    Required Files

    To run this game, you will need the following files on your CircuitPython device:

    • code.py: The main game code.

    • The Fruit Jam OS library package. 

    • pyboom.bmp: The title screen logo.

    • bomb_icon.bmp: The bomb sprite icon (used in development).

    Download at: Pyboom Git Hub

     

     

    Background

    This project was started on Microsoft Make Code for my Pygamer and was called Prison Break. With the introduction of the Fruit Jam I wanted to port this over to Circuit Python. The graphics in Make Code (MC) are saved in a TypeScript file so I had to copy the codes for the sprites over to my Circuit Python. I used the AI tools that are part of Visual Studio Code (VS) the develop functions to map the sprites maps into bitmaps and tile grids. I continued to use the AI tools to help convert the Python code from MC. I mostly used Gemini as I have 3 months of premium from purchasing my phone. Though there were times where Gemini would get stuck on fixing issues it was making so I would switch to the free tokens in VS and use Claude or Chat-GPT. I ran out of free tokens in VS and moved on to Gemini for versions 2 and 3 of the game. I am in the process of uploading my prompts that I still have access to (I lost my VS conversations :( ) and hope to have them done in the next week. I also hope to get controllers setup and maybe make paddle controllers in the future.

    I found this a fun project to learn Circuit Python and coding with AI. I'm still learning the concepts of using classes and learned a lot while looking at the errors the AI was coming up with.