← ALL DOCUMENTS

Ω 23 — FTUE (First-Time User Experience) & Tutorial

23 — FTUE (First-Time User Experience) & Tutorial

Purpose

This document specifies the first-run experience — everything that happens between the player launching the game for the first time and completing their first stage with full understanding of the core controls.

The FTUE must answer four questions before Stage 1 begins:

  1. How do I move?
  2. How do I shoot?
  3. What is the heat bar?
  4. What is the special button?

Everything else — modules, upgrades, Codex, economy — is introduced contextually through play, not front-loaded.


Design Principles

Never stop the player to read

All FTUE teaching happens through action, not text dumps. The player is always doing something. Instructions appear as brief overlays (3–5 words maximum per prompt) that disappear after the player demonstrates the action.

Earn the right to explain

A system is explained only when the player first encounters it. Modules are explained the first time the player opens the hangar after earning enough credits to buy one. The economy is explained when the player earns their first blueprint shard. The Codex is explained when the first entry unlocks.

The tutorial is Stage 0

The FTUE is framed as a training exercise in Coalition flight school — not a tutorial in the game-design sense. Sira-Vel acts as the instructor. The player is already a pilot; they're just learning the specific equipment.


FTUE Sequence

Step 1 — Opening (Skip-able after first completion)

After the title card and "We do not cross." fade:

Sira-Vel voice line (brief): "Commander. Welcome to Achernar. Before the Frontier, one exercise."

Black background, then:

Step 2 — Move

Scene: Empty playfield. Player ship appears at center. No enemies. No bullets.

Prompt (center screen): "MOVE" with a small joystick icon

Action required: Player touches the joystick and moves the ship in any direction.

On complete: Brief chime. Prompt disappears. Sira-Vel: "Good."

Step 3 — Shoot

Scene: Three stationary target drones appear in a row. No movement, no bullets.

Prompt: "FIRE" with a finger-tap icon on the fire button.

Action required: Player taps fire button and destroys at least one drone.

On complete: Drone explodes with satisfying burst. Prompt disappears. Sira-Vel: "Your weapon works. Everything else is timing."

Note: If player holds the fire button and sustains, the heat bar begins to fill. No explanation yet — planting the seed.

Step 4 — Heat

Scene: Six more drones appear. Player is encouraged to keep firing.

Trigger: When heat reaches 75% for the first time, the heat bar pulses and a brief prompt appears.

Prompt (pointing to heat bar): "WATCH THE HEAT" — 3 words, disappears after 3 seconds.

No action required — the player discovers overheating naturally if they keep holding fire. If they overheat, the weapon locks, the padlock appears, and after 2 seconds a prompt: "RELEASE — LET IT COOL"

On weapon unlock: Sira-Vel: "Heat discipline. You'll remember that."

Step 5 — Special

Scene: A single larger target drone appears with a red outline.

Prompt: The special charge arc begins filling rapidly (fast-fill, tutorial-only rate). When full, the SPECIAL button pulses and a prompt appears: "SPECIAL — DEPLOY IT"

Action required: Player taps SPECIAL button.

On complete: Special deploys, drone is destroyed. Sira-Vel: "Specials charge through combat. Use them."

Step 6 — Transition to Stage 1

Sira-Vel: "The Frontier is waiting. Don't stop moving."

Brief black transition → Stage 1 Intel Briefing → Stage 1 begins.

Total FTUE duration: Approximately 90 seconds. Cannot be sped up. Can be skipped on subsequent game installs (save data present).


Contextual Tutorials (Post-FTUE)

After FTUE, the following systems are explained the first time they are encountered:

First Hub Visit (after Stage 1 clear)

A brief overlay highlights the energy bar: "ENERGY — spent on stages, refills over time." One sentence. Dismiss by tapping.

First Codex Entry

When the first codex entry unlocks (Stage 1 clear → C-01 The Telos — Overview), a brief pip animation on the Codex tab + a one-line hub note: "Your Codex has updated." No further explanation — the discovery itself explains the system.

First Build Available (after Sector 1)

When the player has enough credits to build the H-2 Interceptor, a small pip on the HANGAR button and a one-line hub note: "A new ship is within range." No tutorial sheet — the hangar UI is self-explanatory.

First Module Slot (Rank 3)

On Rank 3 unlock, a brief highlight on the module slot in the hangar: "OFFENSE SLOT UNLOCKED — tap to equip a module." One sentence. Auto-dismisses after 5 seconds.

First Boss Stage (Stage 6)

The stage intel briefing for Stage 6 includes an additional line: "Boss encounter. Watch the HP bar at the top of the screen." No other tutorial — the boss HP bar's appearance is self-explanatory.

First Endless Run (after S30)

A brief 3-line overlay before the endless session: "Depth increases each wave. No energy cost. No Pilot XP — only mastery." Tap to dismiss.


What Is Never Explicitly Tutorialized

These systems are designed to be self-discovered or learned through play, with no tutorial prompt:

  • The combo multiplier decay (players notice the arc and learn organically)
  • Blueprint shards (first drop comes with a brief "New resource" label — no tutorial)
  • Ship mastery (visible in hangar, explained by the UI itself)
  • Formation patterns (enemy behavior is the teacher)
  • The Codex content (reading is self-directed)
  • Achievement conditions (visible in the achievement tab — reading them is the tutorial)

Summary — Locked Decisions

  1. FTUE = 4 steps: Move → Shoot → Heat → Special
  2. ~90 seconds total, action-based throughout, no text dumps
  3. Tutorial is framed as Coalition flight school — Sira-Vel as instructor
  4. Skip available on re-install if save data exists
  5. Contextual tutorials for: energy (first hub), module slot (Rank 3), boss bar (Stage 6 briefing), endless intro (post-S30)
  6. Never tutorialized: combo decay, blueprint shards, ship mastery, formation reading, codex content, achievements
  7. Tutorial fire rate is normal — heat behavior is real from Step 3 onward; player discovers overheating naturally

Document version: 1.0 (locked) Part of: Tao Baryon GDD — Tier 4 UX & Meta