# Robinson's Requiem (DOS, PC CD) — the original ALIS VM, decompiled
Goal of this folder: compare, handler by handler, the ORIGINAL virtual machine of the game (the DOS executable) with
the PHP port's implementation, and report what is missing or behaves differently.
## The binary
- Original executable: `/home/david/Bureau/old/robinson/iso_src/START.EXE` (DOS extender by Doug Huffman + a second
MZ program that holds the game). The game's 32-bit code and data are one flat image.
- Extracted image (load it at address 0): `rrq_dos32.bin` in this folder (= START.EXE bytes from offset
1319 + 160 + 0x4290). An address A in the image is byte A of `rrq_dos32.bin`.
- Disassemble a handler: `ndisasm -b 32 -o 0xADDR -e 0xADDR rrq_dos32.bin | head -80` (code is hand-written
assembly: handlers share code, fall through and jump into each other; follow the jumps/calls you need).
- Ghidra decompilation of every table entry (C-like): `out/opcodes.c`, `out/esc1.c`, `out/opernames.c`,
`out/tab189ae.c`, `out/tab18a26.c` (each entry starts with `// =====
[i] (0xii) -> 0xADDR =====`).
Ghidra project (headless) in `proj/`; script `scripts/ExportTables.java`.
## The VM (as found in the binary)
- Main loop at 0x7b73: `sub eax,eax; lodsb; call [eax*4+0x18432]; jmp 0x7b73` — ESI = script program counter.
- Opcode table: 0x18432, 256 dword entries (index = opcode byte).
- cesc1 (opcode 0x01) does `lodsb; jmp [eax*4+0x18832]`: escape table 0x18832 (7 entries).
- Expression elements ("opernames"): dispatched by `lodsb; jmp [eax*2+0x1884e]` (0x9d30): the operand codes are
EVEN, entry = code/2, table at 0x1884e.
- Two more tables of 27 entries at 0x189ae and 0x18a26: most likely the store targets ("storenames") and the
add targets ("addnames") — check which is which from the code that dispatches to them (search the image for
`ff 24 45` / `ff 14 45` / `ff 24 85` with those addresses, or look at cstore (opcode 0x1e, 0x3bb9) and cadd).
- Interesting globals seen so far: [0x16008] / [0x1600c] (expression string buffers?), [0x16006], [0x15fcb], ES:EBP
= the current script's variables (negative offsets = locals, like the port's vb/vw at -offset).
- Robinson's Requiem is ALIS version 31 (v3), little endian (DOS).
## The port (what to compare with)
- PHP port: `/home/david/Projets/JumPHPGames/alis/games/alis/src/Alis/` — functions in `fn/*.php` (opcodes in
`fn/opcodes*.php`, `fn/opernames.php`, `fn/storenames.php`, `fn/addnames.php`, `fn/escnames.php`, images in
`fn/image*.php`, 3D in `fn/rrq3d*.php`, sound `fn/audio*.php` …), dispatch tables built in `fn/alis.php`
(`set_dispatch_tables`, `alis_tab_opcodes()`, `table_opcodes()`, …) and `Tables.php`.
Opcode names and operand kinds: `Lang/Grammar.php` (OPCODES, ESC1).
- The C reimplementation the port was translated from: `/home/david/programs/alis/alis/src/` (opcodes.c,
opernames.c, storenames.c, addnames.c, escnames.c, image.c, …). Its descriptions (`DECL_OPCODE(...)` in
opcodes.c) mark unimplemented ones `[N/I]`.
- What the game really uses: the decompiled scripts of Robinson's Requiem,
`/home/david/Projets/JumPHPGames/alis/.alis-data/robinson/src/*.als` (canonical form: `docs/language.md` of the
game; a statement is the opcode name without its leading `c`, e.g. `putnat` = `cputnat`). Grep them to know if
an opcode / expression element / store target is used, and how often.
## Rules for the audit
- READ ONLY: do not modify any file of the port or of this folder (write nothing outside your own reasoning).
- For each entry: find the original handler, understand what it does (operands read from the script, globals
changed, calls), find the port's function for the same index, compare. Report precisely: what the original does
that the port does not (or does differently), with the original's addresses and the port's file:line.
- "Same behaviour" means same operands consumed (the script stays in sync), same effects on VM state / memory /
screen / sound, same results in edge cases (signedness, 8/16/32-bit wrap, clipping).
- Platform-only things (DOS sound card, VGA ports, timer interrupts) need not match byte for byte: report them as
"platform" if the port does the equivalent through its host layer.