Battle Mode — Math Kids Guide

⚙️ Phase 1 — Battle Setup

Before the duel begins, the setup screen lets you configure everything:

1 Player Names

Enter names for both players

Player 1 is shown in blue, Player 2 in orange. Each name can be up to 16 characters. The names must be different — the Start button stays disabled if they match.

2 Difficulty

Easy / Medium / Hard

The available difficulty levels depend on the current age group:

Age ≤ 4 — Easy only
Age 5–6 — Easy or Medium
Age 7+ — Easy, Medium, or Hard

3 Duration

30 seconds / 60 seconds / 2 minutes

This is the time each player gets for their turn. A shorter time creates a more intense, pressure-filled duel.

4 Rules reminder

3 rules shown on-screen

A countdown timer runs for each player's turn.
Each correct answer scores points plus a speed bonus.
The player with the highest score at the end wins the trophy.

🎮 Phase 2 — Gameplay

Once setup is confirmed, the duel begins in two turns played back-to-back on the same device:

1 Player 1's turn

3-2-1-GO countdown → Player 1 plays

A 3-second countdown appears, then Player 1's timer starts. Questions appear one by one. Answer as many as possible before time runs out.

Each correct answer earns base points + a speed bonus (faster = higher bonus).
A per-question speed bar shows how much time is left for that specific question.
When P1's time is up, a handoff screen appears showing P1's score.

2 Device handoff

Pass the phone to Player 2

The handoff screen shows Player 1's results and a "P2 Ready" button. Player 2 taps that button to start their own 3-2-1-GO countdown.

3 Player 2's turn

Player 2 plays the same set of questions

Player 2 answers the same (or similar difficulty) questions under the same time pressure. When P2's time expires, the battle ends automatically and the results screen appears.

⚠️ There is no pause or exit during active play — the timer keeps running once a turn has started.

🏆 Phase 3 — Battle Results

After both players have played, the Battle Results screen reveals:

🥇

Winner Announcement

The winning player's name is displayed prominently with their colour highlight. Equal scores are declared a draw.

📊

Player Cards

Each player gets an animated card showing: Score, Accuracy bar, Correct, Wrong, Speed Bonus earned, and Time used.

🔍

Question-by-Question Review

Every question is listed with the correct answer and each player's response marked with ✅ or ✗.

🔁

Play Again or Home

"Play Again" returns to Battle Setup with the same names pre-filled. "Home" returns to the main screen.

📸

Add your screenshot here

guide/img/screen-battle-setup.png

Also add gameplay & result screenshots:
screen-battle-play.png
screen-battle-result.png