R2ModMan Tutorials and Troubleshooting

First-time installation

After installing the app, you will select a game, create a profile, and browse Thunderstore for your first mods.

Windows

1. Download the latest package from the download page using your configured official link.
2. Extract the zip archive to a dedicated folder.
3. Run r2modman Setup with the current version number in the filename.
4. Choose install scope for current user or all users when prompted.
5. Select install directory and wait for completion.
6. Open R2ModMan, pick your game from the grid, and create a new profile.

Create your first profile

Profiles keep mod lists isolated. Use Default for everyday play, or create separate profiles for co-op packs and experimental setups.

1. Select an existing profile or click Create new.
2. Name the profile and confirm with Select profile.

Install your first mod

1. Open the Online tab in the sidebar.
2. Search for a mod or framework such as BepInExPack.
3. Open the mod page and click Get build.
4. Confirm Install with dependencies when prompted.

Linux

1. Get build the Linux zip or AppImage from your official source.
2. Extract and locate the AppImage inside the archive.
3. Enable execute permission on the AppImage file.
4. Launch the AppImage and select your game directory when asked.
5. Report distro-specific packaging issues through the community modding discord channels listed in official documentation.

How to update mods

Method 1: One mod at a time (recommended)

1. Open the profile containing mods to update.
2. Click Installed if not already active.
3. Select a mod showing the cloud update icon.
4. Click Update and confirm Install with dependencies.

You can also click the cloud icon on the card without expanding details.

Method 2: Update all at once

1. Open the target profile.
2. Go to Settings, then the All tab.
3. Scroll down and click Update all mods.
4. Confirm Update all.

Updating one by one helps identify which mod caused a regression after a game patch.

How to configure mods

1. Select the profile whose settings you want to edit.
2. Open Config editor in the sidebar.
3. Adjust values for BepInEx or individual mods.
4. Click Save before launching the game.

You can also browse the profile folder manually: Settings > Locations > Browse profile folder > BepInEx/config. See the config editor feature for supported builds.

Launch and play

1. Open the profile you want to use.
2. Click Start modded in the sidebar.
3. Wait for the game title screen to appear.
4. Play as normal through your launcher.

Use Start vanilla to launch without mods. For Steam on Linux, copy the launch command from the Help tab into Steam Launch Options if mods fail to load under Proton.

Share your mod list with friends

Host steps

1. Select the profile to share.
2. Settings > Profile > Export profile as a code.
3. Copy and send the code to your group.

Friend steps

1. Settings > Profile > Change profile.
2. Click Import, then From code.
3. Paste the code and confirm Import.
4. Wait for mods and configs to download.

Export codes expire after roughly one hour. Use file export for longer-term sharing.

Switch profiles

1. Open Settings.
2. Go to the Profile tab.
3. Click Change profile and select another entry.

You can also return to the profile picker from the game selection flow using Back to game selection, then re-enter your game.

Antivirus warnings explained

Security software may flag R2ModMan or individual mod DLLs because they inject into game processes and download unsigned community binaries. This behavior is expected for modding tools and does not automatically mean the file is malicious.

What to do

• Confirm you downloaded from an official source listed on download.html.
• Verify SHA hashes when the release publishes them.
• Never install repacks from search engine ads or unknown file hosts.
• Quarantine only unknown files; restore R2ModMan after hash verification.

Common problems

Best practices

• Create a backup profile before major mod updates.
• Install dependencies via Install with dependencies every time.
• Update mods individually after game patches.
• Read mod descriptions and compatibility tags on Thunderstore.
• Use dark mode if the default theme strains your eyes: Settings > Other > Switch theme.
• Keep the manager itself updated via built-in auto-update on close.