About This Page
The full gameplay balance dossier — every combat number in the
game in one place, mirroring BALANCE.md — so a
design question like "is Blaster stronger than Laser" has one
authoritative, up-to-date answer instead of scattered code comments.
For TWIN STRIKE's development history, see the
Changelog.
All balance damage-per-second figures below assume sustained fire with every shot connecting — no dodging, no downtime between volleys — a design tool for comparing weapons and enemies, not a guarantee of real in-run numbers.
Balance & Stats Reference
Every combat number in the game, in one place: the player ship and
its four weapon types, pickups and the smart bomb, the four
energy-weapon charge tiers, all fifteen regular enemy tiers, the Boss
and Big Boss escalation curves, and the run-length pacing model that
ties it all together. Generated straight from the project's own
source (scripts/) and BALANCE.md — every
figure below should match what actually ships.
Player Ship
Source: scripts/player.gd
A single interceptor with two independent emitters (left/right half), both always firing the same equipped weapon simultaneously. During every boss fight the ship splits into two independently-steered halves; outside boss fights it flies as one body.
| Property | Value | Notes |
|---|---|---|
| Max health | 1000.0 | Full pool; a HEALTH pickup restores 50% of it (see Pickups below). |
| Ram/push-out radius | 0.30 | player_collision_radius — used for the continuous push-out against bosses, deliberately smaller than the hull's actual visual width. |
| Pickup collection radius | 1.20 | PICKUP_HIT_RADIUS — either half-disc counts while split. |
Player Weapons
Source: scripts/player.gd, scripts/weapon_base.gd, scenes/weapons/*.tscn
- Both emitters always fire the same weapon at once — total ship DPS is 2x a single emitter's DPS.
- Blaster, Laser and Spread share one global damage level (from
DAMAGE_UPpickups):DAMAGE_LEVEL_BONUS_PERCENT = 0.15per level. Torpedoes (0.20/level) and the four energy-weapon tiers (0.10/level) each scale at their own, different rate. - Emitter geometry comes from the player models' attach points, in Player-local units (x0.25 in the world): the two halves sit ±3.35 from the ship's center; each turret pivots at its half's center, and aim is measured from that pivot; every shot (normal fire, bullet fan, plasma beam) spawns at the turret's muzzle, 2.4 ahead of the pivot along the aim; torpedoes launch from the pod faces, 2.985 out from each half's center.
- Level 1 = base weapon, no pickups; Level 10 = 9
DAMAGE_UPpickups collected. - Torpedoes are manually triggered — 2 tubes, independent 20s cooldowns each, so max sustained rate is one launch per 10s if fired the instant each tube is ready. Each fired torpedo also homes for up to 30s before despawning if it never connects (up from 8s, then 20s until 2026-10-09) — the same max life as the two homing-missile types below.
- Every torpedo launches straight ahead and flies straight for
TORPEDO_STRAIGHT_TIME = 0.25s(~3.4 units atTORPEDO_SPEED = 13.5, 9 until 2026-10-09) before it starts turning toward its target atTORPEDO_TURN_RATE = 5.25rad/s (raised from 3.5 with the speed, so the turning circle stays ~2.6 units). The target is the enemy closest to escaping — the lowest on-screen regular enemy; bosses and boss minis don't count — or, with none on screen, the strongest on-screen enemy. Locked at launch and re-picked by the same rule if that one dies first (until 2026-10-09: the strongest enemy, re-picked as the one nearest the torpedo). - Rapid Fire raises fire rate 1.5x (was 2x until 2026-10-07; not tied to weapon level) for Blaster/Laser/Spread only — torpedoes are cooldown-gated and unaffected.
Base stats (per emitter, level 1)
Fire rates went up 1.5x on 2026-10-07, from 4.0 / 12.0 / 2.5 per second. Damage went down to 0.8x on 2026-10-17, from 20 / 5 / 10 per shot (Spread per pellet).
| Weapon | Dmg/shot | Fire rate | Projectiles |
|---|---|---|---|
| Blaster | 16.0 | 6.0/sec | 1 |
| Laser | 4.0 | 18.0/sec | 1 |
| Spread | 8.0 | 3.75/sec | 3 |
| Torpedo | 420.0 | 1 per 20s | 1 |
Ship DPS by level (both emitters, normal fire vs. Rapid Fire)
| Level | Blaster DPS | +RF | Laser DPS | +RF | Spread DPS | +RF |
|---|---|---|---|---|---|---|
| 1 | 192.0 | 288.0 | 144.0 | 216.0 | 180.0 | 270.0 |
| 2 | 220.8 | 331.2 | 165.6 | 248.4 | 207.0 | 310.5 |
| 3 | 249.6 | 374.4 | 187.2 | 280.8 | 234.0 | 351.0 |
| 4 | 278.4 | 417.6 | 208.8 | 313.2 | 261.0 | 391.5 |
| 5 | 307.2 | 460.8 | 230.4 | 345.6 | 288.0 | 432.0 |
| 6 | 336.0 | 504.0 | 252.0 | 378.0 | 315.0 | 472.5 |
| 7 | 364.8 | 547.2 | 273.6 | 410.4 | 342.0 | 513.0 |
| 8 | 393.6 | 590.4 | 295.2 | 442.8 | 369.0 | 553.5 |
| 9 | 422.4 | 633.6 | 316.8 | 475.2 | 396.0 | 594.0 |
| 10 | 451.2 | 676.8 | 338.4 | 507.6 | 423.0 | 634.5 |
Torpedoes (own 0.20/level scaling, max 1 launch/10s)
| Level | Damage | DPS |
|---|---|---|
| 1 | 420.00 | 42.0 |
| 2 | 504.00 | 50.4 |
| 3 | 588.00 | 58.8 |
| 4 | 672.00 | 67.2 |
| 5 | 756.00 | 75.6 |
| 6 | 840.00 | 84.0 |
| 7 | 924.00 | 92.4 |
| 8 | 1008.00 | 100.8 |
| 9 | 1092.00 | 109.2 |
| 10 | 1176.00 | 117.6 |
Weapon Pickups
Source: scripts/weapon_pickup.gd, scripts/main_game.gd, scripts/player.gd
Enemies drop one pickup on death, its type chosen uniformly at random from 4 kinds. The player collects it by flying within 1.2 units (either half-disc while split).
A dropped pickup drifts toward the player at 3.6 units/s (raised from 2.0 to 2.4 in 0.3.17, then to 3.6 on 2026-10-07), re-aiming every second, and pauses for 0.2s each time a player bullet hits it.
| Type | Letter | Color | Effect |
|---|---|---|---|
| HEALTH | H | red | Heals 50% of max health on Gunner, 65% on Cadet and 40% on Ace (see Difficulty below), instant, one-off. |
| SHIELD | S | blue | Full damage immunity for 15s — stacks by extending remaining time, not resetting it. Blocks bullet damage and boss body-slam collisions entirely. While active, a force field (radius 1.0 world units) around each disc removes any enemy bullet that reaches it (boss bullets included) and explodes any regular enemy that touches it, scored as a normal kill; bosses aren't destroyed by it. For the last 3s the fields pulse red once per second as a purely visual warning. |
| RAPID_FIRE | R | yellow | 1.5x fire rate on Blaster/Laser/Spread for 15s (stacks). Torpedoes and the smart bomb are unaffected. |
| DAMAGE_UP | W | green | +15% damage, permanent, all weapons — feeds the global damage-level tables above. |
Mutating a pickup into the smart bomb
Shooting an uncollected pickup doesn't destroy it — every 3 hits it
cycles to the next type (H → S → R → W → H…). After 12
such 3-hit cycles (36 total bullet hits), instead of mutating again
the pickup turns into the smart bomb.
Smart Bomb
Source: scripts/weapon_pickup.gd, scripts/smart_bomb_shockwave.gd
Once triggered, the pickup flashes white/red, flies to the center of the screen, and detonates after a 0.5s fuse. On detonation:
- Screen clear — every enemy projectile on screen is destroyed instantly.
- Fire suppression — any Boss/Big Boss on screen has its fire suppressed for 2.0s.
- Missile burst — 12 homing missiles fire radially (30° apart), each dealing 200.0 base damage scaled by the player's current damage level at 10%/level (same rate as Energy Weapons below) — 200/missile at level 1, up to 380/missile at level 10. Speed 13.75, turn rate 4.0, 30s lifetime; each missile despawns on its first hit.
- Shockwave ring — purely cosmetic, no damage of its own.
Energy Weapons (Charge Tiers)
Source: scripts/player.gd, scripts/yonshakudama.gd
Holding suppress-fire builds a charge meter at 10%/sec (0→100% in 10s). Releasing fires whichever of 4 tier thresholds the charge had reached — highest tier wins, not cumulative — and always starts a fixed decay back to 0 over 30s, during which the meter can't rebuild. All four tiers scale with the player's damage level at their own 10%/level rate (distinct from the 15%/20% rates above).
| Tier | Charge | Weapon | Payload (base, level 1) |
|---|---|---|---|
| 1 | 25% | Bullet Fan | 25 bullets total, split across both crosshairs, 30° total spread (±15° per side), 32 dmg/bullet, speed 16 → 800 dmg if every bullet connects. |
| 2 | 50% | Plasma Beams | 2 instant hitscan beams (one per crosshair), 999 dmg each, 25-unit range, 0.7 wide — resolved instantly, not a travelling projectile → 1,998 dmg. |
| 3 | 75% | Homing Missiles | 2 missiles, 0.5s apart, 100 dmg each, speed 13.75, 30s lifetime, up to 10 re-targets each (survives past its first kill, unlike the smart bomb's) → 200 dmg. |
| 4 | 100% | Yonshakudama | Fireball flies 2.5s to ~25% down from the top, then bursts into 6 pods that fly out 2.5 in a ring for 0.6s and burst together, each into 60 spikes in a golden-angle spiral (360 in all), 10 dmg each, speed 20 → 3,600 dmg. Deploying it fades every other sound out until 1.5s after the pods burst. |
Enemies — Regular
Source: scripts/enemy.gd, scripts/wave_progression.gd (ENEMY_TIERS, LEVEL_TIER_WEIGHTS), scripts/main_game.gd (_roll_squad_tier())
Fifteen regular-enemy tiers: the original nine (Oko to Prozhektor)
and the second fleet's six (Vorobey to Sprut, 2026-10-07). They unlock
progressively across the 12-wave campaign, one or two new tiers per
level through level 11 (see
docs/enemy-tier-level-distribution.md for the rationale):
the second fleet's debut on levels 4 (Vorobey), 6 (Buran), 8 (Voron),
9 (Kosa), 10 (Kikimora) and 11 (Sprut). A level offers at most five
tiers through level 5 and six from level 6 on, in a sliding window
that retires the easiest as harder ones arrive; no tier is over 30%
from level 3 on, destructible-bullet tiers are at most 30% combined,
and the tanks (Desant, Nakovalnya) only roll on Big Boss waves, at
most 25% combined (the kamikaze escort below is added on top of the
roll, on any wave). The type is rolled once per
squad, not per enemy.
Spawn distribution by wave — % of squads
Each squad's tier is rolled from its wave's weights (LEVEL_TIER_WEIGHTS); every column sums to 100. Highlighted cells are a tier's debut wave, ◆ marks a Big Boss wave (the only waves the tanks, Desant and Nakovalnya, roll on) and * a destructible-bullet tier. The kamikaze escort's Desant squads come on top of these rolls and aren't counted here.
| Enemy | W1 | W2 | W3◆ | W4 | W5 | W6◆ | W7 | W8 | W9◆ | W10 | W11◆ | W12◆ |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 01 Oko* | 25 | 10 | 10 | — | — | — | — | — | — | — | — | — |
| 02 Kopyo | 40 | 35 | 25 | 15 | — | — | — | — | — | — | — | — |
| 03 Strela | 35 | 25 | 20 | 15 | 10 | — | — | — | — | — | — | — |
| 04 Desant | — | — | 20 | — | — | 15 | — | — | 13 | — | 15 | 10 |
| 05 Yozh | — | 30 | 25 | 20 | 20 | 15 | 15 | 10 | — | 10 | — | — |
| 06 Bliznets | — | — | — | 25 | 20 | — | 15 | 10 | — | — | — | — |
| 07 Krab | — | — | — | — | 30 | 20 | 15 | 15 | 15 | — | — | — |
| 08 Nakovalnya* | — | — | — | — | — | 10 | — | — | 12 | — | 5 | 10 |
| 09 Prozhektor | — | — | — | — | — | — | 25 | 25 | 20 | 20 | 20 | 20 |
| 10 Vorobey* | — | — | — | 25 | 20 | 15 | 10 | — | — | — | — | — |
| 11 Buran | — | — | — | — | — | 25 | 20 | 20 | — | 15 | — | — |
| 12 Voron | — | — | — | — | — | — | — | 20 | 15 | 15 | — | — |
| 13 Kosa | — | — | — | — | — | — | — | — | 25 | 15 | 15 | 15 |
| 14 Kikimora | — | — | — | — | — | — | — | — | — | 25 | 20 | 25 |
| 15 Sprut* | — | — | — | — | — | — | — | — | — | — | 25 | 20 |
| Tiers offered | 3 | 4 | 5 | 5 | 5 | 6 | 6 | 6 | 6 | 6 | 6 | 6 |
| Destructible % | 25 | 10 | 10 | 25 | 20 | 25 | 10 | 0 | 12 | 0 | 30 | 30 |
| Tank % | 0 | 0 | 20 | 0 | 0 | 25 | 0 | 0 | 25 | 0 | 20 | 20 |
Oko, Kopyo and Strela retire after waves 3, 4 and 5; Yozh lingers as
10–15% filler through wave 10 and Bliznets through wave 8. Every
wave from 4 to 11 brings a new tier. By wave 12 Kosa, Kikimora and
Sprut make up 60% of the squads. Full rationale:
docs/enemy-tier-level-distribution.md.
Base stats (wave 1, health_multiplier = 1.0)
| Enemy | Score | Diff | Move | Shoot | HP | Interval(s) | Avg DPS | Coll. x/y | Visual ht. | Destructible |
|---|---|---|---|---|---|---|---|---|---|---|
| Oko* | 100 | 2 | ARC | AIMED | 4 | 0.50–0.75 | 16.0 | 0.55/0.60 | 1.22 | yes (1.5x) |
| Kopyo | 150 | 3 | SINE | SINGLE | 8 | 0.50–0.75 | 16.0 | 0.37/0.73 | 1.30 | no |
| Strela | 150 | 3 | WEAVE | ALTERNATING | 7 | 0.75–1.25 | 10.0 | 0.35/0.60 | 0.95 | no |
| Desant | 300 | 6 | STRAIGHT | SPREAD | 40 | 1.25–1.75 | 16.0 | 0.58/0.99 | 1.70 | no |
| Yozh | 150 | 3 | KAMIKAZE | NONE | 12 | n/a | 0.0 | 0.59/0.60 | 1.22 | no |
| Bliznets | 200 | 4 | SINE | ALTERNATING | 10 | 0.70–1.00 | 11.76 | 0.48/0.64 | 1.05 | no |
| Krab | 300 | 6 | STRAIGHT | SPREAD | 14 | 1.00–1.40 | 20.0 | 0.42/0.59 | 0.95 | no |
| Nakovalnya* | 300 | 6 | STRAIGHT | AIMED | 34 | 1.30–1.75 | 6.56 | 0.66/0.83 | 1.38 | yes (2.0x) |
| Prozhektor | 350 | 7 | SPIRAL | SWEEP | 24 | 0.60–0.90 | 12.0 | 0.77/0.78 | 1.50 | no |
| Vorobey* | 200 | 4 | FLUTTER | MISSILE | 7 | 1.40–1.90 | 6.06 | 0.42/0.50 | 1.10 | yes (1.5x) |
| Buran | 250 | 5 | SURGE | TWIN_BURST | 11 | 1.50–2.00 | 17.1 | 0.44/0.63 | 1.40 | no |
| Voron | 300 | 6 | GLIDE | RING | 13 | 1.80–2.40 | 22.9 | 0.51/0.45 | 1.10 | no |
| Kosa | 350 | 7 | HOVER | CARPET | 30 | 1.20–1.60 | 22.9 | 0.51/0.94 | 1.75 | no |
| Kikimora | 400 | 8 | ORBIT | CROSS | 14 | 1.00–1.40 | 23.3 | 0.45/0.45 | 1.10 | no |
| Sprut* | 400 | 8 | TRACK | TORPEDO | 28 | 1.60–2.10 | 10.8 | 0.43/0.98 | 1.85 | yes (2.2x) |
* fires destructible bullets — see
below; its listed DPS is a nominal ceiling only reached if none of
its shots are intercepted. "Coll. x/y" is the elliptical hitbox used
for all player-bullet/ram checks; "Visual ht." is the rendered hull's
own world-space height, read from each delivered model. The hitboxes
were refit to the new models' widths in 0.4.0, then tuned by hand per
ship. On 2026-10-06 the second fleet's Javelin and Griffin took tiers 2
and 4 over as Kopyo and Desant: each kept its tier's hitbox, moved by
the change in hull size; Kopyo's HP
went 6 → 8 (2026-10-07) for its 77% bigger footprint. The second
fleet's six took HP from their footprint and role, and their hitboxes
started as a first pass off the model bounds. Krab's was narrowed by hand on 2026-10-14
(0.74/0.60 → 0.50/0.59). On 2026-10-22 every tier but Yozh,
Prozhektor and Kikimora was tuned by hand again, mostly narrower
(Desant 1.04 → 0.58, Strela and Kopyo 0.60 → 0.35/0.37); Kosa
and Sprut also got longer. "Difficulty" is a qualitative 1–10 rating (HP, Avg DPS,
speed, move/shoot-pattern predictability, discounted for destructible
tiers) that Score is derived from: Score = Difficulty / 2 × 100
(2026-10-07), so 100–400. It was 50 × difficulty rank before,
which spread the fifteen tiers over 50–750; tiers on the same
difficulty now score the same.
See BALANCE.md's "Difficulty rating & score
derivation" for the full derivation and the rule for re-deriving
Score if a difficulty rating ever changes.
The second fleet's patterns (2026-10-07)
Each of tiers 10–15 pairs a new movement pattern with a new shot pattern. The movement patterns run on a clock shared by the whole squad, so a formation keeps its shape while its speed varies.
| Enemy | Move | Shoot | Volley |
|---|---|---|---|
| Vorobey | FLUTTER: hop and hang | MISSILE: one from alternating flank pods, homing at 1.6 rad/s for its first 1.5 s, then straight; lives 4 s. Destructible | 1 × 10 |
| Buran | SURGE: afterburner pulses | TWIN_BURST: three pairs of parallel aimed shots 0.12 s apart, from the engine pods. Speed 8.5 | 6 × 5 |
| Voron | GLIDE: pendulum kite | RING: eight bullets round a full circle, turned 22.5° each volley. Speed 4.0 | 8 × 6 |
| Kosa | HOVER: parks in the upper half, then leaves fast | CARPET: four bombs straight down in a line, a wall to step around. Speed 5.0 | 4 × 8 |
| Kikimora | ORBIT: loops round a descending centre, hull spinning at 1.0 rad/s | CROSS: four bullets along the spinning hull's X arms, a turning four-way spiral. Speed 6.0 | 4 × 7 |
| Sprut | TRACK: slides toward the player inside its lane | TORPEDO: one big shot straight down, launched at 2.0 and accelerating at 9.0/s up to 12.0. Destructible | 1 × 20 |
CARPET, RING and CROSS list their whole volley, but only a bullet or two of it can reach the player at once, so their Avg DPS is a looser ceiling than the single-shot tiers'.
Kamikaze tier (Yozh)
Yozh (2026-09-10, experimental, still being playtested/tuned) is
the only tier with no ranged attack at all — shoot_min/
shoot_max are both 0.0, so it never fires a
shot of any pattern. Its threat is pure movement instead:
MovePattern.KAMIKAZE homes on the player's live position
(both axes, not a fixed lane) until it descends to y = −1,
a little under mid-screen (was y = 0 until 2026-10-16), then locks
its lane and dives straight down, surging to double its speed, so a player who
moves clear of that lane escapes it. It costs no health, but one that flies off the bottom breaks the kill streak like any other escape.
Its speed climbs every frame, uncapped. While homing, the
x-component of its direction toward the player is multiplied by 3.0
(2026-09-23), so it closes the horizontal gap fast enough for the
dive to actually land instead of sailing past. Its spawn weights were
raised on levels 2–8 and 10 with the lane-lock rework. Current tuning: speed
1.0–1.2 at spawn, accelerating at 1.8/s², each doubled in
play by APPROACH_SPEED_SCALE (see below) — treat
these as first-pass numbers likely to move again. Its only damage source is the same ram/collision mechanic
every regular enemy already has — it just becomes the tier's
entire threat instead of a secondary one layered under gunfire.
Kamikaze escort
Kamikaze escort (2026-10-16, being playtested). Since a kamikaze fires
nothing, a run of kamikaze squads let the player aim both cannons
straight up and stand still. Every squad's tier is now rolled when the
wave starts (MainGame._deal_squad_tiers()), so a run of
two or more kamikaze squads in a row is known in
advance. That run gets an escort squad in front of it, added to the
wave (it counts toward the wave's enemies and the boss trigger):
- Tier: Desant (
WaveProgression.KAMIKAZE_ESCORT_TIER_NUMBER, the SPREAD tank; was Nakovalnya until 2026-10-17), on any wave, outsideLEVEL_TIER_WEIGHTSand its Big-Boss-wave-only rule for tanks. HP and speed are scaled per wave as usual. - Shape: a straight line of eight on lanes ±1 to ±4
(
WaveFormations.kamikaze_escort_squad()), off the center lane (six on lanes ±2 to ±4 until 2026-10-17). - Movement:
Enemy.MovePattern.HOLD. It cruises toy = 7.2(_HOLD_Y), brakes to a stop over 0.6 s and waits there, swaying. It stays until no kamikaze squad is deploying or next in line and every kamikaze it waits on is dead or gone. Then it eases to 1.5× speed and leaves (an escape still breaks the kill streak). - Timing: the run's first kamikaze squad follows one inter-squad gap behind the escort, and the escort's own spawn budget is held until after that squad.
- A later kamikaze squad that arrives while the escort still holds is waited on too. A lone kamikaze squad comes in unescorted.
Kamikaze side entry
Kamikaze side entry (2026-10-16, being playtested). Every kamikaze
squad, escorted or not, drops the formation it was dealt
(MainGame._deal_tier()) for
WaveFormations.kamikaze_flank_squad(): twelve ships in six
pairs (ten in five until 2026-10-17). Each pair spawns at once, one at x = ±16
(FLANK_ENTRY_X, just off a 16:9 screen's sides) and both at
y = 5.7 (FLANK_ENTRY_Y), just under the
escort's y = 7.2 hold (the hulls clear by ~0.04 since the
escort became the taller Desant). The pairs come one row delay apart
(MainGame._row_delay()), and from there they home on the
player as usual.
Destructible bullets (Oko, Nakovalnya, Vorobey, Sprut)
Enemy fire is normally un-interceptable — strafing, not shooting, is the counter to it. Four tiers are the exception: their shot can be shot out of the air, and the interception pierces through (clearing every destructible bullet it overlaps, still landing on the shooter behind it, at no cost to the player's shot). Yozh used to be the third destructible tier here but fires nothing at all as of 2026-09-10 — see Kamikaze tier above. Vorobey's missile homes for its first 1.5 s, so shooting it down is the clean answer to it; Sprut's torpedo launches slow and accelerates, so it is easiest to clear right after launch.
| Property | Non-destructible tiers | Oko / Nakovalnya / Vorobey / Sprut |
|---|---|---|
| Shootable | no | yes — and the shot pierces |
| Bullet radius | 0.1125 | 0.16875 (Oko, Vorobey) / 0.225 (Nakovalnya) / 0.2475 (Sprut) |
| Size scale | 1.0x | 1.5x (Oko, Vorobey) / 2.0x (Nakovalnya) / 2.2x (Sprut) |
| Color cycle | fixed, matches body | Oko yellow→red, Nakovalnya icy blue→orange, Vorobey mint→pink, Sprut sea-green→yellow, 0.5s |
| Score per kill | n/a | 5 per bullet shot down |
Per-shot damage and volley size are not wave-scaled for any tier — only HP and move speed grow with wave, so later waves are harder purely because enemies soak more hits and close distance faster, not because their guns get stronger (Yozh is the exception — it has no guns at all; its danger instead grows with its own acceleration over the course of its approach, independent of wave).
HP by wave — health_multiplier(wave) = 1 + (wave − 1) × 0.16
| Enemy | W1 | W2 | W3 | W4 | W5 | W6 | W7 | W8 | W9 | W10 | W11 | W12 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 01 | 4.0 | 4.6 | 5.3 | 5.9 | 6.6 | 7.2 | 7.8 | 8.5 | 9.1 | 9.8 | 10.4 | 11.0 |
| 02 | 8.0 | 9.3 | 10.6 | 11.8 | 13.1 | 14.4 | 15.7 | 17.0 | 18.2 | 19.5 | 20.8 | 22.1 |
| 03 | 7.0 | 8.1 | 9.2 | 10.4 | 11.5 | 12.6 | 13.7 | 14.8 | 16.0 | 17.1 | 18.2 | 19.3 |
| 04 | 40.0 | 46.4 | 52.8 | 59.2 | 65.6 | 72.0 | 78.4 | 84.8 | 91.2 | 97.6 | 104.0 | 110.4 |
| 05 | 12.0 | 13.9 | 15.8 | 17.8 | 19.7 | 21.6 | 23.5 | 25.4 | 27.4 | 29.3 | 31.2 | 33.1 |
| 06 | 10.0 | 11.6 | 13.2 | 14.8 | 16.4 | 18.0 | 19.6 | 21.2 | 22.8 | 24.4 | 26.0 | 27.6 |
| 07 | 14.0 | 16.2 | 18.5 | 20.7 | 23.0 | 25.2 | 27.4 | 29.7 | 31.9 | 34.2 | 36.4 | 38.6 |
| 08 | 34.0 | 39.4 | 44.9 | 50.3 | 55.8 | 61.2 | 66.6 | 72.1 | 77.5 | 83.0 | 88.4 | 93.8 |
| 09 | 24.0 | 27.8 | 31.7 | 35.5 | 39.4 | 43.2 | 47.0 | 50.9 | 54.7 | 58.6 | 62.4 | 66.2 |
| 10 | 7.0 | 8.1 | 9.2 | 10.4 | 11.5 | 12.6 | 13.7 | 14.8 | 16.0 | 17.1 | 18.2 | 19.3 |
| 11 | 11.0 | 12.8 | 14.5 | 16.3 | 18.0 | 19.8 | 21.6 | 23.3 | 25.1 | 26.8 | 28.6 | 30.4 |
| 12 | 13.0 | 15.1 | 17.2 | 19.2 | 21.3 | 23.4 | 25.5 | 27.6 | 29.6 | 31.7 | 33.8 | 35.9 |
| 13 | 30.0 | 34.8 | 39.6 | 44.4 | 49.2 | 54.0 | 58.8 | 63.6 | 68.4 | 73.2 | 78.0 | 82.8 |
| 14 | 14.0 | 16.2 | 18.5 | 20.7 | 23.0 | 25.2 | 27.4 | 29.7 | 31.9 | 34.2 | 36.4 | 38.6 |
| 15 | 28.0 | 32.5 | 37.0 | 41.4 | 45.9 | 50.4 | 54.9 | 59.4 | 63.8 | 68.3 | 72.8 | 77.3 |
Average DPS across the original 9 tiers, unaffected by wave, ≈ 12.0
(≈ 13.5 across the 8 that shoot; Yozh fires nothing). Tiers 10–15
average ≈ 17.2 nominal, but most of that is CARPET/RING/CROSS volleys
only partly able to land. Move
speed scales separately: speed_multiplier(wave) = 1 + (wave − 1) ×
0.12 — 1.0x at wave 1 up to 2.32x at wave 12 — and then by
APPROACH_SPEED_SCALE = 2.0 (2026-10-07), so every squad
descends at twice its tier's speed range × speed_multiplier. The same
scale doubles Yozh's acceleration and the mini kamikazes' attack speed
and acceleration. Sideways sways run on time, not move speed, so they
keep their pace.
Boss
Source: scripts/boss.gd
Spawns at the end of every wave that isn't a Big Boss wave (1, 2, 4, 5, 7, 8, 10). Attacks escalate through 3 phases keyed off remaining HP (phase 2 at ≤60%, phase 3 at ≤30%). A separate player-tracking burst attack runs independently from phase 1.
| Phase | HP left | Main fire (dmg/volley) | Interval | Burst (indep.) | Total DPS* |
|---|---|---|---|---|---|
| 1 | >60% | Spread(7×8=56) + Ring(14×8=112) = 168 | 1.35s | 4×11=44/2.20s | 144.4 |
| 2 | 30–60% | + alt. Aimed(5×10=50)/Cross(10×9=90) | 1.0125s | 4×11=44/1.65s | 261.7 |
| 3 | ≤30% | (same volleys, faster) | 0.7425s | 4×11=44/1.21s | 356.9 |
* Theoretical max, every bullet connecting; phase 2/3 uses the Aimed/Cross average since they alternate each shot.
Telegraph (2026-10-09)
For the last 0.5 s before any volley or burst (BossAttackRunner.TELEGRAPH_LEAD), the weapon about to fire, or the core before a ring/star/spiral, charges up in the shots' colour. Visual only: no shot fires later or sooner, on Bosses and Big Bosses alike.
Firepower pass (2026-10-16)
Every attack set (the three below and both classic ones) fires about 30% more theoretical-max DPS than before, from more bullets per pattern, shorter volley intervals and longer or more frequent bursts. Bullet speeds and per-bullet damage are unchanged. Pending playtest.
Opening pass (2026-10-21)
Phase 1 was the passive stretch of every fight (Iskra's opened at 36 DPS). Now, on every Boss, Big Boss and the Final Boss:
- Each phase-1 volley fires two of the kit's steps at once (
BossAttackKit.phase_one_volleys), so weapons that took turns fire together: Iskra both turrets, Rodina both hangars, Medved a carpet with a fan, Grom both pods, and so on. Phases 2 and 3 step one at a time, as before. - The player-tracking burst runs from phase 1 on every boss: Iskra (4x10 every 2.2 s, 8 u/s, from the gun facing the half) and Sputnik (5x11 every 2.0 s, 8.5 u/s) gained one; Medved's and Kosmograd's no longer wait for phase 3 / phase 2.
- Each kit's phase-1 interval multiplier (scaling both volley and burst) is set so phase 1's max DPS lands at ~90% of its phase 2, keeping each fight escalating. Below 1 fires more often than before, above 1 less often but with two weapons a volley.
| Boss | Phase-1 mult | Max DPS phase 1 (was) | Phase 2 | Phase 3 |
|---|---|---|---|---|
| Iskra | x0.89 | 98 (36) | 109 | 187 |
| Rodina | x0.84 | 95 (44) | 105 | 175 |
| Kosmograd | x1.48 | 150 (100) | 167 | 265 |
| Medved | x2.03 | 164 (151) | 180 | 220 |
| Grom | x1.19 | 164 (103) | 179 | 243 |
| Soyuz | x0.89 | 237 (116) | 262 | 362 |
| Katyusha | x0.88 | 138 (66) | 152 | 186 |
| Avrora | x1.07 | 195 (111) | 216 | 306 |
| Sokol | x0.91 | 175 (90) | 196 | 270 |
| Bronenosets | x0.87 | 216 (102) | 238 | 411 |
| Sputnik | x1.33 | 181 (109) | 199 | 311 |
| Meduza | x0.73 | 459 (183) | 511 | 547 |
Measured by tests/manual/test_boss_dps_probe.gd (every shot a kit's fire spawns, bomb shrapnel included, over 60 s). The burst also adds a little to Iskra's, Medved's and Sputnik's phases 2 and 3. The per-kit notes below give each kit's patterns; their Max DPS figures predate this pass, the table above supersedes them.
Earlier phases, harder bursts (2026-10-21)
Phase 2 starts at ≤60% health and phase 3 at ≤30% (were 50% / 25%), with the force field's stage lines (see Boss shield below), and every kit's burst fires one shot more (the figures above include it). Boss HP rose ~5.5% to keep fights their length, so ~47% of a fight is now in phases 2–3 (was ~37%). The burst adds only a few DPS on paper, but it is the fire aimed at the player.
Per-boss attack sets (2026-10-09, all twelve since 2026-10-16)
Every roster entry names its own attack set (scripts/boss_attacks/); the classic kit in the table above is only the fallback for an entry without one, and no fight flies it now. Health, score and phase thresholds are unchanged. The numbers are a first pass, to be tuned by playtest. Theoretical-max DPS (every bullet connecting) runs below the classic kit's, since a kit fires fewer bullets, aimed at one half at a time; the walls and rings count every shot, so they overstate.
A stream (Grom, Soyuz, Sputnik, Meduza) is a volley fired shot by shot from one weapon, its aim sweeping between shots; a ceasefire pauses it where it stands.
- Iskra (wave 1): a volley every 1.1 s (x0.8 phase 2, x0.65 phase 3), burst 4x10 every 2.2 s. Each volley one turret fires a salvo of 4 shots down one line at 7/7.67/8.33/9 u/s, 10 dmg each: the front turret at the left half, the rear at the right, taking turns. From phase 2 every 2nd volley adds a 13-slot ring (10 shots, a 3-shot gap first pointing down, turning 27.7° a ring) at 4.5 u/s, 8 dmg. Phase 3: both turrets every volley. Max DPS 36 / 91 / 168 (classic: 144 / 262 / 357).
- Rodina (wave 2): a volley every 1.5 s (x0.85, x0.7). Each volley one side hull's hangar (alternating) launches 4 shootable orbs in a 36° fan at its half, 2.6 u/s, 12 dmg, 6 s lifetime. From phase 2 the other side's turret adds an 8-shot 50° broadside at its own half, 6 u/s, 8 dmg. Phase 3: both hangars every volley. Burst from the turrets: 4x11 every 2.2 s. Max DPS 47 / 105 / 174.
- Medved (wave 4): a volley every 1.15 s (x0.75, x0.6). Phase 1 cycles carpet, left launcher fan, right launcher fan; from phase 2 left-wing carpet, right fan, right-wing carpet, left fan. A carpet drops a shootable bomb from each wing mount (6, or 3 per wing): 2.4 u/s straight down, 14 dmg, bursting after 1.3 s into an 8-shot ring (3.6 u/s, 7 dmg; alternate bombs turned 22.5°). A launcher fan is 6 shots over 30° at its own half, 6.5 u/s, 9 dmg. Burst from the turrets: 5x12 every 2.0 s. Max DPS 153 / 153 / 231.
- Grom (wave 5): a volley every 1.6 s (x0.8, x0.65). A wingtip pod streams 14 shots 0.08 s apart, sweeping its own half from 30° outboard to 30° inboard of it, the pods taking turns. From phase 2 a pod's stream (20 shots, 0.05 s apart) sweeps from 25° outboard of its own half across to 25° past the far one, the pods taking turns; phase 3 alternates both pods sweeping across at once with the two own-half sweeps. 7 u/s, 10 dmg. Burst from the turrets: 5x11 every 2.0 s. Max DPS 110 / 184 / 252.
- Katyusha (wave 7): a volley every 1.5 s (x0.8, x0.65). A salvo ripple-fires a rack's three tubes twice, 0.12 s apart: 6 shootable homing missiles, launched 15/30/45° outboard of straight down at 4 u/s, steering at 1.5 rad/s for 1.6 s at the rack's half, 14 dmg, 5 s lifetime. Phase 1 alternates one rack's salvo with the other side's nose fan (8 shots over 32°, 7 u/s, 9 dmg, at its own half); phase 2 fires both racks, then both fans; phase 3 adds crossed salvos, each rack's missiles at the far half. Burst from the nose: 4x11 every 2.0 s. Max DPS 68 / 151 / 189.
- Avrora (wave 8): a volley every 1.4 s (x0.8, x0.65). Broadsides down the left, then the right: the side turret's 11 shots over 66° at its half (6 u/s, 9 dmg) and the bow gun's 3 over 6° (8.5 u/s, 11 dmg). From phase 2 each broadside adds a second row, 10 shots laid between the first's at 7.2 u/s. Phase 3 opens each cycle with the full volley: all four turrets fan 9 shots over 36° each, the four fans covering the lower half circle with three 12° ways through, shifted 8° one way and then the other (5.5 u/s, 9 dmg). Burst from the turrets: 5x11 every 2.2 s. Max DPS 114 / 223 / 312.
- Bronenosets (wave 10): a volley every 1.5 s (x0.8, x0.65). An outer gun block fires a wall at its half: 17 slots over 96° with one 3-slot way through (14 shots, 5 u/s, 9 dmg), the way's slot stepping through a per-side list so the halves' ways never line up. Phase 1 takes the sides in turn, phase 2 both every volley, phase 3 alternates double walls (a second row at 6.3 u/s, its way elsewhere) with single ones. Burst from the turrets: 5x12 every 2.0 s. Max DPS 108 / 240 / 425.
Where shots start
Spread, Aimed and Burst leave the modelled weapon facing their direction (turret, prow gun, wingtip pod, missile rack); Ring and Cross still leave the centre. Aimed and Burst are re-aimed from that muzzle, so they still converge on their target. With the player near the bottom (y ≈ −5.5) and prow weapons at y ≈ −1.8 to −2.1, aimed fire starts ~2 units closer and arrives ~35–40% sooner at the same speed. Turrets turn toward the half the burst is on (or hits next) at 180°/s, at most 90° either side of forward. Bullet speeds are unchanged pending playtest.
HP by wave — set per boss (2026-10-15)
| Wave | 1 | 2 | 4 | 5 | 7 | 8 | 10 |
|---|---|---|---|---|---|---|---|
| HP | 6,500 | 8,000 | 10,500 | 13,500 | 17,500 | 20,000 | 24,000 |
Each boss's own entry in scripts/boss_roster.gd, x0.75 on Gunner, x0.5 on Cadet. Was 1800 + 1400 × wave (3,200 to 15,800) until the boss shield below, and 7,000 to 27,000 until the 2026-10-17 player damage cut. Raised ~5.5% on 2026-10-21 with the earlier phase lines (see Boss shield below), rounded as before.
Split ship (2026-10-17)
Source: scripts/ship_split_rig.gd, scripts/player.gd
For every boss fight the ship splits: the dock stays at the centre and each stick steers one disc. Either disc can now fly anywhere inside the arena (it used to be held to its own side of the dock). The parts collide solidly but harmlessly: no damage, no knockback, no input lockout.
- Disc vs disc: the discs can't come closer than their docked spacing, 1.675 world units, where they sit edge to edge when attached. An overlap is split equally; if one disc is pinned against the arena edge or the dock, the other takes the rest.
- Disc vs dock: the dock is a solid box, 0.175 × 0.464 world half-extents (
_DOCK_HALF_EXTENTS). A disc is pushed out to 0.6625 from the box, its rim radius.
Boss shield (2026-10-15)
Source: scripts/boss_force_field.gd, scripts/boss_force_field_aura.gd
The force field around every Boss, Big Boss and the Final Boss now cuts the damage you deal. It has three stages and only goes one way. The stage lines are the attack phases', so the hit that starts phase 2 also starts the field failing, and phase 3 brings it down.
| Stage | Boss health | Damage taken | Look |
|---|---|---|---|
| Up | >60% | 50% | steady pulsing ring |
| Failing | 30–60% | 75% | ring flickers, sparks crackle |
| Down | ≤30% | 100% | powers down over 0.7 s, then gone |
- Every kind of damage is cut: Blaster/Laser/Spread, torpedoes, every energy-weapon tier and the smart bomb.
- A hit takes the cut of the stage the boss is in when it lands, in full, even if it crosses a stage line.
- Effective HP is 1.5x the listed HP: the top 40% costs x2, the next 30% x1.33, the last 30% x1. (1.58x before the lines moved up from 50% / 25% on 2026-10-21; every boss's HP rose ~5.5% with them, so fights keep their length and spend ~47% of it in phases 2–3, up from ~37%.)
- Once down, the field no longer flashes for crossing bullets, and the ram radius shrinks to the hull: the boss's bullet hitbox (the hit radii in the Boss & Big Boss Size Reference below), so you can fly in close. Touching the hull still costs 10% and knocks you back, as the field did.
Time to kill, full kit — weapon level = wave
| Wave | Boss | Kind | HP | Full kit | Up / failing / down | Blaster only |
|---|---|---|---|---|---|---|
| 1 | Iskra | Boss | 6,500 | 30.3 s | 16 / 6 / 8 s | 49.5 s |
| 2 | Rodina | Boss | 8,000 | 34.7 s | 19 / 7 / 8 s | 53.8 s |
| 3 | Kosmograd | Big Boss | 16,000 | 67.9 s | 40 / 18 / 10 s | 95.2 s |
| 4 | Medved | Boss | 10,500 | 38.9 s | 20 / 10 / 9 s | 56.9 s |
| 5 | Grom | Boss | 13,500 | 43.1 s | 23 / 14 / 6 s | 67.0 s |
| 6 | Soyuz | Big Boss | 24,000 | 79.5 s | 45 / 18 / 17 s | 108.4 s |
| 7 | Katyusha | Boss | 17,500 | 48.6 s | 26 / 14 / 9 s | 71.6 s |
| 8 | Avrora | Boss | 20,000 | 52.4 s | 29 / 11 / 12 s | 76.4 s |
| 9 | Sokol | Big Boss | 37,000 | 97.8 s | 59 / 21 / 18 s | 131.2 s |
| 10 | Bronenosets | Boss | 24,000 | 56.7 s | 32 / 12 / 13 s | 80.7 s |
| 11 | Sputnik | Big Boss | 49,000 | 111.9 s | 67 / 27 / 19 s | 151.7 s |
| 12 | Meduza | Final | 132,000 | 300.0 s | 185 / 66 / 49 s | 389.0 s |
Targets: Bosses 30–60 s, Big Bosses 60–120 s, the Final Boss about 300 s, each rising through the run. Ace (x0.75 on Gunner, x0.5 on Cadet). Full kit = Blaster, with the Plasma Beams release (both beams hit) and both torpedo tubes at t=0, then the tubes again every 20 s. Every shot hits; fly-in, dodging, Rapid Fire, smart bombs and Meduza's 75% pickup drop are left out. "Blaster only" is the floor for a player who never uses torpedoes or the energy weapon. Before the shield and the new HP the same full kit killed Iskra in 1.5 s, and no boss before Meduza lasted past 26 s. After the 0.8x Blaster/Laser/Spread damage cut (2026-10-17) every boss's HP was cut to put its full kit back near its old time, rounded to 500 below 20,000 and to 1,000 above. The times and their up / failing / down split are from before the 2026-10-21 phase lines (60% / 30%) and HP raise: the totals still hold to within rounding, but more of each fight now falls in the failing and down stages.
Big Boss
Source: scripts/big_boss.gd
Spawns instead of the regular Boss on waves 3, 6, 9, 11 and 12. Waves 3/6/9/11 are Kosmograd, Soyuz, Sokol and Sputnik; wave 12 is Meduza (Final Boss) — same 3-phase shape as Boss but larger volleys, an extra phase-3 Spiral pattern, and (Final only) one extra burst shot.
| Phase | HP left | Main fire (dmg/volley) | Interval | Burst (non-final) | Total (non-fnl) | Total (Final) |
|---|---|---|---|---|---|---|
| 1 | >60% | Spread(11×12=132)+Ring(18×10=180)=312 | 1.75s | 5×14=70/2.50s | 206.3 | 211.9 |
| 2 | 30–60% | + alt. Aimed(3×15=45)/Cross(10×11=110) | 1.1375s | 5×14=70/1.625s | 385.5 | 394.1 |
| 3 | ≤30% | + Spiral(14×9=126), always | 0.7875s | 5×14=70/1.125s | 716.8 | 729.3 |
Final Boss fires 6 burst shots instead of 5 (6×14=84), same intervals — main fire is otherwise identical.
Where shots start
As for the Boss: Spread leaves the weapon furthest along its facing, Aimed the weapon facing its target; Ring, Cross and Spiral still leave the centre. On Kosmograd, the one ring station left, the eye sits at y = −2.73, so aimed fire starts ~2.7 units closer and arrives about twice as soon at the same speed; up-screen fans leave its rear block, sideways fans its turrets. Bursts leave the turrets (two on Kosmograd, six on Soyuz, three on Sokol, four on Sputnik), which turn toward the burst's half at 180°/s within 90° of forward. The Final Boss has no turrets: its eyes and gun pods sit about half a unit behind its centre, so its aimed fire and bursts start slightly further away. Bullet speeds are unchanged pending playtest.
Per-boss attack sets (2026-10-16)
Every Big Boss and the Final Boss flies its own kit, as the Bosses do (see Boss); the tables above are the classic fallback. The Final Boss's kit sets its own burst.
- Kosmograd (wave 3): a volley every 1.5 s (x0.8, x0.65). The wall: a 36-slot ring from the hub with three 4-slot ways through (24 shots, 4.2 u/s, 10 dmg), the first way pointing straight down, each wall's ways turned 25° / 35° / 45° on (by phase) the way the ring spins. Phase 1 alternates walls with a ring turret's salvo (5 shots down one line at 7–9.4 u/s, 12 dmg) at the half on its side, the turrets taking turns; phase 2 cycles wall, eye fan (7 shots over 24° at a half, 8 u/s, 12 dmg), wall, both salvos; phase 3 cycles a double wall (a second ring at 5.6 u/s, its ways between the first's), both salvos, eye fan. Burst from the eye: 5x13 every 2.6 s. Max DPS 100 / 167 / 265.
- Soyuz (wave 6): a volley every 1.6 s (x0.8, x0.65). Each pod of a pair streams 10 shots 0.08 s apart at the far half, turning 12° outboard, so the pair's streams cross (7.5 u/s, 11 dmg). Phase 1 cycles front pods, a nose lance (6 shots down one line at 9–12.75 u/s, 13 dmg, at alternating halves), rear pods, lance; phase 2 all four pods, then both nose guns' lances, one per half; phase 3 adds all four streams sweeping from the far half to 20° past their own. Burst from the turrets: 6x14 every 2.5 s. Max DPS 121 / 268 / 375.
- Sokol (wave 9): a volley every 0.9 s (x0.8, x0.65), with a 0.3 s telegraph instead of 0.5. Needles: 7 shots over 6° at 13 u/s, 10 dmg, from the gun beside the cockpit on the half's side. A pincer: each of a boom's two tips fires 2 shots (7 and 8.5 u/s, 13 dmg) splayed 35° apart from the line to the half, one inboard and one outboard, steering at 1.9 rad/s for 0.9 s so they close on it. Phase 1 alternates needles (alternating halves) with one side's pincer; phase 2 needles at both halves, then both pincers; phase 3 adds a needle fan (9 over 40° from each gun at its half). Burst from the turrets: 6x14 every 2.5 s. Max DPS 96 / 204 / 285.
- Sputnik (wave 11): a volley every 1.6 s (x0.8, x0.65), burst 5x11 every 2.0 s. The eye beam: a stream of 48 shots 0.022 s apart sweeping from 65° left of straight down to 65° right (then the next beam back), in dashes of 6 with 3 left out, so 33 shots with ways through; 12 / 13 / 13 u/s by phase, 7 dmg. Between beams the front turrets fire salvos (5 shots down one line at 7–9.4 u/s, 12 dmg) at their own halves, and from phase 2 the rear turrets add fans (5 over 20°, 7 u/s, 10 dmg). Phase 3's beam runs there and back in one go (80 shots, 54 fired). Max DPS 110 / 176 / 288.
- Meduza (wave 12): a volley every 1.5 s (x0.8, x0.65). A lash: each tentacle on a side streams 8 shots 0.05 s apart from its tip, swinging 40° across its half and back (neighbours the opposite way), each 0.12 s after the one outboard of it (7 u/s, 11 dmg). Phase 1 cycles left lash, Rodina's orbs (4 shootable orbs over 36° from each gun pod at its half, 2.6 u/s, 14 dmg, 6 s lifetime), right lash, Iskra's salvos (5 shots down one line from each eye at its half, 7–9.4 u/s, 12 dmg); phase 2 cycles Medved's carpet (a shootable bomb from every tip, 2.4 u/s down, 16 dmg, bursting after 1.3 s into an 8-shot ring at 3.6 u/s, 8 dmg), both lashes, Kosmograd's wall (as Kosmograd's, turning 35°), both lashes; phase 3 cycles Sputnik's beam (40 shots 0.025 s apart over ±60° from one eye, 28 fired, 12 u/s, 7 dmg), the carpet, the double wall, both lashes. Burst from the eyes and pods: 7x14 every 2.5 s. Max DPS 190 / 519 / 570.
HP — set per boss (2026-10-15)
| Wave | HP | Encounter |
|---|---|---|
| 3 | 16,000 | Kosmograd |
| 6 | 24,000 | Soyuz |
| 9 | 37,000 | Sokol |
| 11 | 49,000 | Sputnik |
| 12 | 132,000 | Meduza (Final) |
x0.75 on Gunner, x0.5 on Cadet. Was 9,600 + 3,200 × index (12,800 to 22,400) and 96,000 for the Final Boss until the boss shield (see Boss above), and 17,500 to 54,000 and 150,000 until the 2026-10-17 player damage cut, which every Big Boss and the Final Boss carry too, and raised ~5.5% on 2026-10-21 with the earlier phase lines. Score still goes by the Big Boss's place in the run: 1,000 / 1,500 / 2,000 / 2,500, and 10,000 for the Final Boss.
Mini kamikazes
Source: scripts/boss_mini_kamikaze.gd, launched by BigBoss._tick_minis()
Every Big Boss, the Final Boss included, launches Yozhiks, half-size Yozhes (model enemy_yozhik), from its dorsal hatch: the model's launch bay, an iris on every Big Boss (on the Final Boss, its bell above the red band, 2.22 above its centre). The regular Boss does not. First pass, to be tuned after playtesting.
| Property | Value |
|---|---|
| Launch | first group 10s after the boss spawns, then every 10s |
| Health gate | new groups only while boss HP > 20%; a group already leaving the hatch finishes. At or below 20% the iris rests half open (30°) and black smoke pours out (visual only) |
| Iris | six blades open 60° over 0.4s, starting 0.5s before a group; close once the last mini has climbed clear |
| Lock point | crosshairs lock 1.36 (2 crosshair-heights) below a non-final Big Boss's centre, clear of the hatch; Final Boss and regular Boss keep the centre |
| Group | 6 minis (10 from the Final Boss), all released within 1.0s (0.2s apart; 0.11s for 10), outermost pair first; each climbs 0.35s out of the hatch before flying to its slot |
| Line | the whole group reaches y = 6.5, 22 wide and centred (slots 4.4 apart; 2.44 for 10), 2.0s after the group's first release |
| Attack | outer pair at once, each pair further in +0.25s (inner pair +0.50s; +1.0s for 10); the left half of the line homes on the left half, the right on the right |
| Rally | shooting a mini down sends the 2 minis nearest its slot that haven't attacked yet in at once, out of turn: from the line, or straight from their flight to it (ties go left) |
| Final look | the Final Boss's minis rest tinted (1.0, 0.72, 0.72), a little redder, behind a faint red halo (1.3 across, alpha 0.4). Visual only |
| Homing | 6.0 u/s start, +6.0 u/s every second (3.0 × APPROACH_SPEED_SCALE); locks its heading within 3.0 units of its half (or after 4.0s), then surges by its current speed over 0.25s |
| HP | 6 × health_multiplier(wave) × difficulty (half of Yozh) |
| Hitbox | 0.295 × 0.30 |
| Ram damage | 10% of the player's max HP |
| Score | 75 (half of Yozh), with the streak multiplier |
Minis never count toward a wave's alive count, so leftovers can't hold a wave open. One that flies more than 2 units off-screen is removed at no cost. When a non-final Big Boss dies, the minis still flying explode without scoring; the Final Boss's defeat cutscene clears them like every other enemy.
Boss & Big Boss Size Reference
Source: scripts/boss_roster.gd — one hand-tuned entry per wave
Every wave's boss is its own delivered 3D model, shown at full size, with its own hand-tuned hitbox, independent of the shared Boss/BigBoss attack patterns above.
| Wave | Name | Kind | Width × length | Hit radius (x) | Hit radius (y) | Ram radius (x) | Ram radius (y) |
|---|---|---|---|---|---|---|---|
| 1 | Iskra | Boss | 4.30 × 5.15 | 0.88 | 2.93 | 2.85 | 3.67 |
| 2 | Rodina | Boss | 4.64 × 5.15 | 1.58 | 2.87 | 2.90 | 3.69 |
| 3 | Kosmograd | Big Boss | 5.43 × 5.47 | 2.85 | 2.82 | 4.20 | 4.19 |
| 4 | Medved | Boss | 4.96 × 5.15 | 2.83 | 1.88 | 3.50 | 3.67 |
| 5 | Grom | Boss | 4.66 × 5.15 | 1.19 | 2.69 | 3.19 | 3.68 |
| 6 | Soyuz | Big Boss | 3.38 × 5.15 | 1.53 | 2.60 | 3.11 | 4.01 |
| 7 | Katyusha | Boss | 4.20 × 5.15 | 1.09 | 3.00 | 3.33 | 3.76 |
| 8 | Avrora | Boss | 4.94 × 5.15 | 1.59 | 2.93 | 3.30 | 3.80 |
| 9 | Sokol | Big Boss | 5.18 × 5.15 | 2.05 | 2.34 | 4.07 | 4.02 |
| 10 | Bronenosets | Boss | 5.19 × 5.47 | 2.08 | 2.45 | 3.53 | 3.84 |
| 11 | Sputnik | Big Boss | 5.14 × 5.47 | 2.62 | 2.75 | 4.05 | 4.18 |
| 12 | Meduza | Final | 4.25 × 5.40 | 1.95 | 1.79 | 2.57 | 4.01 |
"Hit radius" is the elliptical bullet hitbox and "Ram radius" the force field that pushes the ship back (until the shield is down, when the ram shrinks to the hit radius), both centred on the model, except these hitboxes, right of centre: Iskra's (0.12), Rodina's (0.14), Grom's (0.11), Katyusha's (0.08), Avrora's (0.15) and Sokol's (0.10); Meduza's (0.11 left, 1.04 up); and Avrora's ram field (0.47 up). In 0.4.0 the x radii were refit to the new models' widths (the lengths match the old ones, so the y radii stayed), then bosses 07, 08, 10 and 12F were tuned by hand on the new models: mainly taller hit ellipses. In 0.4.1 bosses 01, 02, 04, 05, 07 and 08 were re-delivered reshaped (same length, new widths) and their hit x radii moved by the change in half-width again; ram radii and y radii stayed. On 2026-10-06 the second fleet's Bomber, Shuttle, Interceptor, Gunship and Drone took waves 4, 6, 9, 10 and 11 over as Medved, Soyuz, Sokol, Bronenosets and Sputnik. Each kept its wave's radii, hit and ram, moved by the change in half-width and half-length. Soyuz and Sokol are Boss-length in Big Boss waves, and Bronenosets is Big-Boss-length in a Boss wave. On 2026-10-14 every hitbox but Kosmograd's and Sputnik's was re-tuned by hand on its own model: mostly narrower and longer ellipses that follow the hulls. The ram radii stayed. A second pass on 2026-10-22 narrowed them all again (Kosmograd and Sputnik aside), and Avrora's ram field grew (2.94/3.72 → 3.30/3.80) and moved up the hull. The ram field sits outside the hull on both axes; touching it knocks the ship (or split half) away over 0.5 s and costs 10% of max health.
Player DPS vs. Enemy Scaling
A rough at-a-glance comparison: player Ship DPS (using Laser's numbers as the conservative floor — Blaster and Spread both run higher, see the Weapons table above) against that wave's Boss/Big Boss HP, assuming weapon level tracks the wave number. TTK is the HP x 1.5 (the boss shield) over Ship DPS, and ignores dodging, downtime, and any Rapid Fire/energy-weapon/smart-bomb burst layered on top — see the Boss section's full-kit table for those.
| Wave | Level | Ship DPS | Kind | Boss HP | TTK (sec) |
|---|---|---|---|---|---|
| 1 | 1 | 144.0 | Boss | 6,500 | 67.7 |
| 2 | 2 | 165.6 | Boss | 8,000 | 72.5 |
| 3 | 3 | 187.2 | BIG | 16,000 | 128.2 |
| 4 | 4 | 208.8 | Boss | 10,500 | 75.4 |
| 5 | 5 | 230.4 | Boss | 13,500 | 87.9 |
| 6 | 6 | 252.0 | BIG | 24,000 | 142.9 |
| 7 | 7 | 273.6 | Boss | 17,500 | 95.9 |
| 8 | 8 | 295.2 | Boss | 20,000 | 101.6 |
| 9 | 9 | 316.8 | BIG | 37,000 | 175.2 |
| 10 | 10 | 338.4 | Boss | 24,000 | 106.4 |
| 11 | 11 | 360.0 | BIG | 49,000 | 204.2 |
| 12 | 12 | 381.6 | FINAL | 132,000 | 518.9 |
Run Length Budget
The wave curves above are tuned against a target of 20-25 minutes per full run. Model time per wave is the spawn phase, plus 3.5 s before the first squad (WAVE_START_DELAY), plus 10 s of boss announcement (5 s of quiet to clear stragglers or use a smart bomb, then 5 s of flashing, named warning), plus the boss fights. Since the boss shield (2026-10-15) the fights use the full-kit time to kill from the Boss section, the model the boss HP is tuned to; before that they used the Laser-only TTK column above.
| Segment | Model time |
|---|---|
| Spawn phases (12 waves) | 487 s |
| Wave start delays (12×3.5) | 42 s |
| Boss announce overhead (12×10) | 120 s |
| Regular Bosses (7) | 305 s |
| Big Bosses (4) | 357 s |
| Final Boss | 300 s |
| Total | 1,611 s (26.9 min) |
Calibration: the old 10-wave run modelled at 1,374s and played in about 20 real minutes (≈0.87x the model), so the 12-wave run above projects to ~21.5 real minutes. Treat the model as a design tool, not a measurement — a timed playtest is the real gate.
Reinforced waves: every formation row now carries one extra regular enemy and each wave ends with two extra squads (wave 1's squads are not reinforced, so its open-centre opening stays). Wave 12 goes from 208 to ~320 enemies, so the spawn phases above grow from ~487 s to ~770 s of model time and a played run projects to ~20-21 minutes (was ~17). Unmeasured — needs a timed playtest.
Spawn interval by difficulty (2026-10-17): the spawn phases above use
the unscaled spawn_interval(), which is now Cadet's.
Gunner's run at 0.9x and Ace's at 0.85x (see Difficulty below), about
11% and 18% more squads per minute, so their spawn phases are 10% and
15% shorter.
Difficulty — Cadet/Gunner/Ace
Source: scripts/difficulty_settings.gd (_TUNING), read by scripts/main_game.gd, scripts/boss.gd, scripts/big_boss.gd, scripts/enemy.gd, scripts/boss_mini_kamikaze.gd, scripts/boss_attacks/boss_attack_runner.gd, scripts/player.gd; scripts/achievements.gd and scripts/online_toplist_offer.gd for the rest
Persisted player choice, selectable from a DIFFICULTY row in Settings and shown live in the HUD by its crown shield and its name. Every other number on this page is Gunner's, which is the balance that was Pro before there were three difficulties, except kill scores and enemy, Boss and Big Boss HP (and so time to kill), which are the unscaled values only Ace keeps. Everything that differs by difficulty (to balance in playtesting):
| Group | Parameter | Cadet | Gunner | Ace |
|---|---|---|---|---|
| Enemy toughness | Enemy, Boss and Big Boss health | 0.5 | 0.75 | 1.0 |
| Enemy pressure | Enemy and boss bullet speed (torpedoes' acceleration and top speed too) | 0.8 | 1.0 | 1.15 |
| Enemy approach speed (squads, kamikazes' acceleration, boss minis' attack) | 0.85 | 1.0 | 1.1 | |
Regular squad spawn interval (spawn_interval(), so each squad's form-up time and gap; lower = denser) | 1.0 | 0.9 | 0.85 | |
| Boss and Big Boss time between volleys and between bursts (lower = more fire) | 1.2 | 1.0 | 0.85 | |
Regular enemies' time between shots (the squad's rolled shoot_interval; lower = more fire) | 1.15 | 1.0 | 0.9 | |
| Player survival | Damage the player takes (bullets and boss rams) | 0.75 | 1.0 | 1.25 |
| Health pickup repair (multiplier → share of max hull) | 1.3 → 65% | 1.0 → 50% | 0.8 → 40% | |
| Rewards | Score per kill (before the kill-streak multiplier) | 0.5 | 0.75 | 1.0 |
| Achievement tiers unlocked per feat | Bronze | Bronze + Silver | Bronze + Silver + Gold | |
| Online toplist | — | — | yes | |
| Presentation | HUD and Settings crown shield | 1 crown | 2 crowns | 3 crowns |
| Default on a new install | — | — | yes |
A higher interval means fewer shots: Cadet's bosses fire about 17% less often than Gunner's and Ace's about 18% more often; regular squads about 13% less and 11% more. Kill scores and enemy health were 0.75 / 1.0 / 1.0 and fire rates and the health pickup the same on all three until 2026-10-27.
The same on all three: boss movement and sideways sways, a burst's shots within it, each boss's first volley, Shield and Rapid Fire (15s each, 1.5x), Damage Up (+15%), pickup drops, the kill-streak multiplier, and the waves and boss roster. All three share one local high-score table.
The multipliers follow the run's own GameRun.difficulty, not the live Settings choice, so replays re-simulate at the difficulty they were recorded on.
Only Ace runs are offered the online toplist, and the replay validator refuses any other difficulty. Settings files and replays store "cadet"/"gunner"/"ace"; the older "easy" (Noob) loads as Cadet and "normal" (Pro) as Ace.
Downstream TODO
What's actually queued up next, and what's blocking it — mirrors TODO.md, not exhaustive.
Unblocked by the art direction decision (2026-10-03)
The placeholders are gone: the player, all fifteen enemy tiers and all twelve bosses are real textured 3D models from the concept sheets (a Swedish Tre Kronor ship against a Soviet-marked fleet). That look is now the chosen direction, Soviet Constructivist Propaganda (Direction I on the Art Direction page), so these no longer wait on it:
Not blocked — ready to scope now
- Player ship VFX follow-ups — done (2026-09-10), since revised: the per-disc engine exhaust particle stream shipped in 0.3.7 but is disabled as of 2026-09-11 in favor of a retro CRT-style motion-blur trail (faded "ghost" afterimages of each hull half, driven by that half's own speed) tried in its place. Detonations (Yonshakudama, smart bomb) and, as of 2026-09-11, non-final boss deaths all trigger camera screen shake, deliberately not routine hits. A separate, still-open idea: a smaller shake specifically on hits.
- Weapon & pickup progression — letting the player choose which slot's aim a rotate affects, if independent per-slot loadouts are ever wanted. (Per-weapon-type damage upgrades were considered and discarded as unnecessary complexity — the single global
DAMAGE_UPlevel is simpler to balance.) - Scoring & fairness/QoL — combo/streak scoring done (2026-09-12): kill streak scales score up to 2x (+10% every 50 kills since 2026-10-22, so 2x at a 500-kill streak; +5% before), resets only when an enemy escapes off the bottom of the screen, a diving kamikaze included and boss minis excepted (escapes cost no health and are marked where they left; getting hit no longer breaks it), has no decay timer, and pops a HUD banner at each milestone. Pause overlay resume/quit hints and a difficulty select are both done (2026-09-17; three levels, Cadet/Gunner/Ace, since 0.8.0) — see the Changelog. Still open: no post-hit invincibility frames (considered and shelved 2026-09-17 — no concrete playtesting case for it yet).
- Enemy-type variety across waves — done (2026-09-10): per-wave tier variety was already in via
_roll_squad_tier()'s per-level weight table across all 9 tiers (seedocs/enemy-tier-level-distribution.md), and the remaining gap — no tier sought or charged the player — is closed too: Yozh now usesMovePattern.KAMIKAZE, homing on the player and accelerating from a slow start until it hits or is destroyed, firing no bullets at all. Still experimental/being playtested — seeBALANCE.md's "Kamikaze tier (Yozh)". - Boss liveliness — done (2026-10-03): every boss now fires from its modelled weapons, hovers and turns toward you, and wears its damage per phase (smoke, sparks, thrown hull plates, failing lights). Turrets track the half about to be shot; Kosmograd, the one ring station left, turns its inner ring; the Final Boss's jointed tentacles sway on their own and lash when it is hurt. Bosses and ring stations die in a chain of explosions. Still open: hit sparks, a real entrance, per-weapon sound.
- Boss-launched mini kamikazes — done (2026-09-28, shipped in 0.4.1): the Big Bosses and the Final Boss send out half-size kamikazes the split halves must dodge, or steer into their own fire lines (the laser suits that), so boss fights pay points before the kill. First-pass numbers are still to tune after playtesting. The Final Boss launches from its own iris hatch since 2026-10-04.
gdlintrcbaseline — kept at exactly one accepted error (audio_manager.gd:30); re-rungdlint scripts/ tests/before committing so it doesn't drift again.
Bigger, further out
Discord Rich Presence, console platform-holder applications (Xbox/PS5/Switch), anti-cheat/score-tampering protection, and the full game-balance pass — the last of these is explicitly deferred until enemy variety, boss attack sets, and weapon progression above have landed, so there's a stable full run to tune against.