A complete decompilation of Retro Engine v3.
SUPPORT THE OFFICIAL RELEASE OF SONIC CD
-
Without assets from the official release, this decompilation will not run.
-
You can get an official release of Sonic CD from:
- Windows
- Via Steam, whether it's the original release or from Sonic Origins
- Via the Epic Games Store, from Sonic Origins
- iOS (Via the App Store)
- A tutorial for finding the game assets from the iOS version can be found here.
- Android
- Via Google Play
- Via Amazon
- A tutorial for finding the game assets from the Android version can be found here.
- Windows
Even if your platform isn't supported by the official releases, you must buy or officially download it for the assets (you don't need to run the official release, you just need the game assets). Note that only FMV files from the original Steam release of the game are supported; mobile and Origins video files do not work.
Advantages over the PC version of Sonic CD
- Sharp, pixel-perfect display.
- Controls are completely remappable via the settings.ini file.
- The window allows windows shortcuts to be used.
- Complete support for using mobile/updated scripts, allowing for features the official PC version never got to be played on PC.
- Native Windows x64 version, as well as an x86 version.
Advantages over the Mobile versions of Sonic CD
- The rendering backend is based off the PC version by default, so palettes are fully supported (Tidal Tempest water in particular).
Additional Tweaks
- Added a built in mod loader and API, allowing to easily create and play mods with features such as save file redirection and XML GameConfig data.
- There is now a settings.ini file that the game uses to load all settings, similar to Sonic Mania.
- The dev menu can now be accessed from anywhere by pressing the
ESC
key if enabled in the config. - The
F12
pause,F11
step over & fast forward debug features from Sonic Mania have all been ported and are enabled ifdevMenu
is enabled in the config. - A number of additional dev menu debug features have been added:
F1
will load the first scene in the Presentation stage list (usually the title screen).F2
andF3
will load the previous and next scene in the current stage list.F5
will reload the current scene, as well as all assets and scripts.F8
andF9
will visualize touch screen and object hitboxes.F10
will activate a palette overlay that shows the game's 8 internal palettes in real time.
- If
useSteamDir
is set in the config (Windows only), the game will try to load savedata from Steam'suserdata
directory (where the original Steam version saves to). - Added the idle screen dimming feature from Sonic Mania Plus, as well as allowing the user to disable it or set how long it takes for the screen to dim.
How to build
Windows
- Clone the repo, then follow the instructions in the dependencies readme for Windows to setup dependencies, then build via the visual studio solution.
- Alternatively, you can grab a prebuilt executable from the releases section.
Windows via MSYS2 (64-bit only)
- Download the newest version of the MSYS2 installer from here and install it.
- Run the MINGW64 prompt (from the windows Start Menu/MSYS2 64-bit/MSYS2 MinGW 64-bit), when the program starts enter
pacman -Syuu
in the prompt and hit Enter. - Press
Y
when it asks if you want to update packages. If it asks you to close the prompt, do so, then restart it and run the same command again. This updates the packages to their latest versions. - Install the dependencies with the following command:
pacman -S pkg-config make git mingw-w64-x86_64-gcc mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libogg mingw-w64-x86_64-libvorbis mingw-w64-x86_64-libtheora mingw-w64-x86_64-glew
- Clone the repo with the following command:
git clone --recursive https://github.com/Rubberduckycooly/Sonic-CD-11-Decompilation.git
- Go into the repo you just cloned with
cd Sonic-CD-11-Decompilation
. - Run
make -f Makefile.msys2 CXXFLAGS=-O2 CXX=x86_64-w64-mingw32-g++ STATIC=1 -j5
.- The
CXXFLAGS
option can be removed if you do not want optimizations. - -j switch is optional, but will make building faster by running it parallel on multiple cores (8 cores would be -j9).
- The
Windows UWP (Phone, Xbox, etc.)
- Clone the repo, then follow the instructions in the dependencies readme for Windows and dependencies readme for UWP to setup dependencies.
- Copy your
Data.rsdk
file andvideos
folder intoRSDKv3UWP
, then build and deploy viaRSDKv3.UWP.sln
. - You may also need to generate visual assets, to do so, open the Package.appxmanifest file in the designer, under the Visual Assets tab, select an image of your choice and click generate.
Mac
- Clone the repo, follow the instructions in the dependencies readme for Mac to setup dependencies, then build via the Xcode project.
- A Mac build by Sappharad can be found here.
Linux
- To setup your build enviroment and library dependecies, run the following commands:
- Ubuntu (Mint, Pop!_OS, etc...):
sudo apt install build-essential git libsdl2-dev libvorbis-dev libogg-dev libtheora-dev libglew-dev
- If you're using Debian, add
libgbm-dev
andlibdrm-dev
.
- If you're using Debian, add
- Fedora Linux:
sudo dnf install g++ SDL2-devel libvorbis-devel libogg-devel libtheora-devel glew-devel
- Arch Linux:
sudo pacman -S base-devel git sdl2 libvorbis libogg libtheora glew
- Ubuntu (Mint, Pop!_OS, etc...):
- Clone the repo with the following command:
git clone --recursive https://github.com/Rubberduckycooly/Sonic-CD-11-Decompilation.git
- Go into the repo you just cloned with
cd Sonic-CD-11-Decompilation
. - Run
make CXXFLAGS=-O2 -j5
.- If your distro is using gcc 8.x.x, then add the argument
LIBS=-lstdc++fs
. - The
CXXFLAGS
option can be removed if you do not want optimizations. - -j switch is optional, but will make building faster by running it parallel on multiple cores (8 cores would be -j9).
- If your distro is using gcc 8.x.x, then add the argument
iOS
- Clone the repo, follow the instructions in the dependencies readme for iOS to setup dependencies, then build via the Xcode project.
Android
- Clone the repo, then follow the instructions in the dependencies readme for Android.
- Ensure the symbolic links in
android/app/jni
are correct. If not, fix them with the following on Windows:mklink /D src ..\..\..
mklink /D SDL ..\..\..\dependencies\android\SDL
- Open
android/
in Android Studio, install the NDK and everything else that it asks for, and build.
PlayStation Vita
- Ensure you have Docker installed and run the script
build.sh
fromRSDKv3.vita
. If you are on Windows, WSL2 is recommended.- NOTE: You would need to copy Sonic CD game data into
ux0:data/RSDKv3
to boot the game.
- NOTE: You would need to copy Sonic CD game data into
Unofficial Branches
Follow the installation instructions in the readme of each branch.
- For the Nintendo Switch, go to heyjoeway's fork.
- For the Nintendo 3DS, go to SaturnSH2x2's fork.
- A New Nintendo 3DS is required for the game to run smoothly.
Because these branches are unofficial, we can't provide support for them and they may not be up-to-date.
Other Platforms
Currently the only supported platforms are the ones listed above, however the backend uses libogg, libvorbis, libtheora & SDL2 to power it (as well as tinyxml2 for the mod API), so the codebase is very multiplatform. If you're able to, you can clone this repo and port it to a platform not on the list.
FAQ
You can find the FAQ here.
Special Thanks
- Xeeynamo: for creating the RSDK Animation editor & an early version of the script unpacker, both of which got me into RSDK modding.
- Sappharad: for making a decompilation of the Windows Phone 7 version of Sonic CD (found here) which gave me the idea & motivation to decompile the PC/iOS/Android versions.
- SuperSonic16: for creating & adding some stuff to the Sonic CD mod loader that I asked for.
- The Weigman for creating the header you see up here along with similar assets.
- Everyone in the Retro Engine Modding Server for being supportive of me and for giving me a place to show off these things that I've found.
Contact:
Join the Retro Engine Modding Discord Server for any extra questions you may need to know about the decompilation or modding it.