# RSDKv5 Decompilation: reconstructing Retro Engine v5 and v5U

> Reconstructs the Retro Engine (RSDK) v5 and v5 Ultimate runtime, the engine that runs Sonic Mania’s game code, and builds it for Windows, Linux, Switch and Android. RSDKv5U can also run RSDKv3 and RSDKv4 games such as Sonic CD and Sonic 1 & 2. The project adds a mod loader, a shader compiler and extra Windows backends, and ships no game data.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-10-18
- Added to the catalog: 2026-10-18
- Original resource: <https://github.com/RSDKModding/RSDKv5-Decompilation>
- Primary source: <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/README.md>
- Catalog page: <https://awesomerea.org/resources/rsdkv5-engine-decomp-case/>
- Record JSON: <https://awesomerea.org/resources/rsdkv5-engine-decomp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/rsdkv5-engine-decomp-case/index.md)

## Requirements & limits

- **Prerequisites:** Neither game data nor game logic ships here. The engine loads data files from an official RSDKv5(U) game such as Sonic Mania (Plus), and game code comes from a separate project linked as Game, such as the Sonic Mania decompilation, which also bundles this engine. The FAQ covers Sonic Origins data files, which lack the games’ music and sound effects, and notes that release builds block the Origins Plus characters.
- **Prerequisites:** Clone recursively, because GitHub’s source ZIPs omit the required submodules. CMake builds use Visual Studio with vcpkg on Windows, GLEW, GLFW and libtheora development packages on Linux, devkitPro packages for Switch, and a separate Android guide; community forks for WebAssembly, New 3DS, Wii U, Wii and Vita are listed as possibly WIP or outdated. The default Windows DirectX backends support only XInput controllers, and GL builds need a user-made shader mod for videos and filters.
- **Scope:** The repository describes itself as a complete decompilation of Retro Engine v5 and v5Ultimate; its license says it also contains original code and that most code is meant to be functionally the same as the specified RSDK version. RETRO_REVISION defaults to 3 (RSDKv5U). The reviewed commit is 13 commits after release v1.1.1 (2025-11-01).
- **Testing evidence:** CI builds Windows x86 and x64, Linux and Android binaries. The project publishes no comparison with the original engine binaries, and the FAQ says bugs present in official releases will mostly not be fixed.
- **License:** The custom RSDKv5(U) Decompilation Source Code License v2.1 requires any distributed prebuilt executable to have DLC disabled by default, forbids commercial use and distributing game assets other than unique modded ones, requires crediting Evening Star and the decompilation authors Rubberduckycooly and chuliRMG, and binds forks to the same terms. The README says Evening Star owns the Retro Engine.

## Primary sources

1. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/README.md>
2. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/FAQ.md>
3. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/LICENSE.md>
4. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/dependencies/android/README.md>
5. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/RSDKv5/RSDK/Core/RetroEngine.cpp>
6. <https://github.com/RSDKModding/RSDKv5-Decompilation/blob/191d7aea6c262d891244172a8609ac69fbfd7571/.github/workflows/build.yml>
7. <https://github.com/RSDKModding/RSDKv5-Decompilation/releases/tag/v1.1.1>

## More in Games

- [Sonic Mania: a game-code decompilation for the RSDKv5 engine](https://awesomerea.org/resources/sonic-mania-decomp-case/index.md) · Case study
- [SpaceCadetPinball: decompiled game logic adapted to SDL2](https://awesomerea.org/resources/space-cadet-pinball-case/index.md) · Case study
- [TicTacToe-AI: a bounded REA-fork reconstruction of one game method](https://awesomerea.org/resources/rea-engine-tictactoe-case/index.md) · Case study
- [UltraSunnyMoon: a partial, REA-led Pokémon Ultra Sun reconstruction](https://awesomerea.org/resources/ultrasunnymoon-rea-case/index.md) · Case study
- [vf2-decomp: differentially validated Virtua Fighter 2 recovery](https://awesomerea.org/resources/vf2-decomp-differential-recovery-case/index.md) · Case study
- [Wind Waker HD decompilation: functions verified against the recompiled Wii U game](https://awesomerea.org/resources/wind-waker-hd-decomp-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
