The project's README from github.com/FoxWorkshop/ShadowRecomp. As one markdown file: README.md.
Download · Requirements · Features · Known Issues · Controls · FAQ · Building · Credits
Shadow Recompiled is an unofficial PC port of the original Xbox version of Shadow the Hedgehog (2005) created through the process of static recompilation. The port supports Windows and Linux.
This project does not include any game assets. You must provide the files from your own legally acquired copy of the game to install or build Shadow Recompiled.
XboxRecomp2 (previously XboxRecomp) is the main recompiler used for converting the game's original x86 code into compatible C++. The development of that recompiler was directly inspired by XenonRecomp, which was used to create Sonic Unleashed Recompiled.
A built-in installer will guide you through the game installation process, performing many integrity checks to ensure the process goes as smoothly as possible.
A new options menu for PC has been added, replacing the game's original settings. Get access to many quality of life features and graphics options directly in-game with navigation that is fully compatible with a controller.
Aspect ratios for 16:9 and 16:10, as well as ultrawide displays (such as 21:9 or even wider) are supported with options to adjust the alignment of the UI.
Support for high frame rate has been added as an available option. Many glitches that normally occur at higher frame rates have been fixed and are included as part of the recompilation. Cutscenes have also an option to play at unlocked frame rate.
Extra care and attention was taken to make the experience the best as possible:
other fixes:
Achievements have been implemented to the game, they can be checked from the pause menu; a full new menu has been added.
You will be rewarded with achievements as you progress through the game.
[!NOTE] Achievements cannot be used with platforms such as Steam or RetroAchievements.
The game includes a mod loader compatible with SA Mod Manager.
The mod format uses the same standard as the one used by Sonic Adventure mods.
[!NOTE] Code modding is currently not possible and is planned for a future update. As a workaround for the time being, some codes have been directly embedded into the game and can be accessed through SA Mod Manager's Codes tab.
Before reporting any issues, check if they are listed here.
Default keyboard controls:
config.toml
| Hotkey | Action |
|---|---|
| Alt+Enter | Toggle fullscreen/windowed mode |
| Ctrl+1 | Keyboard controls port 1 |
| Ctrl+2 | Keyboard controls port 2 |
| Ctrl+3 | Keyboard controls port 3 |
| Ctrl+4 | Keyboard controls port 4 |
| F1 | Toggle profiler |
| F8 | Toggle HUD |
Shadow Recompiled does not have an official website.
Please link here when directing anyone to the project.
[!CAUTION] Do not download builds of Shadow Recompiled from anywhere but our Releases page.
We will never distribute builds on other websites, via Discord servers or via third-party update tools.
You cannot use the files from the GameCube or PlayStation 2 version of the game.
Supporting these files would require an entirely new recompilation to handle all the differences.
%APPDATA%\ShadowRecomp\~/.config/ShadowRecomp/Inside, saves are in save/ and settings in config.toml.
You can also create portable.txt beside the .exe to keep everything in
your game folder.
Copy the files from a new release over your existing install.
Launch the game with --install.
In a console/terminal window.
You'll only need this if you changed the game files; and want to revert to a stock setup.
This is a vanilla game issue. Higher resolutions unfortunately make this issue easier to see.
The Xbox version of the game has several missing sound effects. See details here if interested.
You will need to use a SFX Restoration mod to fix these defects.
We only have Windows + Linux machines.
We'd happily accept community contribution for macOS.
But folks who want to support platforms that require more significant modifications (e.g. touchscreen on mobile); should make a fork.
Before reporting any issues, check if they are listed here.
Check out the building instructions here.
Sora: Creator and Lead Developer of the recompilation, as well as the developer of technologies created for it such as XboxRecomp (before the XboxRecomp2 switch) and XShaderRecomp. Provided French localization for the custom menus. Final design decisions and UI for installer, achievements, and other custom menus.
dreamsyntax: Second Developer, source for Shadow knowledge, ensuring port accuracy, and identifying flaws with the Xbox port of the game. Provided English localization for the custom menus.
Sewer56: Third Developer. Added nix support, Discord RPC, implemented better widescreen, better framepacing and >4x'd performance with shaders and XboxRecomp2.
TheHatedGravity: First installer design, UI polish, spotting visual flaws
DonutStopGaming: Help with understanding RenderWare and finding Shadow functions.
Jesus_PK: Provided Spanish localization for the custom menus, also helped testing and finding bugs.
Deep-Sea Berry: Artist behind the project logo, along with custom options icons. Provided German localization for the custom menus and helped testing and finding bugs.
Emasplatter: Provided Italian localization for the custom menus.
Windii: Provided Japanese localization for the custom menus.
Kondrashov's Lair: Produced the installer music (original prod. by Sins Of A Divine Mother).
CXBX-Reloaded Development Team: This project would not have been possible without the CXBX emulator. Nearly every aspect of the development was guided by referencing CXBX's research on the original Xbox, especially the graphics part.
extract-xiso: extract-xiso devs ([email protected] and other extract-xiso contributors) for core extraction in the installer.
Unleashed Recompiled Development Team: Created much of the ground work that made all of this possible and sped up development time considerably.
Marathon Recompiled: Used as a reference for various features and help with debugging.
Skyth: Provided help to understand how Recompilation works, also the author of the original graphics pipeline code which was (mostly) reused here.
Darío: Creator of the graphics hardware abstraction layer plume, used by the project's graphics backend.
MattKC: Useful explanation of Xbox's Push Buffers system on his blog with Reburn3.
ocornut: Creator of Dear ImGui, which is used as the backbone of the custom menus.