Space Rangers

Space Rangers is a two-player quick-draw reaction game built for the M5 Go IoT Kit with PlatformIO.

The game starts with an announcement telling both players to get to their spots and get ready. A random goal pattern is selected and shown on screen for a short time. Then the device cycles through random patterns while background western duel music plays. Players must press their button when the game lands on the goal pattern. The first correct press wins the round.

Hardware and Platform

• M5 Go IoT Kit (Core display + speaker)
• 2 player input buttons
• PlatformIO project (space_rangers/)

Project Structure

README.md
├── space_rangers
│   ├── platformio.ini
│   ├── include
│   └── src
│       ├── main.cpp
│       ├── display.cpp
│       ├── sound.cpp
│       ├── speaker.cpp
│       └── icon_renderer.cpp

Game Flow

1. Players are prompted to walk to their positions.
2. The game picks a random goal color.
3. The goal color is displayed briefly so both players can memorize it.
4. The screen cycles through random colors while music plays.
5. Players press their button when the game lands on the goal color.
6. The first player to react correctly wins the round.

Build and Upload Instructions

1. Install VS Code and the PlatformIO extension.
2. Open this repository in VS Code.
3. Open the space_rangers project folder.
4. Connect the M5 Go device by USB.
5. Build firmware:

pio run

6. Upload firmware:

pio run --target upload

How to Play

1. Start the game on the M5 Go.
2. Listen for the ready prompt.
3. Watch the goal color shown at the beginning.
4. Wait during the random color cycling.
5. Press your button as soon as the goal color appears.
6. First correct player wins.

Sources

• Background music (Pixabay): https://pixabay.com/music/modern-country-western-duel-165284/
• Cowboy silhouette image (Pixabay): https://pixabay.com/photos/cowboy-horse-silhouette-man-8272978/