-
Without assets from the official releases, this decompilation will not run.
-
For tutorials on how to find the game assets from your legally obtained copy of the game(s), see this tutorial for Android or this tutorial for iOS.
-
You can get the official releases of Sonic 1 & Sonic 2 from:
- Sonic 1 (iOS, Via the App Store)
- Sonic 2 (iOS, Via the App Store)
- Sonic 1 (Android, Via Google Play)
- Sonic 2 (Android, Via Google Play)
- Sonic 1 (Android, Via Amazon)
- Sonic 2 (Android, Via Amazon)
- A tutorial for finding the game assets from the Android versions can be found here.
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).
If you want to transfer your save(s) from the official mobile version(s), the Android pre-forever file path is Android/data/com.sega.sonic1 or 2/SGame.bin
(other versions may have different file paths). Copy that file into the decompilation's folder with the name SData.bin
.
- Added a built in script compiler. Similar to the one found in RSDKv3, but tweaked up to match the new syntax for the scripts used in RSDKv4.
- Added a built in mod loader and API, allowing to easily create and play mods with features such as save file redirection, custom achievements and XML GameConfig data.
- Custom menu and networking system for Sonic 2 multiplayer, allowing anyone to host and join servers and play 2P VS.
- 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.
- 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.
- Clone the repo, then follow the instructions in the depencencies readme for Windows to setup dependencies, then build via the visual studio solution.
- Alternatively, you can grab a prebuilt executable from the releases section.
- 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-i686-gcc mingw-w64-x86_64-gcc mingw-w64-x86_64-SDL2 mingw-w64-x86_64-libogg mingw-w64-x86_64-libvorbis mingw-w64-x86_64-glew
- Clone the repo with the following command:
git clone --recursive https://github.com/Rubberduckycooly/Sonic-1-2-2013-Decompilation.git
- Go into the repo you just cloned with
cd Sonic-1-2-2013-Decompilation
. - Run
make -f Makefile.msys2 CXX=x86_64-w64-mingw32-g++ CXXFLAGS=-static -j4
.- -j switch is optional, but will make building faster by running it parallel on multiple cores (8 cores would be -j9).
- Clone the repo, then follow the instructions in the depencencies readme for Windows and depencencies readme for UWP to setup dependencies.
- Copy your
Data.rsdk
file intoSonic1Decomp.UWP
orSonic2Decomp.UWP
depending on the game, then build and deploy viaRSDKv4.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.
- 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 libglew-dev libdecor-0-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 glew-devel
- Arch Linux:
sudo pacman -S base-devel git sdl2 libvorbis libogg glew
- Ubuntu (Mint, Pop!_OS, etc...):
- Clone the repo and its other dependencies with the following command:
git clone --recursive https://github.com/Rubberduckycooly/Sonic-1-2-2013-Decompilation.git
- Go into the repo you just cloned with
cd Sonic-1-2-2013-Decompilation
. - Run
make -j5
.- If your distro is using gcc 8.x.x, then add the argument
LIBS=-lstdc++fs
. - -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
- Clone the repo, follow the instructions in the depencencies readme for Mac to setup dependencies, then build via the Xcode project.
- A Mac build of v1.3.0 by Sappharad can be found here.
- Clone the repo, then follow the instructions in the depencencies 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.
Follow the installation instructions in the readme of each branch.
- For the PlayStation Vita, go to Xeeynamo's fork.
- For the Nintendo Switch, go to heyjoeway's fork.
- For the Nintendo 3DS, go to JeffRuLz's fork.
- A New Nintendo 3DS is required for the games to run smoothly.
- To play it on the web using Wasm, go to mattConn's fork.
Because these branches are unofficial, we can't provide support for them and they may not be up-to-date.
Currently the only supported platforms are the ones listed above, however the backend uses libogg, libvorbis & SDL2 to power it (as well as tinyxml2 for the mod API and asio for networking), 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.
The multiplayer server requires Python 3.8 or later. You can download Python here.
To use the server, open Command Prompt in the folder Server.py is located in, then run the command py -3 Server.py [local IPv4 address] [port] debug
. You can find your local IPv4 address using the command ipconfig
.
Note that the CPP server found in the Server folder in the repo has been deprecated and no longer works. It has been kept in the repo for reference purposes.
A: Try turning on VSync in settings.ini.
A: Submit an issue in the issues tab and we might fix it in the main branch. Don't expect any future releases, however.
A: I already have! You can find it here.
A: No. Sonic Mania is much bigger and requires that I'd decompile not only how the (far more complex) RSDKv5 works, but also all 600+ objects work.
- Chuli for helping me fix bugs, tweaking up my sometimes sloppy code and generally being really helpful and fun to work with on this project.
- 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.
Join the Retro Engine Modding Discord Server for any extra questions you may need to know about the decompilation or modding it.