Reincarnate

Legacy software lifting framework.

Part of the rhi.zone ecosystem.

Overview

Reincarnate extracts and transforms applications from obsolete runtimes into modern web-based equivalents. It works on bytecode and script-based software — not native binaries.

Supported Targets

Category	Targets	Format
Interactive Media	Flash, Director/Shockwave, Authorware	ABC bytecode, Lingo
Enterprise	Visual Basic 6, Silverlight, Java Applets	P-Code, .NET IL, JVM bytecode
No-Code Ancestors	HyperCard, ToolBook	Stack formats
Game Engines	RPG Maker, Ren'Py, GameMaker	Script/bytecode
Interactive Fiction	Twine (SugarCube, Harlowe)	HTML + script

Approach

Tier 1 (Native Patching): For binaries you can't fully lift — pointer relocation, font replacement, hex editing.

Tier 2 (Runtime Replacement): For engines you can shim — extract bytecode/script, decompile to IR, transform, and emit modern TypeScript with a replacement runtime.

Architecture

The pipeline: Frontend (extract + decompile) → IR (SSA-like, block arguments) → Transform passes → Backend (emit TypeScript).

Crates

Crate	Description
reincarnate-core	Core IR, entity arenas, system traits, transform pipeline
reincarnate-cli	CLI binary
reincarnate-frontend-flash	Flash/SWF frontend (ABC bytecode)
reincarnate-frontend-gamemaker	GameMaker frontend (GMS1/GMS2 data.win)
reincarnate-frontend-twine	Twine frontend (SugarCube + Harlowe)
reincarnate-backend-typescript	TypeScript code emitter
datawin	GameMaker data.win format parser

Runtimes

Each engine has a TypeScript runtime in runtime/<engine>/ts/ that provides engine-specific API shims on top of a swappable platform layer:

• runtime/flash/ts/ — Flash display list, events, timeline
• runtime/gamemaker/ts/ — GameMaker instances, rooms, drawing
• runtime/twine/ts/ — Twine SugarCube + Harlowe engines

Usage

# Full pipeline: extract → IR → transform → emit TypeScript
cargo run -p reincarnate-cli -- emit --manifest path/to/reincarnate.json

# Print human-readable IR (for debugging)
cargo run -p reincarnate-cli -- print-ir <ir-json-file>

# Extract IR only (no transforms/emit)
cargo run -p reincarnate-cli -- extract --manifest path/to/reincarnate.json

# Show project manifest info
cargo run -p reincarnate-cli -- info --manifest path/to/reincarnate.json

The --manifest flag defaults to reincarnate.json in the current directory. Use --skip-pass to disable specific transform passes.

Building

cargo build
cargo clippy --all-targets --all-features -- -D warnings && cargo test

License

MIT