Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/hedge-dev/UnleashedRecomp/llms.txt

Use this file to discover all available pages before exploring further.

Unleashed Recompiled offers native Linux support and runs on Steam Deck out of the box. The Flatpak build is the recommended method for Steam Deck users and can be installed directly and added as a non-Steam game via Desktop Mode.

Installing via Flatpak

The Flatpak build (io.github.hedge_dev.unleashedrecomp) is the recommended way to run Unleashed Recompiled on Steam Deck. Install it from Desktop Mode and add it as a non-Steam game to make it accessible from Gaming Mode.
It is recommended to complete the installation process while in Desktop Mode. The file picker used during setup may not be available in Game Mode at all times. Booting into Desktop Mode at least once will enable the file picker to work when you switch back to Game Mode.
1

Switch to Desktop Mode

From the Steam Deck’s power menu, select Switch to Desktop to enter Desktop Mode.
2

Install the Flatpak

Download and install the Unleashed Recompiled Flatpak (io.github.hedge_dev.unleashedrecomp) from the official GitHub Releases page.
3

Prepare your game files

Before launching, make sure your dumped Sonic Unleashed game files are accessible. See the storage warning below for advice on where to place them.
4

Run the installer

Launch the application. The built-in installation wizard will guide you through providing your game files. Complete the full installation process while in Desktop Mode to avoid file picker issues.
5

Add as a non-Steam game

Once installation is complete, add Unleashed Recompiled as a non-Steam game in the Steam client so it appears in your Gaming Mode library.

Storage Considerations

Installing Sonic Unleashed requires up to 10 GiB of storage (6 GiB without DLC). On the 64 GB Steam Deck model, this can easily consume a significant portion of the internal storage. It is strongly recommended to provide your game files via external storage — such as a microSD card or a network share — during the installation process to avoid running out of space.

Game Data Location

The Flatpak build stores all game data in a sandboxed directory. This is the only path the Flatpak build will recognize as valid:
~/.var/app/io.github.hedge_dev.unleashedrecomp/data
If you ever decide to switch from the Flatpak build to a native Linux build, you can reuse this data directory — no reinstallation required. You can also move the data to another location by creating a symlink from the above path to your preferred destination.

File Picker in Game Mode

Due to restrictions in how the Steam Deck’s desktop environment works while in Game Mode, the file picker required during installation may not be available. Workaround: Boot into Desktop Mode at least once before attempting to use the file picker. After that single Desktop Mode boot, the file picker will become available when you return to Game Mode. If you want to avoid the issue entirely, you can complete the full installation process while in Desktop Mode.

Performance Tips

Unleashed Recompiled performs noticeably better on Steam Deck than the game did on its original hardware when using default settings, but demanding sections — such as Werehog combat or DLC stages — may make maintaining the target frame rate difficult. Keep the following in mind to get the best experience:
  • Manually set the GPU clock to its maximum value via Gamescope. Performance improves significantly with this change, even though the game is primarily CPU-bottlenecked.
  • The game is CPU-bottlenecked on Steam Deck, meaning GPU upgrades have less impact than CPU single-thread speed.
  • If you encounter performance issues, try lowering Resolution Scale, Anti-Aliasing, or Shadow Resolution from the in-game options menu.
  • Overall performance is considered noticeably better than on the original Xbox 360 hardware at default settings.
Linux has an unexpected performance advantage in CPU-bound scenarios compared to Windows, potentially due to differences in how thread synchronization is handled between the two schedulers. This benefits Steam Deck users running the native Linux or Flatpak build.

Mod Support

The Flatpak build is compatible with the development version of HMM 8, which provides Linux support and should work out of the box on Steam Deck. This allows you to install and manage mods for Unleashed Recompiled directly on the Deck.

Build docs developers (and LLMs) love