raptorreplica
214789fe87
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.
47 lines
2.0 KiB
Markdown
47 lines
2.0 KiB
Markdown
# RaptorReplica
|
|
|
|
A faithful, playable replica of **Raptor: Call of the Shadows** (Cygnus
|
|
Studios, 1994) running the reconstructed original engine on Linux, with the
|
|
original game data extracted into a modern, editable asset tree.
|
|
|
|
## Quick start
|
|
|
|
```sh
|
|
./play.sh
|
|
```
|
|
|
|
Builds the engine on first run, then launches fullscreen. Saves and
|
|
`SETUP.INI` live in `~/.local/share/Raptor/` — nothing in the repo is
|
|
written to.
|
|
|
|
## Repository layout
|
|
|
|
| Path | What it is |
|
|
|-------------|------------|
|
|
| `raptor/` | Vendored engine source (GPLv2+), trimmed to a Linux-only build. Patches against upstream are listed in [upstream-patches.md](upstream-patches.md). |
|
|
| `data/` | The asset tree the engine loads: one `INDEX` catalog plus category directories (`music/`, `sprites/`, ...). Derived from the copyrighted originals — **gitignored, never commit**. See [asset-pipeline.md](asset-pipeline.md). |
|
|
| `tools/glbextract.py` | Cracks the original `.GLB` archives into `data/`. See [glb-format.md](glb-format.md). |
|
|
| `docs/` | This documentation. |
|
|
| `play.sh` | One-command launcher (build if needed, run from `data/`). |
|
|
| `PLAN.md` | Project status and roadmap. |
|
|
|
|
## Documentation index
|
|
|
|
- [architecture.md](architecture.md) — how the engine starts up and loads assets
|
|
- [glb-format.md](glb-format.md) — the original archive format and its cipher
|
|
- [asset-pipeline.md](asset-pipeline.md) — extraction, categories, the INDEX catalog
|
|
- [building.md](building.md) — dependencies, building, config and save paths
|
|
- [upstream-patches.md](upstream-patches.md) — every local diff against the vendored engine
|
|
|
|
## Status
|
|
|
|
Playable end to end: title/menu, hangar, store, ship computer, all mission
|
|
phases, original OPL2 soundtrack and Sound Blaster SFX through PipeWire/ALSA.
|
|
Verified on this machine at 1920x1080.
|
|
|
|
## Legal
|
|
|
|
- `raptor/` is GPLv2+; this project inherits GPL for everything built on it.
|
|
- Game data is copyrighted. `data/` is derived from the user's own purchased
|
|
copy and is never committed.
|