Running on Linux (Wine)

Running on Linux

Hedge Mod Manager wasn't designed to run on Linux, due to using WPF and targeting Windows games. However, using the latest version alongside Wine or Proton (make sure to use wine/proton tricks with dotnet48 d3dx9 vcrun2019 d3dcompiler_47) will allow Hedge Mod Manager to run under Linux.

Once you've set up your mods, in the launch options for the game put this in:

• WINEDLLOVERRIDES='d3d9.dll=n,b' %command% (Sonic Generations, Sonic Lost World)
• WINEDLLOVERRIDES='d3d11.dll=n,b' %command% (Sonic Forces, Olympic Games Tokyo 2020, Puyo Puyo Tetris 2, Sonic Colors Ultimate, Sonic Origins)

Afterwards, your mods should be up and running.

NOTES:

• This assumes Steam is installed at ~/.steam and that you have allowed HMM to access your home folder and all of the games (if not in the home folder).
• We recommend not putting HMM in a game folder, but instead somewhere else within your home folder like ~/HedgeModManager/. This way, HMM will remember your last selected game. Giving HMM access to your home folder will also allow it to read your Steam configuration files so it can allow game switching within one instance.
• Due to how the Steam Deck is set up, you will have to use the Bottles method below for running HMM itself. Launch options for the games stay the same.
• Due to an issue with 64-bit mono, .NET Framework 4.8 or newer is required to be installed in each 64-bit title for mods to load correctly. (Sonic Forces and newer)

If you encounter any issues, please report it in this issue.

Installing .NET Framework for 64-bit Titles (SteamOS)

Steam:

• Download and Start your game with whatever Proton version you are using for it so it creates the compatdata stuff on first boot.
• Set your game of choice to Proton 5.0-10 (the first time around Steam will need to download Proton 5.0, so wait for that).
• Download Protontricks from Discover.
• Open Protontricks and select your target game from the list (ignore warnings about 64bit prefix).
• Select the target game from the list.
• Select Select the default wineprefix from the list and press OK.
• Select Install a Windows DLL or component from the list and press OK.
• Select dotnet48 from the list and press OK. This step will install both .NET Framework 4.0 and 4.8, just click the popups and the installers.
• Your Steam Deck will now need a reboot for the two new .NET Frameworks to work.
• You can now revert the game being set to Proton 5.0-10.

Heroic: (Untested)

• Download and Start your game of choice with latest Proton version (or whatever works for the game).
• Go to Game Settings (gear icon on game thumbnail).
• Set your game of choice to Proton 5.0 as target Wine Version (if you don't have it on the dropdown you may need to install it from Steam, just set any game to Proton 5.0-10 and Steam will auto-download it, then you can change it back to it's original Proton version).
• Click on WINETRICKS (ignore warnings about 64bit prefix).
• Select Select the default wineprefix from the list and press OK.
• Select Install a Windows DLL or component from the list and press OK.
• Select dotnet48 from the list and press OK. This step will install both .NET Framework 4.0 and 4.8, just click the popups and the installers.
• Your Steam Deck will now need a reboot for the two new .NET Frameworks to work.
• You can now revert the game being set to Proton 5.0.

Guide Comment.

Guide Using Bottles (Linux, Steam Deck)

At this moment the Bottles script can be found in this comment.

NOTE:

• If you are using a Steam Deck, you must add a DWORD registry key to HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics called DisableHWAcceleration, set to 1. Otherwise, HedgeModManager will crash on launch.

---

NOTE: The guide below is outdated, while it may still work, you will need to enable home permissions within flatseal to allow games to be detected

The bottle config