rrt/README.md

Analysis and reimplementation of Railroad Tycoon 3.

Overview

This repository supports two parallel tracks:

• reverse-engineering the 1.06 executable into durable atlases, exports, and capture notes
• building a headless Rust runtime that can rehost deterministic world work outside the shell

The canonical executable target is rt3_wineprefix/drive_c/rt3/RT3.exe.

Workspace

• crates/rrt-model: shared schema, finance logic, and project-level constants
• crates/rrt-runtime: headless runtime state, importers, inspectors, stepping, and summaries
• crates/rrt-fixtures: fixture loading, normalization, validation, and diff helpers
• crates/rrt-cli: validation, runtime inspection, export, and comparison commands
• crates/rrt-hook: PE32 hook scaffold for capture and integration experiments
• docs/: stable handbook material, atlases, plans, and active queues
• artifacts/exports/: committed derived research outputs
• artifacts/captures/: committed raw logs, sample binaries, and retained capture evidence
• fixtures/runtime/: checked-in runtime fixtures

Common Commands

• cargo test --workspace
• cargo run -p rrt-cli -- validate .
• cargo run -p rrt-cli -- runtime summarize-fixture fixtures/runtime/minimal-world-step-smoke.json
• cargo run -p rrt-cli -- runtime inspect-smp <save.gms>
• tools/run_hook_smoke_test.sh

Docs

• Handbook
• Runtime Rehost Plan
• Active Rehost Queue
• Progress History
• Control-Loop Atlas Index
• Subsystem Views
• 1.06 Export Index
• Capture Index

Notes

• artifacts/tmp/ is scratch-only and should stay untracked.
• Canonical checked-in captures belong under artifacts/captures/.
• Detailed running status belongs in the docs and artifact indexes above, not in this root README.