Project Lucid

An in-progress reconstruction of Sonic Dream Team for macOS, Windows, and Linux. You must supply your own macOS game bundle. Game assets are not included.

Current status: extraction tooling has been exercised with release 1.10.1. The original game is not yet playable from this project.

Getting started

Install Python 3.9 or newer and Unity 2022.3.54f1. Place SonicDreamTeam.app inside input/, then run these commands from the project folder:

python3 tools/lucid.py doctor
python3 tools/lucid.py inspect --input input/SonicDreamTeam.app
python3 tools/lucid.py bootstrap
python3 tools/lucid.py recover-code --input input/SonicDreamTeam.app
python3 tools/lucid.py native-schema --input input/SonicDreamTeam.app
python3 tools/lucid.py extract-assets --input input/SonicDreamTeam.app
python3 tools/lucid.py prepare

The tools keep your supplied bundle unchanged. Downloads and generated files are stored locally and are not part of the repository.

Use Unity 2022.3.54f1 to open this project. Follow the current setup and recovery guide for prerequisites and troubleshooting.

Building

Once reconstruction validation passes:

python3 tools/lucid.py validate
python3 tools/lucid.py build --target macos

Use windows or linux for the other desktop targets. Builds are written to Builds/. Building is blocked while required game behavior remains unresolved.

For development only, python3 tools/lucid.py build --target macos --development skips the audit and test gates and writes a labelled, non-release player to Builds/Development/<target>/ with a DEVELOPMENT-BUILD.txt marker. It checks the input, prepared project and asset identity like a release build, and port and release validation never accept it. Never publish it.

The intended game runs offline with local saves, achievements, and personal records. Original cloud saves and global rankings are not included.

Progress

19,532 of 27,467 original methods have maintained source implementations (71.11%).

Assembly	Methods with source	Original methods	Progress
Assembly-CSharp (game code)	16	21	76.19%
Assembly-CSharp-firstpass (studio code)	8	12	66.67%
Dreamteck.Splines	1,171	1,260	92.94%
Dreamteck.Utilities	103	108	95.37%
Game.Runtime	10,828	15,624	69.30%
HLAnalytics.Runtime	74	102	72.55%
HLAppleInput.Runtime	111	145	76.55%
HLAutoGenerated	359	638	56.27%
HLAutoPlay.Runtime	6	18	33.33%
HLBinders.Runtime	317	382	82.98%
HLCrashReport.Runtime	51	70	72.86%
HLCrossPromo.Runtime	151	235	64.26%
HLEventSystems.Runtime	16	16	100.00%
HLHaptics.Runtime	10	24	41.67%
HLInput.Runtime	422	575	73.39%
HLLocalisation.Runtime	81	136	59.56%
HLModernUI.Runtime	356	475	74.95%
HLNetworking.Runtime	26	36	72.22%
HLNotifications.Runtime	20	32	62.50%
HLPhysics.Runtime	17	24	70.83%
HLRTLTextMeshPro.Runtime	102	109	93.58%
HLSplines.Runtime	1,101	1,299	84.76%
HLUnityCore.Runtime	2,782	4,200	66.24%
HLUnityUI.Runtime	1,238	1,724	71.81%
com.olegknyazev.softmask	166	202	82.18%
Total	19,532	27,467	71.11%

Generated from original method signatures and compiled source. Counts are conservative: ambiguous signatures and recognized trivial or placeholder patterns are excluded, including some genuine trivial methods. These counts cover methods with original native bodies; the game is not yet playable.