A complete decompilation of Retro Engine v5 and v5Ultimate.
We do not own the Retro Engine in any way, shape or form, and this project would not have been possible had they not developed RSDKv5(U) in the first place. Retro Engine is currently owned by Evening Star; we highly urge you to follow & support their projects if you enjoyed this project of ours!
DO NOT USE THIS DECOMPILATION PROJECT AS A MEANS TO PIRATE SONIC MANIA (PLUS) OR ANY OTHER RSDKv5(U) GAMES.
We do not condone using this project as a means for piracy in any form. This project was made with love and care for the source material and was created for purely educational purposes.
- Added a built-in mod loader and API allowing to easily create and play mods with features such as save file redirection and XML asset loading, supported by all sub-versions of v5U.
- Added a built-in shader compiler for backends/platforms that support it.
- Added various other backends to windows aside from the usual DirectX 9 backends
You have the option of building RSDKv5 alongside Mania in the Sonic Mania Decompilation repo.
This project uses CMake, a versatile building system that supports many different compilers and platforms. You can download CMake here. (Make sure to enable the feature to add CMake to the system PATH during the installation if you're on Windows!)
In order to clone the repository, you need to install Git, which you can get here.
Clone the repo recursively, using:
git clone --recursive https://github.com/RSDKModding/RSDKv5-Decompilation
If you've already cloned the repo, run this command inside of the repository:
git submodule update --init
To handle dependencies, you'll need to install Visual Studio Community (make sure to install the Desktop development with C++
package during the installation) and vcpkg.
After installing those, run the following in Command Prompt (make sure to replace [vcpkg root]
with the path to the vcpkg installation!):
[vcpkg root]/vcpkg.exe install libtheora libogg --triplet=x64-windows-static
(If you're compiling a 32-bit build, replacex64-windows-static
withx86-windows-static
.)
Finally, follow the compilation steps below using -DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-static
as arguments for cmake -B build
.
- Make sure to replace
[vcpkg root]
with the path to the vcpkg installation! - If you're compiling a 32-bit build, replace
x64-windows-static
withx86-windows-static
.
Install the following dependencies: then follow the compilation steps below:
- pacman (Arch):
sudo pacman -S base-devel cmake glew glfw libtheora
- apt (Debian/Ubuntu):
sudo apt install build-essential cmake libglew-dev libglfw3-dev libtheora-dev
- rpm (Fedora):
sudo dnf install make cmake gcc glew-devel glfw-devel libtheora-devel zlib-devel
- xbps (Void):
sudo xbps-install make cmake gcc pkg-config glew-devel glfw-devel libtheora-devel zlib-devel
- Your favorite package manager here, make a pull request (also update Mania!)
(make sure to install GL shaders!)
Setup devKitPro, then run the following:
(dkp-)pacman -Syuu switch-dev switch-libogg switch-libtheora switch-sdl2 switch-glad
Finally, follow the compilation steps below using -DCMAKE_TOOLCHAIN_FILE=/opt/devkitpro/cmake/Switch.cmake
as arguments for cmake -B build
.
(make sure to install GL shaders!)
Follow the android build instructions here.
Compiling is as simple as typing the following in the root repository directory:
cmake -B build
cmake --build build --config release
The resulting build will be located somewhere in build/
depending on your system.
The following cmake arguments are available when compiling:
- Use these by adding
-D[flag-name]=[value]
to the end of thecmake -B build
command. For example, to build withRETRO_DISABLE_PLUS
set to on, add-DRETRO_DISABLE_PLUS=on
to the command.
RETRO_REVISION
: What revision to compile for. Takes an integer, defaults to3
(RSDKv5U).RETRO_DISABLE_PLUS
: Whether or not to disable the Plus DLC. Takes a boolean (on/off): build withon
when compiling for distribution. Defaults tooff
.RETRO_MOD_LOADER
: Enables or disables the mod loader. Takes a boolean, defaults toon
.RETRO_MOD_LOADER_VER
: Manually sets the mod loader version. Takes an integer, defaults to the current latest version.RETRO_SUBSYSTEM
: Only change this if you know what you're doing. Changes the subsystem that RSDKv5 will be built for. Defaults to the most standard subsystem for the platform.
Currently, the only officially supported platforms are the ones listed above.
However, since release, there have been a multitude of forks made by the community (keep in mind that many of these ports are still a WIP, and some may be out of date):
-
WebASM by heyjoeway
-
New 3DS by SaturnSH2x2
-
Wii U by Radfordhound
-
Wii U by Clownacy
-
Wii by Mefiresu
-
Vita by SonicMastr
-
and a general optimization fork by smb123w64gb
You can find the FAQ here.
- st×tic for leading ModAPI development, porting to other platforms, general decompilation assistance, 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 making v5 and v5U assets with st×tic such as the header and icons
- 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.