Overview
r2modman(plus) builds v3.1.0 and beyond now have native Linux support! This guide is deprecated.
*!* UPDATE JAN 25 2021 – LINUX SUPPORT ADDED *!*
Originally posted by Nyaomi:r2modman(plus) builds v3.1.0 and beyond now have native Linux support.
Grab it from Thunderstore[thunderstore.io] or, if you’re fancy, grab distro-specific installable builds from GitHub[github.com].This entire guide can be considered as deprecated in favor of the native version of the mod manager.
As always, you can report issues on the GitHub issue tracker[github.com]
—
@odo please scrap the current “Native Linux support” section altogether and just mention this comment. However, I would suggest you put all the other sections into a SPOILER tag, just to preserve them, but they aren’t really needed anymore.
Originally posted by Nyamoi:As a (sort of) reply to my message, and as a follow-up, I need to clarify that setting the WINEDLLOVERRIDES variable or using protontricks is not needed anymore when using r2modman 3.1.0+.
Thank you so much to everyone who has contributed to this!
Requirements
You will need the following before beginning:
- Risk of Rain 2 installed and working through Proton
RoR2 has a Platinum rating on ProtonDB[www.protondb.com], so it should work out-of-the-box. - r2modman[thunderstore.io]
- I used Wine 4.0.3, other versions may work
wine –version
- Python 3.6 or greater (needed for pipx)
python3 –version
- protontricks[github.com]
- winetricks
sudo apt-get install winetricks
This guide was written using what worked for me on Linux Mint 19.1, however the instructions should remain accurate on other Ubuntu/Debian-based distros.
Installing r2modman
Once you have r2modman downloaded, double click on the installer. Wine may say several times that certain packages need to be installed. Ensure that you click “install” to all the prompts.
About 90% of the way through installing the gecko package for the second time, the r2modman installer will open. Run through the installation as you would on Windows, but do not change the install directory unless you know what you are doing.
Once it is done, the installer will ask if you would like to open r2modman. If you click yes, the app will open briefly before saying it encountered an error and must close. This is expected, click “close” and then close the r2modman window if it does not close on its own.
Getting r2modman to Launch
Now that r2modman has been installed, we need to make it actually work. For this, some winetricks packages need to be installed to provide the Windows features r2modman relies on.
Open a terminal window and type the following command:
Now double-click on r2modman, and it should launch. Click “Select profile” and continue to the manager.
If the Screen is Black
You can skip this section if you do not encounter this issue.
If r2modman launches, but has a completely black screen, type the following command into the terminal:
If you haven’t installed protontricks yet, follow the instructions on its GitHub page[github.com].
Click on the “Libraries” tab, then use the dropdown to locate “libglesv2” and disable it. If libglesv2 does not appear, type it into the dropdown box and click “Add”, then disable it.
Alternatively, if this does not fix the problem, try using winecfg itself without protontricks:
Follow the same instructions as before; Click on the “Libraries” tab, then use the dropdown to locate “libglesv2” and disable it. If libglesv2 does not appear, type it into the dropdown box and click “Add”, then disable it.
Note: I cannot personally confirm that this works, since I did not encounter this bug during my installs. Other users reported this works, and you can find more info on it in the GitHub issue page[github.com].
Setting Directories
r2modman does not currently know where Steam nor Risk of Rain 2 are located, so they need to be set manually.
Go to settings, then to the “Locations” tab. Scroll down to “Change Risk of Rain 2 directory” and manually browse to your RoR2 install in the steamapps folder. Unless you have changed it, it should be located at /home/(username)/.steam/steam/steamapps/common/Risk of Rain 2.
The file browser you are presented with will not display hidden folders or files (the .steam folder is hidden), so you will have to manually enter the address into the bottom bar. Remember to use backslashes () instead of forwardslashes (/), since r2modman believes it is running on Windows.
Next you will need to set the Steam directory. You will actually be navigating to the Steam app, which is by default located at /usr/games/steam. However, r2modman is looking for an .exe file, so you must first create a copy (or link) of the Steam app with a .exe extension.
Run the following command:
You can now set the Steam directory in r2modman to /usr/games/. If you did the preceeding step incorrectly, r2modman will refuse to set the directory to that folder since it does not see a steam.exe file.
Running the Game
If you attempt to launch the game without any mods installed, it will work fine. However, if you try launching with a mod, you will receive an error stating that r2modman could not create a symlink. NOTE: This only happens if you are using a file system that is incompatible with symlinks, such as exFAT.
To fix this, simply follow the recommended action and switch the mod install mode to legacy in the “Debugging” tab of the settings. This has a slight downside of requiring you to manually alter mod config files.
Risk of Rain 2 will now launch properly, but you will notice that no mods you install are actually applied to the game. This is where protontricks comes into play.
If you have not installed it yet, follow the instructions on the GitHub page[github.com]. You will need Python 3.6 or greater.
Once you have it set up, run:
When asked to pick a library game, select Risk of Rain 2. You can dismiss the warning about using a 64-bit Wine prefix. Click OK on “Select the default wineprefix”, dismiss or accept the statistics survey (if it appears), and then click “Install a Windows DLL or component”.
Scroll all the way down to “winhttp”, click its checkbox, and then click OK. Wait while it is installed, and when the window appears again you can click cancel until it closes.
All Done!
Install the mods you want as normal, click “Start modded” and the game will launch with the mods applied.
I could not have gotten r2modman to work on my machine nor written this guide without the help of the commenters on this GitHub issue[github.com]. I am immensely grateful to the people there for contributing the tricks that worked for them.
Let me know in the comments if you have any problems getting r2modman to work with this guide! The GitHub issue on r2modman I linked before also has some useful information that may help you, I only included the steps I had to perform from it, but every environment is different. If you have any useful tips let me know as well and I can include them in this guide.
If this helped you, make sure to upvote and/or favorite it so others can see it!
Thank you for reading and happy modding! 🐧
Editing Config Files
Since we are not able to use r2modman’s built-in config editor, we have to edit the files manually.
Do NOT change the mod config files in the Risk of Rain 2 directory. These are overwritten every time the game is launched through the manager.
Instead, navigate to ~/.wine/drive_c/users/(username)/Application Data/r2modmanPlus-local/mods/profiles/(the current profile)/BepInEx/config and change the config files here. These will be copied to the associated location in the Risk of Rain 2 directory when you launch the game.