Latest versions of MelonLoader are known to have issues with some games. Use version 0.5.4 until the issue has been fixed!
Problems starting modded
Updated 10 months agoPlease run through these steps in order.
Prerequisites
Ensure you are trying to start modded by clicking "Start modded" within r2modman. Launching the game through Steam should by default provide an unmodded experience.
The game doesn't launch at all
If the game runs through Steam, this means that your Steam directory is probably incorrect in the manager settings.
The default Steam location is C:/Program Files (x86)/Steam
Note: this folder contains the Steam executable and not the game executable.
If the game is not running through Steam, please set the game directory correctly.
If your anti-virus is preventing the launch, then set an exception for r2modman.exe.
Black screen on launch
- Select the Profile producing this problem.
- Click on
Settings -> Debugging -> Run preloader fix
- Wait until Steam has finished validation and you're done.
The game starts but no mods are loading
Games via Steam
- On Steam, right click the game and go to
Manage -> Browse local files
- Take note of the path.
- In r2modman, select a profile and go to
Settings -> Locations -> Change <game> directory
. - Ensure these directories match. You won't see any files because it's a folder selection dialog. As long as it's the same path as the one in Steam, this is fine.
- If these already match, continue to the next section, otherwise try starting modded through the manager.
Checking launch arguments
You may have overridden the launch arguments for the game at some point. Ensure to check that the launch argument box is empty by doing the following:
- Right click on the game on Steam and go to
Properties
- At the bottom there's a box where you can type text. Ensure this is empty.
Non-Steam games
Set this to your game executable. You'll need to see how to find where your game is installed depending on how you installed it (EGS, GOG, Oculus, other).
Corrupted BepInEx installation
- Settings -> Toggle download cache (disable it)
- Settings -> Export profile as code
- If you don't get an export code, this is a definite sign that it's a bad BepInEx install. You can skip straight to step 8 after re-downloading BepInEx from the Online section.
- Settings -> Change profile
- Import -> From code
- Select new profile
- Start modded
- Toggle the download cache (enable it)
Run as admin
Running the manager as an administrator may be required if a folder isn't writable with the ordinary permissions.
Assuming this fixes the issue, a better alternative would be to move your game directory to somewhere that doesn't require the manager to be ran as an administrator.
Finally
Try restarting your PC. It's been reported to have solved the issue on numerous occasions, so it can't hurt to give it a go.
Anything else?
If you are using r2modman, ask for help in the r2modman Discord Server.
If you are using Thunderstore Mod Manager, ask for help in the Thunderstore Discord Server.
Please use the correct Discord server. Do not use both.