Skip to main content

Crimsonland

A faithful reimplementation of Crimsonland 1.9.93 (2003, GOG "Crimsonland Classic") in Python and raylib. Survival, Rush, all five quest tiers, Tutorial, Typ-o-Shooter, local co-op and the secrets are here, and they play like the original down to its timings, random rolls and rounding.

The original game assets are distributed with permission from 10tons, and the game downloads them on first launch.

Play

Install uv, then:

uvx crimsonland@latest

Or install it with uv tool install crimsonland and run crimson, as in the examples below.

Python 3.13 or newer runs on Windows, macOS and Linux. On Linux the game runs natively on Wayland, but still needs libX11 installed.

Better than the original

The port plays like the 2003 game, and adds what a modern release needs:

  • Runs anywhere. Windows, macOS and Linux (Wayland included) instead of Direct3D 8 on Windows, at any resolution, with borderless fullscreen that keeps the aspect ratio.
  • Modern controllers. PlayStation, Xbox and Switch Pro controllers are recognized on connect and switch a player to twin-stick controls, with reload on the shoulder like the 2014 remake. Every menu, list and slider works from the controller, with the focus always visible, and each co-op player can use their own controller.
  • Original bugs fixed, and kept on request. The original's gameplay bugs are fixed by default, each traced to the decompiled code: Greater Regeneration did nothing, Bandage multiplied health instead of healing, some bonuses never dropped while you held certain weapons, and several co-op perks only worked for player 1. --preserve-bugs restores every one of them, exactly as the original behaves. The original's text stays as written, typos like "Fire Caugh" and "Plague Sphreader Gun" included.
  • Replays. Every run is recorded and can be played back, verified tick by tick, or rendered to 60 fps video.
  • Sharper art. The original shipped its textures as JPEG-compressed JAZ files. The game uses the uncompressed source art from 10tons instead, free of JPEG artifacts, wherever it matches what shipped.

Controls

Player 1 starts on the original's mouse and keyboard controls: WASD to move, the mouse to aim and fire. Everything is rebindable in Options → Controls.

Connect a PlayStation, Xbox or Switch Pro controller, then press any button on it to switch that player to twin-stick controls:

Control Action
Left stick move
Right stick aim
R2 / RT fire
L1 / LB reload
Triangle / Y pick a perk
Start pause
D-pad, Cross / A, Circle / B menus

In local co-op, player 2 uses the second controller, and so on. Menus work with the keyboard too: Tab and Shift+Tab move, Enter picks, Escape goes back.

Key Action
F1 pause and show the key help
F12 save a screenshot
Alt+Enter toggle fullscreen
Alt+Q quit
` (backtick) console

Options

crimson --width 1280 --height 960   # game resolution (1024x768 is native)
crimson --fullscreen                # or --windowed; both are saved
crimson --seed 1234                 # a deterministic run
crimson --preserve-bugs             # keep the original's known bugs

Saves, settings, high scores and replays go to your per-user data directory. Set CRIMSON_RUNTIME_DIR or pass --base-dir to keep them elsewhere.

Replays

Every run is recorded. A replay can be played back, rendered to video, or re-simulated to verify its score:

crimson replay list
crimson replay play <file>
crimson replay verify <file>
crimson replay render <file>    # needs ffmpeg

Leaderboard

Tick Ranked in the Play Game menu to play Survival or a quest for crimson.land. The server replays every run before its score counts, and the game uploads finished runs by itself, so playing offline is fine. There is no sign-up: the game makes a key on its first launch, and the identity commands manage it:

crimson identity show             # your key and the fingerprint the boards show
crimson identity export <file>    # copy your key, to play as you on another machine
crimson identity import <file>    # sign as an exported key (--replace overwrites this one)
crimson identity profile          # open your profile on crimson.land, signed in

Custom quests

Write a quest in the quest language, play it, and publish it with a completed ranked run to give it a page and leaderboard on crimson.land/custom:

crimson quest build <file>      # check a recipe and print its digest and entry budget
crimson quest play <file>       # play it; every attempt saves a replay
crimson quest publish <file>    # upload it with your newest clear

crimson.land/custom/llm.txt is the whole language in one file, for writing quests with an LLM.

Tools

crimson quests <level>          # print a stock quest's spawn script
crimson extract <game> <dst>    # extract the game's PAQ archives, with JAZ textures as PNG

More

  • Changelog
  • How it was made: reverse engineering, asset formats and AI-assisted decompilation
  • Docs: game mechanics, perks, weapons and file formats
  • Source: the port, plus a matching decompilation of the original
  • Telegram group: chat, bug reports and runs

This is an independent preservation and research project. The original Crimsonland Classic assets are distributed with permission from 10tons; the game code and the reimplementation are independent.

Metadata

Release files for crimsonland 0.19.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crimsonland 0.19.1
File Size Uploaded
crimsonland-0.19.1.tar.gz 567.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for crimsonland 0.19.1
File Interpreter ABI Platform
crimsonland-0.19.1-py3-none-any.whl Python 3 none any Details

Total release size: 1.2 MB

Release files / crimsonland-0.19.1.tar.gz

Download URL crimsonland-0.19.1.tar.gz
Size 567.2 kB
Tags Source
SHA-256 checksum
How to use checksums
68efaac5718d68abe287100aa37a1577e9cbe572092dad42cc71550989565e26
BLAKE2b-256 checksum
How to use checksums
b933a1bb34c5b4dd6b323ffb31e0d6c745f6f263b368165c55611713c2963586
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release files / crimsonland-0.19.1-py3-none-any.whl

Download URL crimsonland-0.19.1-py3-none-any.whl
Size 664.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f64083adb94970a3493301c44ff3d67181aca3c69d3f485692029c991277c373
BLAKE2b-256 checksum
How to use checksums
1f94d38d1984e3e92fd880cdec7fde5449e31c957b0bf54de912a284694c6581
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release history Release notifications | RSS feed

0.19.2

2 release files

This release

0.19.1 This release

2 release files

0.19.0

2 release files

0.18.0

2 release files

0.17.4

2 release files

0.17.3

2 release files

0.17.2

2 release files

0.17.1

2 release files

0.17.0

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.15.2

2 release files

0.15.1

2 release files

0.15.0

2 release files

0.14.6

2 release files

0.14.5

2 release files

0.14.4

2 release files

0.14.3

2 release files

0.10.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page