Skip to content

0.2.0 - the recompiled build

Choose a tag to compare

View all tags
@YuutaTsubasa YuutaTsubasa released this 24 Sep 04:04
· 30 commits to main since this release
v0.2.0
03bcf0c

The recompiled build, which is what this project is for. v0.1.0 shipped the
interpreter; these downloads run the game's code translated ahead of time into
native code for your machine.

You still need your own ROM

These downloads are not the game. They contain the game's code,
statically recompiled, and none of its data — no graphics, no music, no
level data, no ROM image. Start one without a ROM and it stops at the setup
screen.

You supply your own, legally obtained copy of Knuckles' Chaotix (Japan, USA)
for the Sega 32X, SHA-1 0c2fff7bc79ed26507c08ac47464c3af19f7ced7, which the
setup screen verifies before installing it.

This follows what other static recompilation projects do — Unleashed
Recompiled and Zelda 64:
Recompiled ship the
recompiled code and require each user to bring their own copy of the game.
That position is not settled law, and
LEGAL.md
says so plainly rather than claiming otherwise. Read it before mirroring these
files anywhere.

Downloads

File Notes
ChaotixRecompiled-0.2.0-windows-x64.zip Windows 10/11 x64. Unzip anywhere and run ChaotixRecompiled.exe.
ChaotixRecompiled-0.2.0-android.apk Android 8.0+ (arm64-v8a and x86_64). Signed with the standard Android debug key, so your device will warn about an unknown source. Copy your ROM to Android/data/org.chaotixrecompiled/files/, or use Browse on the setup page.

Built from the v0.2.0 tag on a local machine, because the build needs a ROM
and CI has none.

What works

  • Boots to the title screen; menus, character select and the stage-select hall
  • Levels are playable, with sound (Z80 driver, YM2612, PSG, PWM)
  • True widescreen in levels: the game's own renderer is extended to draw
    real tiles, objects and sprites in the extra area rather than stretching a
    4:3 image. Anything from 1.24:1 (320×240) to 2:1 (480×224) is filled, and
    the centre 320 pixels stay bit-identical to the unmodified game — checked by
    a test.
  • First-run setup that verifies your ROM by SHA-1 and installs it once
  • 13 local achievements (no account, nothing downloaded); F7, left stick
    click on a gamepad, or the counter in the corner on a touch screen
  • Windows, Linux, macOS, Android; gamepad, keyboard and touch

How it is validated

The recompiled code and the reference interpreter run in lockstep and must
agree exactly — every register, memory write and cycle count. The suite
includes two 36,000-frame lockstep runs and golden frame hashes for 4:3,
widescreen and 16:9. Where a translation would be unsafe, the runtime falls
back to the interpreter rather than guessing.

Known gaps

  • Linux and macOS build in CI but have not been run on real hardware by the
    author, so there are no downloads for them yet
  • iOS is configured but not yet built
  • The Android APK is debug-signed; a properly signed release build needs a
    keystore, and the build now accepts one
  • The level timer is not yet decoded, so there are no time-based achievements
Assets 4
Loading