Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

All notable changes to this project will be documented in this file.

## [Unreleased]
## [1.35.0] - 2026-11-14

### Added

Expand All @@ -11,10 +11,11 @@ All notable changes to this project will be documented in this file.

### Changed

- Lance is now your main gun from sector 3 on, and Scatter and Seekers are special guns you use on a charge. Press Q (or the swap button on touch screens) to go Lance → Scatter → Seekers → Lance. A special gun runs down a charge meter: a full meter lasts 10 seconds, and when it empties you go back to Lance on your own, with the gun's name flashing over your ship. The meter only refills on Lance, over 30 seconds, and every enemy you destroy tops it up a little. You need a fifth of the meter to leave Lance; below that Q just clicks. Switching between the special guns, or back to Lance, always works.
- Lance is now your main gun from sector 3 on, and Scatter and Seekers are special guns you use on a charge. Press Q (or the swap button on touch screens) to go Lance → Scatter → Seekers → Lance. A special gun runs down a charge meter: a full meter lasts 8 seconds, and when it empties you go back to Lance on your own, with the gun's name flashing over your ship. The meter only refills on Lance, over 40 seconds, and every enemy you destroy tops it up a little (half a percent). You need a fifth of the meter to leave Lance; below that Q just clicks. Switching between the special guns, or back to Lance, always works.
- The meter starts full at the start of every sector and after you respawn or load a checkpoint. Pausing and hit-stops never run it down.
- The HUD shows the current gun and its charge under your reserve ships from sector 3: amber while a special gun drains it, cyan while Lance refills it. The touch swap button shows the same charge along its foot. Sectors 1 and 2 are unchanged: standard gun, no meter, and Q does nothing.
- `bun run balance:bosses` measures every boss with Lance only; its `--guns` option is gone.
- Seven bosses have less hull now that Lance is the main gun: Marshal Vectra 505 → 440, Reef Stalker 625 → 550, Bastion Bulwark 520 → 460, Choir Regent 1040 → 830, Umbral Ark 1320 → 1170, Hive Maelstrom 1645 → 1580, Omega Null 1300 → 1230. Pyre Herald and every par time are unchanged. Spending the charge whenever the meter is full kills each boss a little under par; never pressing Q stays close to par, so the boss speeds up but never walls you.
- `bun run balance:bosses` measures three gun policies: Lance only, and Scatter or Seekers spent whenever the meter is full. `--guns lance,scatter,seekers` picks policies and `--runs N` repeats each fight; a summary table shows each sector's mean kill time against par, the run-to-run spread, deaths and the share of the fight flown on a special gun.

### Removed

Expand Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ Playable here:

| | |
|---|---|
| ![Main menu](docs/screenshots/menu.webp) | ![A sector 3 fight with the Scatter gun](docs/screenshots/sector-3-scatter.webp) |
| ![Choosing a main gun at the refit bay](docs/screenshots/ship-system-pick.webp) | ![The refit bay between sectors](docs/screenshots/refit-bay.webp) |
| ![A sector 4 fight with the Lance gun](docs/screenshots/sector-4-lance.webp) | ![The first boss, Pyre Herald](docs/screenshots/first-boss.webp) |
| ![Main menu](docs/screenshots/menu.webp) | ![A sector 3 fight with Scatter out on the charge](docs/screenshots/sector-3-scatter.webp) |
| ![The card that introduces the special guns](docs/screenshots/special-guns-card.webp) | ![The refit bay between sectors](docs/screenshots/refit-bay.webp) |
| ![A sector 4 fight with the Lance, the main gun](docs/screenshots/sector-4-lance.webp) | ![The first boss, Pyre Herald](docs/screenshots/first-boss.webp) |

## Quick start

Expand Down Expand Up @@ -119,7 +119,7 @@ Bought during the planet intermission screen using score as currency:
- **Fire Rate** — improves firing speed
- **Shield** — increases hit absorption
- **AEGIS Picket** — installs and overclocks automatic flank-defense turrets
- **Lance and special guns** — from sector 3 the ship flies Lance, a piercing gun. Q (or the touch swap button) switches to Scatter or Seekers for as long as a charge meter lasts: a full meter gives 10 seconds, then the gun returns to Lance. On Lance the meter refills over time and a little with every kill, and you need a fifth of it to switch again. The meter starts full every sector and after every respawn or checkpoint load. A short card at the refit bay after sector 2 explains all this
- **Lance and special guns** — from sector 3 the ship flies Lance, a piercing gun. Q (or the touch swap button) switches to Scatter or Seekers for as long as a charge meter lasts: a full meter gives 8 seconds, then the gun returns to Lance. On Lance the meter refills over 40 seconds and a little with every kill, and you need a fifth of it to switch again. The meter starts full every sector and after every respawn or checkpoint load. A short card at the refit bay after sector 2 explains all this
- **Ship systems** — free picks after sectors 5 and 8 that change how the ship plays: a support system (Magnet, Surge Core, Wingman) and a doctrine (Overdrive, Bulwark, Salvager). Picks can be changed freely at any later refit bay, and mid-run from the pause panel
- **A different run every time** — each run has its own sky and may fly sectors mirrored; RETRY replays the same run, NEW RUN starts a fresh one

Expand Down
4 changes: 2 additions & 2 deletions docs/level-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,13 @@ shields recharge on every respawn.
Levels 5–10 add payoff without adding player inputs:

- **AEGIS Picket** becomes purchasable after Level 4. Its fixed flank turrets trim chaff with flat-damage bolts while the main gun remains the dominant damage source. Pickets never target bosses.
- **Main guns** (`config/shipSystems.ts`): sectors 1–2 fly the standard bolt and have no gun input, so the opening stays a gentle introduction. From sector 3 the home gun is Lance; Scatter and Seekers are special guns borrowed on a charge, not picks. Each gun trades single-target damage for one strength and scored inside the standard gun's run-to-run spread in sector 5. Q or the touch swap key steps Lance → Scatter → Seekers → Lance. One meter, `SPECIAL_GUN_CHARGE`, counted on the gameplay clock, pays for the specials: it drains while one is selected (a full meter lasts 10 s) and returns the gun to Lance at empty; on Lance it refills over 30 s plus a bonus per enemy destroyed; leaving Lance needs at least 0.2 of it, while moving between specials or back to Lance is always allowed. It starts full every sector and after every respawn or checkpoint load, and is never saved. Feedback is a name flash over the ship and a short swap sound on every change (including the automatic return), the quiet click when leaving Lance is refused, each gun's own shot look (the profile's `look`), and the HUD's gun row under the reserve ships: the gun's name and a charge bar that burns amber while a special drains and refills cyan on Lance, with a tick at the threshold. The touch swap key mirrors the bar along its foot. The guns are taught, never picked: the refit bay after sector 2 opens on a one-button SPECIAL GUNS ONLINE card (`planetIntermission/specialGunIntro.ts`, shown on every visit to that bay and no other), and sector 3 only points at the swap until the first one there (`ShipSystemsRuntime.isSwapHintPending`): a `Q SPECIAL GUN` label beside the charge bar on a keyboard, a pulsing ring around the touch swap key.
- **Main guns** (`config/shipSystems.ts`): sectors 1–2 fly the standard bolt and have no gun input, so the opening stays a gentle introduction. From sector 3 the home gun is Lance; Scatter and Seekers are special guns borrowed on a charge, not picks. Each gun trades single-target damage for one strength and scored inside the standard gun's run-to-run spread in sector 5. Q or the touch swap key steps Lance → Scatter → Seekers → Lance. One meter, `SPECIAL_GUN_CHARGE`, counted on the gameplay clock, pays for the specials: it drains while one is selected (a full meter lasts 8 s) and returns the gun to Lance at empty; on Lance it refills over 40 s plus 0.005 per enemy destroyed; leaving Lance needs at least 0.2 of it, while moving between specials or back to Lance is always allowed. It starts full every sector and after every respawn or checkpoint load, and is never saved. Feedback is a name flash over the ship and a short swap sound on every change (including the automatic return), the quiet click when leaving Lance is refused, each gun's own shot look (the profile's `look`), and the HUD's gun row under the reserve ships: the gun's name and a charge bar that burns amber while a special drains and refills cyan on Lance, with a tick at the threshold. The touch swap key mirrors the bar along its foot. The guns are taught, never picked: the refit bay after sector 2 opens on a one-button SPECIAL GUNS ONLINE card (`planetIntermission/specialGunIntro.ts`, shown on every visit to that bay and no other), and sector 3 only points at the swap until the first one there (`ShipSystemsRuntime.isSwapHintPending`): a `Q SPECIAL GUN` label beside the charge bar on a keyboard, a pulsing ring around the touch swap key.
- **Ship systems** are free one-of-three picks at the refit bay after sectors 5 and 8. They change how the ship plays rather than how hard it hits. A system works without input; the only input is changing one. Once a slot has a pick the player may change it to another option of that slot: freely at every later refit bay (the picks sit beside the upgrade cards and reopen the pick dialog, which Escape dismisses) and mid-run from the pause panel's SYSTEMS tab. The current pick is saved with the run.
- **Run variation** comes from one seed per run (`systems/runVariation.ts`, `systems/gameplayRandom.ts`). It decides the wave choices, whether each sector is mirrored left to right, and the sky. Two rules keep scores comparable: the sky is looks only, and the only layout change is the mirror, which is as hard by symmetry. Never vary wave order, enemy counts or timing by seed. RETRY keeps the seed; NEW RUN draws a new one. Enemies, asteroids and wormholes each draw from their own seeded stream, so one cannot shift another's choices; how far a run gets through a stream still depends on play. Enemy jitter and pickup drops stay unseeded because they depend on how the fight goes.
- **Marked Aces** are sparse authored variants of existing enemies. Their gilded treatment signals 2× durability, 4× score, and exactly one guaranteed power-up.
- **Boss volleys are telegraphed.** For the last 400 ms before every volley the boss's core swells and its hardpoints flash white. Bosses have no stun or bonus-damage window; fights are paced by the wind-up and each attack's cooldown.
- **Boss fights are authored rotations.** A boss's whole fight lives in its level file (`BossConfig`): phases start at hull thresholds (any number of them), and each phase steps through an ordered list of attacks, each with its own cooldown, never picked at random. An attack can send the boss to an anchor first (`x` a share of the screen width, `y` pixels from the top) and holds the volley until it arrives, so a safe spot does not stay safe. Shared building blocks live in `entities/enemies/boss/volleys.ts`: arcs, aimed arcs, spirals, escort summons, a wall with one gap, an aimed burst, and a beam that reuses the hazard beam and its telegraph. A shielded attack keeps the hull closed from the previous volley until it fires, and only then.
- **Boss hull is authored, not scaled.** Upgrades shorten boss fights; nothing raises boss hull. Each boss has a par time (45-70 s) and a hull tuned so the sector's representative ship meets it with the measurement bot (`bun run balance:bosses`, which states the ship). Past par, cooldowns shrink evenly to 25% faster over 30 s; the wind-up keeps its length. The sector 3 boss does not escalate. A kill under par pays 200 points per whole second left. Fight time is the boss's gameplay clock, so pause and hit-stop never count.
- **Boss hull is authored, not scaled.** Upgrades shorten boss fights; nothing raises boss hull. Each boss has a par time (45-70 s) and a hull tuned with the measurement bot (`bun run balance:bosses`, which states the ship): flying the sector's representative ship and spending the special-gun charge on Scatter or Seekers whenever the meter is full, it kills every boss in 85-100% of par without dying, and on Lance alone it stays within about 5% past par. The policies spend about a quarter of each fight on a special gun. Past par, cooldowns shrink evenly to 25% faster over 30 s; the wind-up keeps its length. The sector 3 boss does not escalate. A kill under par pays 200 points per whole second left. Fight time is the boss's gameplay clock, so pause and hit-stop never count.
- **Max-chain Overdrive** reduces the main-gun cooldown by 15% while the existing chain multiplier remains at x5. It adds no input and ends immediately when the chain falls.

These systems must preserve Lane-Reading, avoid persistent HUD panels, and remain independently removable through upgrade/config gates.
Expand Down
Binary file modified docs/screenshots/first-boss.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/menu.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/refit-bay.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/sector-3-scatter.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/screenshots/sector-4-lance.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/screenshots/ship-system-pick.webp
Binary file not shown.
Binary file added docs/screenshots/special-guns-card.webp
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "space-explorer",
"version": "1.34.0",
"version": "1.35.0",
"author": "Douwe de Vries",
"license": "MIT",
"private": true,
Expand Down
Loading
Loading