alex/sots-engine
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
From-scratch reimplementation of the Sword of the Stars (2006) engine. Clean-room; engine code only — bring your own game copy. Planning/RE evidence live in sots-re.
3 commits 1 branch 0 tags 11 MiB
Find a file
alex 0170f5e7ff mars/text: flat-kv, id-manifest, csv readers; oracle-verified 64/64
2026-09-07 17:25:34 -04:00
docs mars/text: flat-kv, id-manifest, csv readers; oracle-verified 64/64 2026-09-07 17:25:34 -04:00
include/generated generated address header from sots-re (25 entries) 2026-09-07 17:09:15 -04:00
src/mars/text mars/text: flat-kv, id-manifest, csv readers; oracle-verified 64/64 2026-09-07 17:25:34 -04:00
tests/mars_text mars/text: flat-kv, id-manifest, csv readers; oracle-verified 64/64 2026-09-07 17:25:34 -04:00
tools init commit 2026-09-07 17:07:54 -04:00
.gitignore init commit 2026-09-07 17:07:54 -04:00
CONTRIBUTING.md init commit 2026-09-07 17:07:54 -04:00
LICENSE init commit 2026-09-07 17:07:54 -04:00
README.md init commit 2026-09-07 17:07:54 -04:00

README.md

sots-engine

A from-scratch, functional reimplementation of the engine behind Sword of the Stars (2006). Not a byte-for-byte decompilation: behavior-equivalent code, built up one verified piece at a time (OpenRCT2-style) until the tree can build the whole application on its own.

Bring your own game. This repository contains engine code only. Game data, assets, saves, and the original binaries are never included; tests and tools read an owner-supplied copy via $SOTS_DATA_DIR. See CONTRIBUTING.md for the clean-room rules.

Status

Phase 2 / M0 — the shim frontend (src/shim/): a proxy DLL the original game loads, used to verify each reimplemented function against the original before it displaces it. Engine code accrues under src/mars/ (engine) and src/game/ (game logic) as milestones land.

Layout (grows with the work)

  • src/shim/ — binkw32 proxy + hooks + old-vs-new compare harness (frontend #1)
  • src/mars/, src/game/ — the engine and game reimplementation (accruing)
  • include/generated/sots_addresses.h — binary facts (RVAs/prototypes), generated from the RE repo
  • tests/ — host tests; real-data tests skip unless $SOTS_DATA_DIR is set
  • tools/ — build (MinGW i686 cross) and deploy scripts

Planning, findings, and verification evidence are tracked in the private RE repo (sots-re).