Skip to content
13 changes: 8 additions & 5 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ All notable changes to this project will be documented in this file.

## [Unreleased]


### Added

- Change your ship systems while you play. Once a run has a main gun, press Q (or tap the new swap button under pause on touch screens) to switch Lance, Scatter and Seekers in turn. The new gun's name flashes over your ship. Swapping has a cost: the new gun takes half a second to start firing, and you can swap again only after 2 seconds (the button dims and charges up meanwhile). Pausing does not shorten either wait.
Expand All @@ -13,20 +14,22 @@ All notable changes to this project will be documented in this file.
- The game saves your run when you leave the refit bay for the next sector, so closing the tab no longer loses the ship system you just picked. The save appears in the main menu as AUTOSAVE, next to your three slots, and loads and deletes like them. It never overwrites a slot of yours, and it goes away when the run ends or you start a new one.
- Save slots in the main menu and the pause panel name the ship systems the saved run has picked.
- Fast-kill bonus: beat a boss under its par time and you score 200 points for every second left on the clock, shown as FAST KILL next to the kill. Pausing never costs you any of it.



- The refit bay lists your ship systems next to the upgrades once you have one. Select one to see its three options again, with the current one marked, and pick another: changing here is free, as often as you like, with no wait. Escape, or picking the current one again, keeps it. The next sector flies with your choice, and the autosave and your checkpoints store it.



### Changed

- The pause panel's `SYSTEMS:` line is replaced by the SYSTEMS tab.
- Boss fights are shorter and have more to read. Each boss phase now runs through a set order of attacks instead of one pattern on repeat, and some bosses fly to new spots between attacks, so no place under them stays safe. Every volley still has its wind-up.
- Boss health no longer grows when you buy weapons, fire rate, hull or shields. Upgrades now make boss fights shorter, as they should. Every boss has a fixed health tuned so a typical ship for that sector beats it in about 45 to 70 seconds.
- A boss that is still alive after its par time slowly fires faster, up to a quarter faster. The wind-up before each volley never gets shorter. The first boss (sector 3) keeps its pace, and sectors 1 and 2 are unchanged.
- Bastion Bulwark (sector 6) is rebuilt in three phases. Its shield now only closes while it charges a wall of shots with one gap in it, so you spend that time dodging, not waiting. At two thirds it starts flying from flank to flank, and at one third its shield breaks and it chases you and drops a beam on your lane.
- Pyre Herald (sector 3), the first boss, now alternates two slow attacks per phase instead of repeating one: twin ember fans and a fan that drifts with it, then a turning spiral and its first shots aimed at you. It stays as gentle as before, never speeds up and needs no main gun.
- Marshal Vectra (sector 4) now drills two line fans and then a crossfire that leaves a safe pocket right under it, so flying in close is the opening. At half health it starts stepping forward to a post at the centre, closer to you, and adds a turning spiral.
- Reef Stalker (sector 5) now fights in three phases. It follows your lane with an aimed fan and a burst of shots that re-aim one by one, then darts to each edge of the screen and fans across it (the way out is right under it), and in its last third chases faster with longer bursts and a wide fan to read.
- Choir Regent (sector 7) now fights in three phases, each with its own rhythm. First it fires two fans that interleave and then one aimed at you. At two thirds its fans turn outward and leave the lane under it open, then a fan closes that lane, then a quick burst follows you. At one third it adds a spinning volley and speeds up.
- Umbral Ark (sector 8) now fights in three phases, and each one opens by launching escorts in front of it. First a pair of fighters, then a gunship, and in the last third a pair of dodgers launched with a wall of shots whose gap moves each time. Lance shots pierce the escorts on their way to the hull; Seekers tend to chase the escorts instead of the Ark.
- Hive Maelstrom (sector 9) is rebuilt in three phases. It starts with one ring of shots that turns between volleys, then spins two rings against each other while it sweeps the screen, and at one third it chases you and fires its fastest rings. Every other round it launches swarms (later splitters) in front of its hull, which Lance cuts through and which pull Seekers off the boss.
- Omega Null (sector 10), the final boss, now has four phases that bring back what earlier bosses taught: leaning fans and aimed bursts, a shielded wall with a gunship guard, counter-rotating rings and a beam, and at the end all of them in turn while it chases you. It switches hulls at half health as before, and has less health, so the fight is about reading attacks rather than wearing it down.

### Fixed

Expand Down
32 changes: 17 additions & 15 deletions docs/level-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,18 +138,18 @@ exclusive to L5, L9, and L10.

### 2.9 Boss attack-style plan

All six hull styles are used; a phase can switch style (the finale does). Bastion Bulwark is the first boss authored for the rotation engine; the others still fire one attack per phase and are due their own rotations.
All six hull styles are used; a phase can switch style (the finale does). Every boss is authored for the rotation engine, each in its own level file; the early bosses teach one idea each (fans, anchors, the aimed burst) and the finale reprises them.

| Level | Boss | Phases | Par |
|---|---|---|---|
| L3 | Pyre Herald | barrage, 2 phases (no escalation) | 45 s |
| L4 | Marshal Vectra | pressure, 2 phases | 50 s |
| L5 | Reef Stalker | pursuit, 2 phases | 52 s |
| L3 | Pyre Herald | barrage, 2 phases at 50% (no escalation), two attacks each with slow shots and long gaps: kindling (twin ember fans, a fan that leans with its patrol), pyre (faster patrol, turning spiral, the first aimed fan) | 45 s |
| L4 | Marshal Vectra | pressure, 2 phases at 50%; introduces anchors: drill (two line fans, then a crossfire with a pocket under the hull), advance (steps forward to a centre post for the crossfire, then a line fan and a spiral) | 50 s |
| L5 | Reef Stalker | pursuit, 3 phases at 66% and 33%; introduces the aimed burst: stalk (aimed fan, 3-shot lock-on), flank (darts to each edge and fans across the screen, safe under its hull, 4-shot lock-on), frenzy (fast chase, aimed double fan, 5-shot lock-on, wide shatter fan) | 52 s |
| L6 | Bastion Bulwark | bulwark, 3 phases at 66% and 33%: rampart (shield only while charging a wall), breach (flank anchors, aimed burst, rotary), last stand (no shield, pursues, beam) | 60 s |
| L7 | Choir Regent | pressure, 2 phases | 58 s |
| L8 | Umbral Ark | carrier (debut), 2 phases | 62 s |
| L9 | Hive Maelstrom | maelstrom (debut), 2 phases | 65 s |
| L10 | Omega Null | pressure -> maelstrom (finale switch), 2 phases | 70 s |
| L7 | Choir Regent | pressure, 3 phases at 66% and 33%, each a fixed rhythm: hymn (two interleaving fans, then a fan aimed at you), antiphon (outward loft fans that leave the lane under it open, a nave fan that closes it, a cantor's aimed burst), crescendo (rotary, hymn, lofts with a short burst, over a faster patrol) | 58 s |
| L8 | Umbral Ark | carrier (debut), 3 phases at 66% and 33%, each opening with a launch: hangar (fighter pair, crossing broadsides), convoy (a gunship escort, flak aimed at you, rotary), narrows (a wall whose gap moves, with a dodger pair launched into it) | 62 s |
| L9 | Hive Maelstrom | maelstrom (debut), 3 phases at 66% and 33%: brood wake (one turning ring fired twice, aimed sting, swarm pairs), maelstrom (counter-rotating rings from a fast patrol, aimed burst), eye of the storm (pursues, full-spin rings, splitter pairs) | 65 s |
| L10 | Omega Null | pressure -> maelstrom (finale switch at 50%), 4 phases at 75%, 50% and 25%: pressure (interleaving fans, aimed burst), siege (shielded wall, gunship guard, aimed fan), maelstrom (counter-rotating rings, low flank beam), null (pursues: beam inside sparse rings, aimed burst, shielded wall) | 70 s |

## 3. The 10-level concept sheet

Expand All @@ -169,18 +169,18 @@ Difficulty shorthand: G = gentle, R = ramp, H = hard.

### L3: Ember Monsoon (G->R) - planet Cinderreach - motif: ember storm
- Sower + minefield debut; energy-storm returns as the weather.
- First boss: Pyre Herald (barrage), taught by a mid-boss elite wave at 60%.
- First boss: Pyre Herald (barrage), taught by a mid-boss elite wave at 60%. Two gentle phases of two attacks each; it never escalates and needs no gun pick.
- distance 14500, spawnRate 1.35; enemies: fighter 30, sower 18, swarm 27, diver 25.
- Drops: health at the heat front, shield pre-boss.

### L4: Clockwork Causeway (R) - planet Gearhaven - motif: clockwork
- Waves arrive on the musical beat; lancer debut (telegraphed sniper duels).
- Boss: Marshal Vectra (pressure). distance 16000, spawnRate 1.55, encounter 2-2.
- Boss: Marshal Vectra (pressure; the first boss to fly to an anchor, stepping forward to a centre post in phase 2). distance 16000, spawnRate 1.55, encounter 2-2.
- enemies: fighter 30, lancer 20, diver 20, gunship 30.

### L5: Shatter Reef (R) - planet Korra Vale - motif: coral reef
- Splitter debut (kills multiply); nebula-ambush remix. Mid-campaign exam.
- Boss: Reef Stalker (pursuit). distance 17500, spawnRate 1.75, encounter 2-3.
- Boss: Reef Stalker (pursuit, three phases; debuts the aimed burst and breaks off the chase to strike from the flanks). distance 17500, spawnRate 1.75, encounter 2-3.
- enemies: fighter 25, splitter 25, bomber 20, gunship 30.

### L6: Debris Gauntlet (R->H) - planet Bastion Fall - motif: wreckage ramparts
Expand All @@ -191,23 +191,25 @@ Difficulty shorthand: G = gentle, R = ramp, H = hard.

### L7: Hollow Choir (H) - planet Vesper Nine - motif: cathedral
- Elite remix: lancers and gunships behind wormhole warp-ins, ghostly fade-in ambushes.
- Boss: Choir Regent (pressure, tuned hard). distance 19000, spawnRate 1.9.
- Boss: Choir Regent (pressure, tuned hard; three phases, each a fixed rhythm of fans and aimed bursts). distance 19000, spawnRate 1.9.
- enemies: fighter 28, lancer 22, swarm 26, gunship 24.

### L8: Eclipse Narrows (H) - planet Umbral Rook - motif: eclipse
- Convoy escort fantasy through tight corridors; bombers and gunships in pincer waves.
- Boss: Umbral Ark (carrier debut, escort summons). distance 19500, spawnRate 2.0.
- Boss: Umbral Ark (carrier debut; three phases, each opening with an escort launch in front of the hull). distance 19500, spawnRate 2.0.
- enemies: bomber 22, gunship 30, dodger 20, fighter 28.

### L9: Swarmfront (H) - planet Hive Lathe - motif: hive
- Set-piece level: swarm survival. Splitters return; density peaks here.
- Boss: Hive Maelstrom (maelstrom debut, counter-rotating spirals).
- Boss: Hive Maelstrom (maelstrom debut, three phases: one turning ring, then counter-rotating rings,
then it hunts the player; swarm and splitter pairs launch in front of the hull).
- distance 20000, spawnRate 2.1; enemies: swarm 45, splitter 15, dodger 15, fighter 25.

### L10: Eventide Engine (H) - planet Omega Spire - motif: singularity engine
- Final exam: the level reprises every gimmick in sequence (wormholes, minefields, flares,
lattice, corridors) across 6 sections.
- Boss: Omega Null, pressure into maelstrom phase switch, the hardest fight in the game.
- Boss: Omega Null, the hardest fight in the game: four phases that reprise earlier bosses (fans,
shielded walls, gunship guard, rings, beams), switching pressure into maelstrom at half hull.
- distance 21000, spawnRate 2.25; enemies: fighter 30, lancer 18, gunship 32, sower 20.

## 4. Re-theme sync points
Expand Down
60 changes: 46 additions & 14 deletions src/config/levels/definitions/crownOfRings.ts
Original file line number Diff line number Diff line change
@@ -1,7 +1,21 @@
import type { LevelConfig } from '../types';
import type { BossMovementConfig, BossShotPattern, LevelConfig } from '../types';
import { arpeggiatorPatterns, bassPatterns } from '../music';
import { createSignatureMusic } from './reimaginedMusic';

/** Two fans from the hangar decks, each turned in so they cross below the hull. */
const ARK_BROADSIDE: readonly BossShotPattern[] = [
{ kind: 'arc', shots: 5, arcDegrees: 54, speed: 0.95, originsX: [-22], originY: 24, angle: -8 },
{ kind: 'arc', shots: 5, arcDegrees: 54, speed: 0.95, originsX: [22], originY: 24, angle: 8 },
];
/** Flak: a fan centred on the player. */
const ARK_FLAK: BossShotPattern = { kind: 'aimedArc', shots: 7, arcDegrees: 48, speed: 1.05, originY: 30 };
const ARK_PATROL: BossMovementConfig = {
kind: 'patrol',
speed: 58,
edgePadding: 90,
bob: { amplitude: 10, periodMs: 2417 },
};

export const CROWN_OF_RINGS_LEVEL: LevelConfig = {
name: 'Eclipse Narrows',
planetName: 'Umbral Rook',
Expand All @@ -11,7 +25,7 @@ export const CROWN_OF_RINGS_LEVEL: LevelConfig = {
pacingSummary: 'Corridor escort beats tighten into the Umbral Ark carrier engagement.',
enemyCompositionSummary: 'Bombers and gunships pincer; dodgers harry the convoy line; fighters screen.',
hazardSummary: 'Rock corridors and mirrored crossfire in eclipse shadow.',
bossConcept: 'Umbral Ark debuts the carrier style, summoning escorts through the narrows.',
bossConcept: 'Umbral Ark debuts the carrier style: every phase opens with an escort launch in front of the hull.',
difficultyRole: 'Hard level testing convoy discipline under pincer pressure.',
journeyNote: 'In the shadow of the eclipse, the convoy runs the narrows with the Ark astern.',
bgColor: '#060608',
Expand All @@ -30,39 +44,57 @@ export const CROWN_OF_RINGS_LEVEL: LevelConfig = {
hasBoss: true,
boss: {
name: 'Umbral Ark',
maxHp: 1120,
maxHp: 1320,
parSeconds: 62,
escalatesPastPar: true,
phaseChangePauseMs: 300,
// A carrier: every phase opens with a launch, and the escorts arrive in the line between the ship
// and the Ark. Clearing them costs time; ignoring them costs room. The broadside is its one gun.
phases: [
{
// Hangar: a fighter pair, then two crossing broadsides; the crossing leaves the flanks open.
startsAtHull: 1,
style: 'carrier',
movement: { kind: 'patrol', speed: 57.6, edgePadding: 90, bob: { amplitude: 10, periodMs: 2417 } },
movement: ARK_PATROL,
attacks: [
{
cooldownMs: 1060,
cooldownMs: 1100,
volley: [
{ kind: 'arc', shots: 4, arcDegrees: 54, speed: 0.931, originsX: [-22], originY: 24, angle: -8 },
{ kind: 'arc', shots: 4, arcDegrees: 54, speed: 0.931, originsX: [22], originY: 24, angle: 8 },
{ kind: 'summon', escorts: ['swarm', 'scout'], onVolleys: 'even' },
{ kind: 'summon', escorts: ['fighter', 'fighter'] },
{ kind: 'arc', shots: 3, arcDegrees: 14, speed: 0.9, originY: 30 },
],
},
{ cooldownMs: 1000, volley: ARK_BROADSIDE },
{ cooldownMs: 1000, volley: ARK_BROADSIDE },
],
},
{
// Convoy: a gunship rides ahead of the hull, flak follows the player, and the rotary turns.
startsAtHull: 0.66,
style: 'carrier',
movement: { ...ARK_PATROL, speed: 75 },
attacks: [
{ cooldownMs: 1100, volley: [{ kind: 'summon', escorts: ['gunship'] }, ...ARK_BROADSIDE] },
{ cooldownMs: 900, volley: [ARK_FLAK] },
{ cooldownMs: 900, volley: [{ kind: 'spiral', shots: 5, degreesPerSecond: 192, speed: 1.04, originY: 30 }] },
],
},
{
startsAtHull: 0.5,
// Narrows: every launch comes with a wall, so the dodger pair is met inside the one corridor
// left open, and the gap moves each time.
startsAtHull: 0.33,
style: 'carrier',
movement: { kind: 'patrol', speed: 129.6, edgePadding: 90, bob: { amplitude: 10, periodMs: 2417 } },
movement: { ...ARK_PATROL, speed: 90 },
attacks: [
{
cooldownMs: 550,
cooldownMs: 1300,
volley: [
{ kind: 'spiral', shots: 5, degreesPerSecond: 192, speed: 1.04, originY: 30 },
{ kind: 'arc', shots: 5, arcDegrees: 38, speed: 1.04, originY: 26, lean: 4 },
{ kind: 'summon', escorts: ['fighter', 'swarm'], onVolleys: 'odd' },
{ kind: 'wall', gaps: [0.3, 0.7, 0.5], gapWidth: 120, spacing: 44, speed: 0.8, originY: 30 },
{ kind: 'summon', escorts: ['dodger', 'dodger'] },
],
},
{ cooldownMs: 900, volley: ARK_BROADSIDE },
{ cooldownMs: 900, volley: [ARK_FLAK] },
],
},
],
Expand Down
Loading
Loading