Hoppy’s Adventure Arcade

A Godot 4 arcade collection starring Hoppy, the CodeRabbit mascot. It has a reactive main menu, three Platformer levels (Bay Area Blitz, Orbital Ops and The Enchanted Repo) and the Endless Runner (The Codebase Corridor). The Beat’em Up includes playable v1 modes: Code City Brawl and Heroes vs. Villains, with three stages each.

Play

1. Install Godot 4.7.1 (standard build).
2. Open hoppys-adventure-arcade/project.godot and press F5, or run:

   godot --path hoppys-adventure-arcade

3. Choose Platformer Game → Level Select, Endless Runner, or Beat’em Up → Play Code City Brawl / Play Heroes vs. Villains.

Action	Keyboard	Controller
Move	A/D or arrow keys	Left stick / D-pad
Jump	Space	A / Cross
Attack	J / X	X / Square
Pause	Escape	Start

In Orbital Ops' zero-gravity bay, hold Jump or Up to rise, hold Down to descend, and release to brake.

Builds

Versioned macOS, Windows, Linux and Web builds come from the Build workflow: releases for v* tags, artifacts for every main push, and preview builds for PRs labelled preview-build. To build locally, run python3 tools/build/export_game.py --smoke. See docs/builds.md.

Run it at a booth

To run a build as an unattended kiosk, pass --booth after --. Add --route=<name> to open a game straight away:

open -a "Hoppy’s Adventure Arcade.app" --args -- --booth --route=heroes_vs_villains   # macOS
HoppysAdventureArcade.exe -- --booth --route=heroes_vs_villains                       # Windows
./HoppysAdventureArcade.x86_64 -- --booth --route=heroes_vs_villains                  # Linux

Booth mode runs fullscreen and ignores the menu's Quit Game, so staff close the window instead. After 90 seconds without input, any game returns to the hub's attract screen, and a lost game sends the player there after a thank-you card instead of offering endless retries. Run it at a booth lists every route and flag.

For a machine that runs unattended all day, follow the booth runbook. It sets up a watchdog that restarts the game if it closes or freezes, along with the Mac's kiosk settings, and covers the staff checklist.

Docs

• Platformer: Bay Area Blitz, Orbital Ops, The Enchanted Repo
• Endless Runner: how to run it, asset budgets, verification. See also its contract and systems.
• Code City Brawl: controls, combat, stages, audio and verification.
• Heroes vs. Villains: controls, capabilities, four villains, audio and verification.
• Heroes vs. Villains asset pack: Mode 2 art, boss moveset catalog and Godot previews; assets only.
• Main menu / arcade hub
• Soundtrack plan: the theme song, its 8-bit derivatives, level music and how to produce and deliver them.

Tests

python3 tools/tests/run_tests.py --godot /path/to/Godot

CI discovers the suites in hoppys-adventure-arcade/tests/: every script that extends SceneTree or MainLoop. Helpers such as tests/support/ are not suites. It runs all of them on every PR, except the few listed with a reason in tools/tests/suites.toml. A suite fails on a nonzero exit, an engine or script error, or a leak. See CONTRIBUTING.md for details.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md and our Code of Conduct. To report a security issue, see SECURITY.md.

License

• Code: MIT
• Assets: individual licenses; see ASSETS_LICENSES.md
• The CodeRabbit name and the Hoppy mascot are trademarks; see TRADEMARKS.md