Files
RustRaptor/PLAN.md
T
raptorreplica 214789fe87 Fork the vendored engine into the playable replica
Engine changes vs the vendored upstream (full ledger in
docs/upstream-patches.md):

- Assets: replace the encrypted FILE000N.GLB archives with a catalog of
  pre-decrypted loose files (data/INDEX); GLB_SlotItems() drives
  mission-pack / registered-version detection; payloads never run the
  GLB cipher at runtime.
- Platform: Linux/SDL2/ALSA only; Android, MSVC/MinGW, macOS packaging,
  bundled Windows SDL2 SDKs and the ENDOOM exit screen are gone;
  EXIT_Error now prints before exiting.
- Rendering: decouple presentation from simulation -- sim stays at the
  original 70/3 Hz, frames render interpolated at display rate (player,
  map scroll, enemies, shots, bonuses, anims, shadows); menus keep 70 Hz
  pacing; vsync with a delay-guard fallback.
- QoL: borderless window mode (Video/borderless), no menu cursor
  snapping onto default buttons.

Fix four regressions from the render split:

- Shield bars never redrew: RAP_ThinkStats latches g_oldshield each sim
  step before RAP_DisplayStats' dirty check could fire. Bars now draw
  unconditionally per rendered frame; g_oldsuper deleted, g_oldshield
  kept as sim-side damage-detection state only.
- Dying ships despawned without exploding: the render loop never called
  ANIMS_DisplayHigh(); most air-death explosions register HIGH_AIR.
  Restored between the player and enemy shots, as upstream orders it.
- Laser turret broke: reusing doneflag as a draw marker (it is
  hit/retire game state, and the turret retire path never frees its
  shot) hid the beam on hitting ticks and leaked one SHOTS pool slot
  per fire until no weapon could shoot. S_LINE tracers now carry an age
  counter: one Think pass, every render of their birth step, purged at
  the top of the next Think.
- Muzzle flash was cleared per rendered frame, making it invisible at
  display refresh rates; now cleared once per simulation step.
2026-08-26 18:45:07 +10:00

1.7 KiB

RaptorReplica — Raptor: Call of the Shadows

Status: PLAYABLE — original engine, original data, extracted into a modern asset tree. Full documentation lives in docs/:

Run with ./play.sh.

The 5 mission packs

The registered data ships 5 campaign packs (each mission: mountain → valley → sky phases + boss). Pack presence is detected from catalog slots at boot; slot 2 or 3 present flips the engine to registered mode.

Roadmap (on top of the source)

  1. Extra mission packs authored as new cataloged assets in the original formats.
  2. QoL patches kept as documented diffs against upstream (see docs/upstream-patches.md): resolution options, audio device selection, keybind config surface. Landed so far: decoupled interpolated rendering (presentation at display rate, simulation at the original 70/3 Hz), borderless window mode (Video/borderless), removal of menu cursor snapping.
  3. Track upstream (skynettx/raptor) and rebase the documented diffs.
  • raptor/ is GPLv2+; this project inherits GPL for anything built on it.
  • data/ is derived from the user's own purchased copy (copyrighted); it is gitignored and never committed.