Crimsonland documentation¶

A from-scratch rewrite of Crimsonland (2003), aiming for full parity with the original Windows executable. These docs cover the game's mechanics, the rewrite implementation, and the reverse engineering work that ties them together.

Blog post • Source code

Play now¶

Install uv, then:

uvx crimsonland@latest

Highlights¶

• Perks: all 58 perks with exact numbers, interaction rules, and original bug notes verified against two builds of the binary.

• Fire Bullets (1.9.8 vs 1.9.93): how fire bullets changed from an additive bonus (1.9.8) to a full weapon replacement (1.9.93), with per-weapon DPS showing most weapons lost 80-95% of their output.

Sections¶

• Mechanics: how the game actually plays. Behavior specs, reference tables, and game rules written without decompiler details.
• Rewrite: the Python port. Architecture, module map, debug views, and parity status.
• Reverse engineering: static analysis, runtime probes, struct layouts, and file formats extracted from the original binary.
• Verification: differential testing, evidence ledger, and parity matrices that connect claims to proof.
• Contributor: setup, workflows, and project tracking.