This document defines how challenge scales across the Tao Baryon campaign and endless mode, names and characterizes the five campaign sectors, and establishes the philosophical principles that guide all balancing decisions. All stage design downstream must conform to this curve.
Tao Baryon must be playable by a casual mobile player and rewarding for a hardcore arcade player simultaneously.
We achieve this by:
A player who wants easy can over-level by grinding earlier stages. A player who wants hard can attempt stages at the minimum recommended level. Same content, both audiences served.
A stage's effective difficulty is shaped by six tunable variables. All exposed through config files for post-launch tuning.
| Variable | Description |
|---|---|
| Enemy density | How many enemies on screen simultaneously |
| Enemy variety | How many distinct enemy types appear per stage |
| Enemy HP | Sponge factor — how much damage to kill |
| Enemy damage | How punishing a hit is |
| Bullet pattern complexity | Simple straight shots vs. spirals vs. predictive |
| Pickup frequency | How often health/shield/special recharge appears |
A stage's "difficulty score" is a weighted combination of these. Designers tune by adjusting weights per stage.
Lore: The disputed border between human and Telos space. Years of front-line combat have left it a scarred no-man's-land of derelicts, debris, and patrol routes.
Difficulty range: 1 → 8 Stages: 1–6 Recommended Pilot Rank: 1 → 8
Visual theme: Conventional deep space. Distant stars. Occasional human or Telos beacons. The boundary lights of Coalition space visible at extreme edges. Backgrounds are dark, lonely, military.
Audio theme: Subdued, tactical, military procedural. Sira-Vel's voice during intel briefings is calm and rehearsed.
Pacing: Tutorial-friendly. Enemy density low. Bullet patterns simple. Pickups generous. The player learns the joystick, the auto-fire, the dodge instinct, the special button.
Story beats: Patrol missions, supply interdiction, first contact with named Telos commanders. Stage 6 boss: The Reverent Maelin, ace pilot, psalms on hull.
Lore: The deep band of Telos-held space humanity has been pushing into for years. Pilots speak of "being out on the Reach" the way old sailors spoke of being beyond sight of land. It is far. The war has been there longest.
Difficulty range: 9 → 18 Stages: 7–12 Recommended Pilot Rank: 8 → 14
Visual theme: Darker void. Occasional debris fields from old battles. War-scarred derelicts of both factions drift in the background. The dust of long combat.
Audio theme: Music takes on weight. Sira-Vel's transmissions reference older losses, names of dead pilots.
Pacing: Mixed enemy types. Liturgical formations begin to matter. The player must learn to read formation choreography to predict attacks.
Story beats: First indirect Veiled contact (Stage 9 — a Telos merchant transmits coded coordinates mid-battle). The player starts intercepting religious broadcasts and understanding the Quantum Rise doctrine. Stage 12 boss: Liturgical Battlegroup "Final Chorus" — multi-ship formation encounter.
Lore: The Coalition's term for Telos space where the Veiled operate. Hidden behind enemy lines. Heresy in secret. Also an astronomical reference — the Veil Nebula in Cygnus is real, beautiful, and far away. The sector where the Veiled go from rumor to ally. The fabric falls away.
Difficulty range: 19 → 30 Stages: 13–18 Recommended Pilot Rank: 14 → 22
Visual theme: Strange beauty. Nebular gases drift across backgrounds. Distant chorale lights — Telos religious shipyards visible as silhouettes. Ornate Telos architecture in the deep distance. Beauty wedded to threat.
Audio theme: Veiled liturgical motifs enter the soundtrack. Distant choral fragments occasionally audible. The music acknowledges complexity — the enemy has culture, has art, has reasons.
Pacing: Bullet patterns become genuinely interesting. Formation choreography rewards observation. New Veiled-designed weapons unlock (V-Series), letting the player feel real growth.
Story beats: Veiled formally ally with humanity. Sira-Vel meets the player in person at Achernar Station. Architect-Veth is introduced. Joint operations: extracting Veiled families, destroying religious processing centers, recovering apostate manuscripts. Stage 18 boss: The Inquisitor Cohort — Telos religious police with anti-apostate weapons.
Lore: The Coalition's term for the gravitational region surrounding the Apparatus, where Tartarus-9's rotation drags spacetime itself. Inside the ergosphere, in real physics, nothing can remain stationary — everything is dragged along with the spin. The sector name is literal: you are now inside the Apparatus's pull. The center is drawing everything.
Difficulty range: 31 → 45 Stages: 19–24 Recommended Pilot Rank: 22 → 32
Visual theme: Physics anomalies appear. Gravitational lensing visible at the edges of the playfield. Time-dilated regions shimmer. Exotic matter clouds drift across stages. The Apparatus visible as a vast structure in the distance, growing larger each stage. Backgrounds shift toward warmer colors — the heat of the singularity bleeds in.
Audio theme: Music takes on cosmological weight. Choir-like layers. Reverberation. Bass tones suggesting gravitational pull.
Pacing: End-game loadouts available (C-Series ships unlock at the start of Sector 4). Environmental hazards become first-class challenges. Player must manage space itself as well as enemies.
Story beats: The player learns the deeper Telos theology — what they think will happen after the Quantum Rise. The Mathematician-Saint Voren transmits during multiple stages, patiently explaining the elegance of his calculations. Stage 24 boss: The Mathematician-Saint Voren himself — fights while explaining, in transmission, that the Crossing is a kindness and humanity will be grateful.
Lore: Final approach to Tartarus-9 and the Apparatus itself. The Coalition's term for the engagement zone where the machine is built. Where reality breaks down. Where the player goes to end the war.
Difficulty range: 46 → 70 Stages: 25–30 Recommended Pilot Rank: 32 → 45
Visual theme: Reality breaks. Tartarus-9 — a supermassive black hole — dominates the background of every stage. Light bends visibly around it. Accretion disc visible. The Apparatus itself is visible as a structure larger than any object humanity has ever conceived: a machine the size of a star, built around a black hole the size of a galactic core. Each stage is closer than the last. The visual style approaches abstraction by stage 30.
Audio theme: Music breaks. Conventional instrumentation gives way to drones, choral fragments, deep gravitational sub-bass. By stage 30, the soundtrack is barely "music" — it is the audio of physics dying.
Pacing: Highest single-stage difficulty in the game. Cosmic strings as hazards. Time-dilated zones as battlefield. Telos elite enemies in unprecedented numbers. The player needs every tool the Coalition built.
Story beats: Each stage brings the Apparatus closer. Halen's transmissions become more frequent — and more direct. He speaks to the player now, not to the universe. He still does not threaten. Stage 30: The Architect-Saint Halen — final boss. The consciousness uploaded into the Apparatus itself. The fight is not anger. The fight is grief. A god who cannot comprehend why his children would prefer to remain children.
| # | Name | Difficulty | Stages | Pilot Rank | Theme |
|---|---|---|---|---|---|
| 1 | The Frontier | 1–8 | 1–6 | 1–8 | Conventional space, military procedural |
| 2 | The Long Reach | 9–18 | 7–12 | 8–14 | Deeper space, formation warfare, first Veiled contact |
| 3 | The Veil | 19–30 | 13–18 | 14–22 | Veiled alliance, Telos religious territory |
| 4 | The Ergosphere | 31–45 | 19–24 | 22–32 | Physics anomalies, C-Series unlocks, gravitational hazards |
| 5 | The Apparatus | 46–70 | 25–30 | 32–45 | Final approach, reality breakdown, the Architect |
Difficulty range: 50 → ∞ (no cap) Unlock: After completing Sector 5 (Stage 30) Recommended Pilot Rank: No minimum, but realistically only meaningful for Rank 30+
| Depth (waves cleared) | Event |
|---|---|
| 1–10 | Wave generation begins with mixed Sector 1–3 enemy pools |
| 10–25 | Sector 4 enemy types introduced |
| 25–50 | Sector 5 enemy types introduced; bullet patterns intensify |
| 50–100 | Boltzmann constructs begin appearing — short-lived, drop rare loot |
| 100–200 | Cosmic strings introduced as random hazards |
| 200+ | Reality begins to genuinely break — visual distortion increases; Telos ace-tier enemies appear regularly; physics softens at the edges |
| 500+ | Aces appear in formations; ergosphere effects active; near-impossible territory |
| 1000+ | Leaderboard prestige territory; only a handful of players will reach this |
Endless rewards must not cannibalize campaign progression:
This makes endless a prestige mode, not a progression shortcut. Players play it because they've finished the campaign and want to push skill. Rewards are cosmetic and mastery-flavored, not power-flavored.
A player who attempts Stage 18 at Pilot Rank 14 (minimum) will face:
This is the Dark Souls principle: difficulty is a teacher, not a punishment. Every stage is beatable at minimum rank. The minimum rank is set such that a skilled player can clear; an average player will want to over-level by 2–3 ranks for comfort.
A player returning to Stage 4 at Pilot Rank 20 will face:
We do not punish grinding. We prevent infinite XP farming on trivial content.
(Cross-referenced from 01_core_loop.md)
This is the retention safeguard — failure is friction, not punishment.
Every boss is a skill check that gates sector progression. Boss fights are intentionally harder than the stages preceding them. A player should expect to attempt a boss multiple times before clearing it.
| Boss | Sector | Target win-rate (first attempt, recommended rank) | Target win-rate (third attempt, recommended rank) |
|---|---|---|---|
| Reverent Maelin | 1 | 35% | 75% |
| Final Chorus | 2 | 25% | 65% |
| Inquisitor Cohort | 3 | 20% | 55% |
| Mathematician-Saint Voren | 4 | 15% | 45% |
| Architect-Saint Halen | 5 | 8% | 25% |
These targets reflect the philosophy: bosses get harder. The final boss should be a memorable, multi-session challenge. Halen should be celebrated when beaten.
(Detailed boss mechanics specified in Tier 2 — 08_bosses.md.)
Beyond ad-revive and persistent rewards, the following ease frustration without compromising challenge:
Cumulative damage in attempts — if the player has reduced a boss to 25% HP across multiple attempts, on subsequent attempts the boss starts at "Phase 3" rather than full HP. This is not persistent damage; it's an attempt-flow accommodation that says "we know you've been here a while." (Optional design — consider for v1.1 based on data.)
Visible progress — every failed attempt shows what the player improved (longer survival, more enemies killed, closer to boss). Failure is feedback.
Sira-Vel encouragement — after 3 consecutive failed attempts, Sira-Vel transmissions take a different tone. Not condescending. Acknowledging difficulty. Reminding the player they are not alone.
Strategic codex hints — after 5 failed attempts on a boss, a codex entry unlocks with tactical advice for that boss. The lore-rich, gameplay-useful kind. The player can choose to read it or not.
All of the following live in .json (or similar config) for post-launch tuning without app store updates:
Note: Tao Baryon v1.0 ships client-side only (see 00_amendments.md Amendment 7). Balance changes require app store updates. These config-driven values reduce hardcoding and ease iteration during development and between releases, but cannot be hot-patched at runtime.
Locked design decisions:
Document version: 1.0 (locked) Part of: Tao Baryon GDD — Tier 1 Foundation