DARK
PAWNS

A Multi-User DungeonEST. 1994

Documentation » Research

For: researcher

Port Fidelity Workflow

Use the C oracle, deterministic seams, and five governing rules to prove behavioral parity.

Dark Pawns is a faithful port, not a reinterpretation. The original reachable C path decides game behavior; differential scenarios prove the Go server against it.

The five rules

The full Port Rulebook defines:

  • R1: player-facing bytes are law.
  • R2: command names, aliases, gates, and positions are part of the game.
  • R3: random draw counts, time, and operation order must match.
  • R4: do not invent player-observable behavior.
  • R5: verify the reachable call path, prove fixes, and audit repeated failure classes.

Set up the oracle

The complete workstation procedure is maintained in docs/DEV-SETUP.md. It builds the separate read-only C oracle and points DP_ORACLE_BIN at its executable.

Run a scenario

DP_ORACLE_BIN=/path/to/darkpawns-c-oracle/bin/circle \
DP_SEED=1 DP_FRESH_MUD=1 \
go run ./cmd/dp-oracle-diff --scenario mortal-batch14

Read the reported result: line; the harness may exit successfully even when it reports a divergence. Random outcomes require validation of underlying rolls or multiple samples, not a single coincidentally matching result.

Preserve the authority boundary

Never edit src/ or the oracle to make Go pass. A confirmed repeated pattern changes the rulebook and triggers a class-wide audit. A suspected mismatch is not confirmed until its real call path is shown to be reachable.