VANTAGE: ZERO

Play it live: https://vantage-zero.vercel.app (Chrome or Edge, keyboard and mouse; press / in flight for every key and voice command)

Cinematic 3D fighter-aircraft combat — Mission 01: Operation Cold Threshold is fully playable from the main menu to the hangar.

Browser game: Vite + TypeScript + Three.js + Web Audio API. Everything (terrain, aircraft, audio, dialogue) is generated locally – no external assets, no network and no API keys are needed to play.

Status: Phase 2 vertical slice (see PROJECT_STATE.json for the authoritative, honest state of every module, test and known issue).

Prerequisites (checked on the development machine)

Tool	Version used
Node.js	24.x (any current LTS/stable should work)
npm	11.x
Browser	Current Chrome / Edge / Firefox with WebGL2 (hardware acceleration on)

Deployment (Vercel)

• Live at https://vantage-zero.vercel.app. The Vercel project vantage-zero is connected to this GitHub repo, so every push to main deploys to production automatically.
• Build settings are pinned in vercel.json: Vite, npm ci, npm run build, output dist. Models are cached for 7 days and hashed assets for a year.
• Manual deploy from this folder: vercel deploy --prod (CLI logged in as the project owner).
• Link preview: public/og-image.jpg, an in-game screenshot, is the Open Graph / Twitter card image and favicon.

Install, run, build, test

npm install          # one time
npm run dev          # development server → http://localhost:5173
npm run build        # type-check (tsc --noEmit) + production bundle in dist/
npm run preview      # serve the production build
npm test             # unit / simulation tests (vitest, headless)
npm run typecheck    # TypeScript only

Click once inside the page so the browser lets the game start audio (Web Audio needs a user gesture). Subtitles work with audio muted or unavailable.

Playing the vertical slice

1. New Campaign → choose a pilot
   • Route A – Specter-1 (boy) flies the Su-57, wingman Specter-2 (girl) flies the F-35 as an AI.
   • Route B – Specter-2 (girl) flies the F-35, wingman Specter-1 (boy) flies the Su-57 as an AI.
   • Pilots are colour-coded: Specter-1 (boy) wears an orange flight suit and helmet, Specter-2 (girl) a teal suit and helmet with auburn hair. The girl no longer wears a mask or mirrored visor; the cat has been removed from the game.
2. Hangar – walk around (WASD, Q/E camera). Then Mission Briefing → Launch, or pick Missions for Mission 02 and 03.
3. Mission 01 (all six phases, driven by real state – no timed cut-scenes):
   1. Takeoff & scramble – press F to start engines, taxi to runway 36, line up, full power, rotate near 135 kt, gear up, climb through 4,000 ft.
   2. Low-altitude transit – fly the Halcyon valley. A fictional radar network (sites in the east pass) detects you only when it has terrain line-of-sight; the HUD shows the detection meter. Staying low is rewarded; climbing above the ridge exposes you and alerts the drones.
   3. Interception – two hostile stealth drones. R selects contacts, they must be identified (inside 12 km and 30° of the nose for ~2 s) before weapons release. Use the long-range LR-9 radar missile first, then IR-7 (Fox-2) or the 20 mm cannon. Drones fire IR missiles back: use X flares and break.
   4. Blizzard & electronic interference – a weather front forms ahead of you on the main valley. Wingman sensors degrade (her radar picture, formation keeping and radio are really affected). Choose: the east pass (clear, via the Signal Spur beacon) or push through the blizzard (visibility ~260 m, turbulence).
   5. Return & landing – lower the gear, follow the ILS-style cue on the HUD, touch down near the target speed (115 kt Su-57 / 128 kt F-35 – the F-35 model stalls higher), roll out and stop on the runway.
   6. Debrief & hangar – graded from real events (kills, wingman survival, aircraft condition, landing quality, detection, route…), different dialogue per outcome, hangar scene, campaign saved.

Voice control (Wispr Flow or the browser microphone)

Everything you can do with keyboard and mouse can also be done by voice or typed text. Press Enter (rebindable) to focus the command line at the bottom of the screen.

• Wispr Flow: Wispr Flow has no public API – it types dictated text into whatever field has focus. Focus the game's command line (Enter, or click it), hold your Wispr Flow hotkey and speak; dictation that arrives as one burst is sent automatically (Settings → auto-send), otherwise press Enter. Turn on Voice-only mode in Settings to keep the field focused for hands-free play.
• Built-in microphone: the MIC button (key Y) uses the browser's speech recognition (Chrome/Edge, needs internet). It feeds the same parser.
• Several commands per sentence work: "gear up and throttle eighty percent, then climb to five thousand feet". Spoken numbers ("two seven zero", "four thousand five hundred") are understood.

This is the beginning of the README. Read the rest at the original. Read the full README ↗