Fire Nation Attacked

Fire Nation Attacked is a Reachy Mini app that turns the robot into a predictive water-cannon operator. The head pose steers an orbital hose across a 2D battlefield while each antenna controls a different action:

• Left antenna – pull away from center in any direction to spray water and paint predictive puddles.
• Right antenna – move away from center to vacuum wasted water, reclaiming score and clearing penalties.
• Head pose – look around to move the crosshair across the ground battlefield.

Gameplay loop

1. Waves begin the instant you spray the glowing START glyph—no prep countdown—so you can (and should) paint even while “waiting.”
2. Enemy cues appear on the far-left margin three seconds before a unit enters, and a thin neon path projects the next five seconds of its movement so you can pre-draw their demise.
3. Waves contain three custom archetypes:
   • Ember Scouts – fast, straight runners with low HP.
   • Flare Serpents – sinusoidal movers with medium HP.
   • Basalt Guardians – heavy units that march in angular, continuous square waves.
4. To launch the first wave, spray the glowing START glyph on the ground. The local leaderboard (persisted in leaderboard.json) is printed on the start screen and disappears once combat begins.
5. Water splashes persist until an enemy consumes them; perfect play means every drop is used. Any leftover puddles are aggregated into a single penalty circle that must be vacuumed before the next wave can start.
6. Scores are granted per wave. Taking base damage and leaving waste will deduct points, while vacuuming unused water grants a bonus. Grades range from D→S, with S+ reserved for perfect, damage-free, zero-waste clears.

Controls & shortcuts

Mouse/keyboard overrides are meant strictly for browser-only development sessions; keep them disabled when the real robot is connected to avoid conflicting inputs.

Running the app

cd fire_nation_attacked
poetry install  # or pip install -e .
poetry run reachy-mini-app fire_nation_attacked

Then open the Reachy Mini dashboard (or the URL printed in the logs) to load the custom UI served at http://0.0.0.0:8042.

Developer notes

• The backend disables every motor except the antennas to keep the robot safe while still reading head pose and antenna pulls. /reset_session clears scoring data if you want a fresh run.
• /sensor_data streams roll/pitch/yaw plus normalized fire/vacuum strengths. /wave_report lets the UI persist scores/grades (also shown on the HUD), while /play_sound triggers simple hardware sounds hosted in fire_nation_attacked/fire_nation_attacked/assets.
• The frontend is a single canvas scene (static/main.js) with responsive HUD, predictive path rails, Web Audio flourishes (pink-noise spray, triangle vacuum), and keyboard fallbacks (press M to toggle mouse aim, Space/Shift to simulate sprays/vacuums without the hardware).
• Motivational messages for each wave, enemy archetypes, and scoring weights live near the top of static/main.js so balancing can be done without touching the rest of the logic. The end-of-wave summary is rendered directly beside the center puddle to avoid covering gameplay—cleaning the puddle automatically queues the next wave.