SonicMastr / RSDKv5-Decompilation

A complete decompilation of Retro Engine (v5)

A complete decompilation of Retro Engine v5 and v5Ultimate For the PSVita.

LiveArea Assets by Danhanado

SUPPORT THE DEVELOPERS OF THE RETRO ENGINE

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 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.

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 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

How to Build

First, follow the steps in the common dependency README, then follow the steps for your platform of choice:

• Windows

• Mac

• Linux/Switch

  • Follow the GL3 README to setup the renderer's dependencies.
  • For Linux, SDL for audio (or if you use the SDL2 backend) will be required:
    • On Ubuntu: sudo apt install libsdl2-dev
    • On Fedora: sudo dnf install SDL2-devel
    • On Arch: sudo pacman -S sdl2
  • Then, for both platforms, the makefile can be used by running make.
    • For Switch, pass PLATFORM=Switch to the make command to ensure you're building for Switch.

• Android

Other Platforms

Currently, the only officially supported platforms are the ones listed above. However, the backend is very modular, so the codebase is very multiplatform.

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!:)

• WebASM by heyjoeway

• New 3DS by SaturnSH2x2

• Wii U by Radfordhound

• Vita by SonicMastr

• and a general optimization fork by smb123w64gb

FAQ

Q: The screen is tearing, how do I fix it?

A: Try turning on VSync in settings.ini.

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: Is there a decompilation for RSDKv3 and/or RSDKv4 alone?

A: There is! You can find RSDKv3 here and RSDKv4 here.

Q: Will there be a decompilation for any other RSDK versions?

A: No. This is the last decompilation from us. This project took about 1 and a half years to do, and with it completed, we're ready to move onto other endeavours rather than continue decompiling programs forever.

Q: Are there anymore decompilation projects in the works?

A: Absolutely not. Between the last two and this one, we're done with decompiling, at least for the time being. Please do not expect any more decompilations from us, Sonic or otherwise!

Special Thanks

• Chuli 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 creating the asset bases such as the header and icons (originally made for RSDKv3 and v4, modified by Chuli)
• 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.