Skip to content

Running on Linux (Wine)

Michael edited this page Jul 16, 2023 · 32 revisions

NOTE: There has been reports of SteamTinkerLaunch not working, please use the Bottles method instead. If you have any questions please post it in #219.

Guide Using Bottles

The guide for using bottles can be found over here: Running on Linux (Incomplete)

Guide Using SteamTinkerLaunch

Hedge Mod Manager wasn't designed to run on Linux, due to using WPF and targeting Windows games. However, using SteamTinkerLaunch will allow you to get Hedge Mod Manager running under Linux. Currently, Hedge Mod Manager support is only available in SteamTinkerLaunch git.

Linux Gaming Central did a writeup on getting Hedge Mod Manager up and running with SteamTinkerLaunch over on their blog: https://linuxgamingcentral.com/posts/updated-sonic-frontiers-steam-deck-modding-guide/

Requirements

Linux Desktop

On Linux Desktop this requires Winetricks 20220411-next or higher. You can check your Winetricks version with winetricks --version, and update if necessary with sudo winetricks --self-update.

Steam Deck

On Steam Deck, no extra steps should be required. SteamTinkerLaunch will download and install Winetricks for you for any application that needs it, including Hedge Mod Manager.

Both

You will need to set up launch options in order for the mod loader to be picked up by Proton.

  1. Right click the game on Steam.
  2. Select Properties -> Launch Options.
  3. For Generations/Lost World, enter WINEDLLOVERRIDES='dinput8.dll=n,b' %command% as the command.
  4. For Forces/PPT2/SCU/Frontiers, enter WINEDLLOVERRIDES='d3d11.dll=n,b' %command% as the command.

Features

After setting Hedge Mod Manager up through SteamTinkerLaunch, your mods should be up and running! SteamTinkerLaunch will automatically install the needed tweaks to get your games working, including the required dotnet48 for all supported 64bit games. Currently, SteamTinkerLaunch will automatically configure the following mods:

  • Sonic Generations
    • Direct3D 11 mod
  • No other known per-mod tweaks required at the moment

If you find a mod that requires a certain set of steps to get working correctly (i.e., a specific Winetrick that it needs), please report it to SteamTinkerLaunch.

SteamTinkerLaunch will also set up an Application Menu shortcut so you can launch Hedge Mod Manager without using the command line at all. GameBanana's 1-click Mod Manager button should also be supported on the Linux Desktop, but may not work on Steam Deck.

If you are having issues with the GameBanana button, copy the button link and pass it as an argument to the steamtinkerlaunch hmm u command. Note that some mod archive formats may not be supported such as RAR files. It is therefore recommended to download and install mods manually.

Notes for 64bit games

If you are trying to mod a 64bit game (e.g., Sonic Frontiers), the game may not boot with the modloader installed. To work around this, you will manually need to put a mscoree.dll file into the same folder as your game's exe (which is the same folder that holds the d3d11.dll file -- This is the modloader).

If you run into this issue, you can grab a 64bit mscoree.dll file from here: https://www.dll-files.com/mscoree.dll.html -- Be sure to grab the 64bit version. Version 10.0.14393.0 is the one that has been tested.

If 64bit games continue to fail to boot with the modloader, you may need to start with a clean prefix for that game and install dotnet48 using Proton 5.0. You can do this by downloading Proton 5.0 from Steam (from Desktop Mode on Steam Deck) and then selecting Proton 5.0 as your Hedge Mod Manager Proton version from SteamTinkerLaunch. Then you can run Hedge Mod Manager.

Alternatively, there is a guide on how to do this using Protontricks on Steam Deck.

Guide Using Bottles (OLD)

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 Guide

The bottle config