mrp3gi/README.md
m3ultra a1f7d8d396 MRP3GI spec v1.0 — 3D presentation, 2D brain
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-25 23:47:55 +10:00

36 lines
1.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# MRP3GI — Monster Robot Party 3D Game Interpreter
The **third generation** of the Monster Robot Party engine family:
| Engine | Sierra analog | The trick |
|---|---|---|
| [MRPGI](https://github.com/) (`~/Documents/mrpgi`) | AGI (1984) | 16-color vector rooms, text parser |
| [MRPCI](https://github.com/) (`~/Documents/mrpci`) | SCI0/SCI1 (198892) | 256-color palettes, point-and-click, rhai scripts |
| **MRP3GI** (this repo) | SCI32 / Phantasmagoria-era (1995+) | **3D presentation, 2D brain** |
One sentence: **the MRPCI story engine, compiled to WASM, drives rigged GLB
characters in a three.js scene** — Grim-Fandango-style: the sim stays a
deterministic 2D adventure engine; the camera, sets, lighting and Mixamo
animation are presentation.
Read [SPEC.md](SPEC.md) for the full architecture and the milestone plan.
Nothing in this repo reimplements game rules: if it decides whether a door
opens, it lives in `mrpci-core`. If it decides what a door looks like, it
lives here.
## Prerequisites
- `mrpci` checked out as a **sibling directory** (`../mrpci`) — the bridge
crate uses a path dependency
- Rust (stable) + `wasm-pack`; Node 20+ + npm
- The demo game: `cd ../mrpci && cargo run -p mrpci-core --bin mrpci-headless -- --sample`
## Quick start (once M2 lands)
```sh
npm install
npm run bridge # wasm-pack build of the Rust story core
npm run dev # vite dev server → play Neon Precinct in 3D
npm test # incl. the golden determinism replay vs native
```