SUPPORT THE OFFICIAL RELEASE OF SONIC MANIA (PLUS)

• Without assets from the official releases, this decompilation will not run.

• You can get the official release of Sonic Mania (Plus) from:

  • Windows
    • Via Steam
    • Via The Epic Games Store
    • Via Origin
  • Switch, via the eShop
  • PS4, via the Store
  • Xbox One, via the Store

Even if your platform isn't supported by the official releases, you must buy or officially download it for the assets.

DO NOT USE THIS DECOMPILATION PROJECT AS A MEANS TO PIRATE SONIC MANIA.

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, and would not exist without the work of Sega, Headcannon, and Evening Star.

If you want to transfer your save from the official PC versions, you can just copy your savedata into the folder containing the decompilation!

Additional Tweaks

• Added a built-in mod loader and API calls to enable a much smoother modding experience.
• Added support for targeting RSDKv5U rather than standalone RSDKv5
• Added all content from all released versions of the game. Including: 1.00 (Console initial release), 1.03 (PC initial release) & 1.06 (Plus update)

How to Build

This repo includes everything you need for Sonic Mania.

Windows

Open SonicMania.sln and build the project you wish to build.

• Projects ending with All use the generated All.c file in-place of compiling each object seperately. Use for faster compilation speed.
  • Adversely, projects without All compile each object using their separate source files. Use for JIT-compiling.
• The version you choose must match up with the RSDKv5 version you run. A v5U executable cannot run a v5 Mania, etc.

Linux/Make-like systems (+for Switch)

If you are building for Switch, you'll need devkitPro and GLAD, install GLAD with sudo dkp-pacman -S switch-glad.

Linux dependencies:

• pacman (Arch): sudo pacman -S base-devel glew glfw libtheora zlib sdl2 portaudio
• apt (Debian/Ubuntu): sudo apt install build-essential libglew-dev libglfw3-dev libtheora-dev zlib1g-dev libsdl2-dev portaudio19-dev
• rpm (Fedora): sudo dnf install make gcc glew-devel glfw-devel libtheora-devel zlib-devel SDL2-devel portaudio
• your favorite package manager here, make a pull request <3 (also update RSDKv5U!)

Compiling

Compiling is as simple as typing the following:

mkdir build
cd build
cmake .. # arguments go here
cmake --build ..

The following cmake arguments are available when compiling. For example, if you wanted to disable plus, the cmake .. step would look like cmake -DRETRO_DISABLE_PLUS=on ...

RSDKv5 flags

• TRO_REVISION= What revision to compile for. Takes an integer, defaults to 3 (RSDKv5U).
• RETRO_DISABLE_PLUS= What it says on the tin. Takes a boolean (on/off); build with =on when compiling for distribution. Defaults to =off.
• RETRO_MOD_LOADER= Enables or disables the mod loader. Takes a boolean, defaults to =on.
• RETRO_MOD_LOADER_VER= Manually sets the mod loader version. Takes a string, defaults to latest.

Sonic Mania flags

• WITH_RSDK= Whether or not RSDKv5 is built alongside Sonic Mania. Takes a boolean, defaults to =on.
• GAME_STATIC= How the libs are handled. Takes a string, defaults depend on build target. Usually fine to leave alone.
• MANIA_FIRST_RELEASE= Another boolean. Builds the first release of Sonic Mania when set to =on.
• MANIA_PRE_PLUS= A boolean. Builds the pre-plus release of Sonic Mania when set to =on.
• GAME_VERSION= An integer. Sets the game version to use. Defaults to 3 when MANIA_PRE_PLUS is enabled, and 6 otherwise (last steam release).

After compiling your binary, stick your libGame.so and Data.rsdk files in the same directory, launch, and voila!

Other platforms

The only directly supported platforms are those listed above. Since Mania is very easy to build, requiring no additional dependencies, virtually any platform that can run RSDKv5 can compile Mania easily.

However, there are a multitude of ports listed in the RSDKv5 repository.

FAQ

Q: Why aren't videos/filters working?

A: There's a mod for it that you have to make. Refer to the following directions:

Create the following directory structure inside your mods directory:

GLShaders/
| Data/
| | ...
| mod.ini

Inside mods/GLShaders/Data/, copy the RSDKv5/Shaders directory, and inside the mod.ini, paste this:

Name=GLShaders
Description=GL3 shaders to enable filters and stuff
Author=Ducky
Version=1.0.0
TargetVersion=5

Q: I found a bug/I have a feature request!

A: Submit an issue in the issues tab and we might fix it in the main branch. Don't expect any major future releases, however.

Q: Will you do a decompilation for Sonic CD (2011) and/or Sonic 1/2 (2013)?

A: I already have! You can find Sonic CD here and Sonic 1/2 here.

Q: Are there anymore decompilation projects in the works, such as Sonic Origins/Sonic 3?

A: Absolutely not. This project took about 1 and a half years to do, and doing Sonic 3 would take equally as long, if not longer, as Sonic 3 is not only larger in scope, but Origins' hybrid codebase makes it harder to read. Between our other decompilation projects and this one, we're done with decompiling, at least for the time being. We would also like to expand our horizons beyond Sonic going forward, and we don't wish to spend forever just playing catchup with Sega's official releases. Please do not expect any more decompilations from us, Sonic or otherwise!

Special Thanks

• Chuli for 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 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.