Thunderstore Mod Manager (2026): Complete Beginner to Pro Guide
Complete Thunderstore Mod Manager guide for 2026. Learn how to download, install, set up profiles, install mods, and fix common issues with this step-by-step beginner to pro tutorial.
If you play modded PC games and have not used Thunderstore Mod Manager yet, you are making your life harder than it needs to be. Thunderstore Mod Manager is a free, open-source tool that handles mod downloads, installation, updates, and profiles for dozens of popular games including Lethal Company, Risk of Rain 2, Valheim, and many others. Instead of manually dropping files into game folders and hoping nothing breaks, the manager handles the whole process cleanly and keeps everything organized. This guide covers everything from first-time setup to profile management and fixing common issues.
What Is Thunderstore Mod Manager?
Thunderstore Mod Manager is a dedicated mod management application that connects directly to the Thunderstore mod database. It is the successor to r2modman and shares much of the same functionality, though the Thunderstore Manager has become the more actively maintained version with a cleaner interface.
The core features include:
- One-click mod installation from the Thunderstore database
- Automatic dependency handling (it installs required mods automatically)
- Profile system so you can have different mod setups for different playstyles or friends
- Mod update notifications and batch updating
- The ability to launch games directly through the manager so mods load correctly
- Export and import of mod profiles for sharing with others
It is free to download and use, and it does not require an account to get started.
How to Download and Install Thunderstore Mod Manager
Step 1: Download the Manager
Go to thunderstore.io and look for the Thunderstore Mod Manager download link, or search “Thunderstore Mod Manager download” to find the official GitHub releases page. Download the latest installer (.exe file for Windows).
Do not download from third-party sites. The official source is Thunderstore.io or the official GitHub repository.
Step 2: Run the Installer
Open the downloaded installer and follow the setup prompts. The installation is straightforward with no unusual options to watch for. Accept the default installation path unless you have a specific reason to change it.
Step 3: Launch Thunderstore Mod Manager
Open the application after installation completes. On first launch, it will ask you to select a game. This is where you tell the manager which game you want to manage mods for.
Thunderstore Mod Manager Setup: First-Time Configuration
After selecting your game, the manager needs to know where the game is installed. It usually detects Steam games automatically. If it does not find your game, click Select game folder and navigate to the game’s installation directory manually.
Once the game is detected, the manager creates a dedicated folder structure for that game’s mods. From this point, everything goes through the manager rather than manual file placement.
How to Install Mods with Thunderstore Mod Manager
This is where the tool earns its place in your setup.
- Click Get mods or Online in the left sidebar.
- Browse or search for the mod you want. The search bar is at the top of the mod list.
- Click Download next to the mod. The manager downloads it and installs it automatically.
- If the mod requires other mods to function (dependencies), the manager installs those too without you having to track them down manually.
- Once installed, the mod appears in your Installed list on the left.
- Click Start modded to launch the game with all installed mods active.
Do not use the regular game launcher after installing mods. Always launch through Thunderstore Mod Manager to ensure the mod files load correctly.
Using Profiles in Thunderstore Mod Manager
Profiles are one of the most useful features in Thunderstore Mod Manager and one that beginners often skip.
A profile is a separate collection of mods that can be switched between without affecting other setups. Practical uses:
- Vanilla profile: No mods installed, so you can play the base game or join unmodded multiplayer sessions
- Coop profile: A specific set of mods you and your friends have agreed on for multiplayer
- Testing profile: Where you try new mods without risking your stable main setup
To create a new profile, click your current profile name in the top left corner of the manager and select Create new profile. Name it and give it a clean slate, then install only the mods relevant to that profile.
To share a profile with someone else, use the Export profile option. It generates a code or file that the other person imports into their own Thunderstore Mod Manager to get the exact same mod setup.
How to Update Mods in Thunderstore Mod Manager
Outdated mods are a common cause of crashes and compatibility issues. Thunderstore Mod Manager makes updates straightforward.
- Click Updates in the left sidebar.
- The manager shows you which installed mods have new versions available.
- Click Update all to update everything at once, or click individual mods to update them selectively.
It is worth checking for updates before each gaming session, especially after a game receives a patch, since game updates often break mods that have not been updated to match.
Thunderstore Mod Manager Not Working: Common Fixes
Manager Not Detecting the Game
- Make sure the game is installed through Steam and that Steam is running.
- Click Change game folder and manually point to the correct directory.
- Verify game files through Steam (right-click the game > Properties > Local Files > Verify).
Mods Not Loading In-Game
- Always launch the game through Start modded inside the manager, not the regular Steam launcher.
- Check that all dependencies are installed by looking at the mod’s detail page in the manager.
- Disable mods one by one to find which one is causing the conflict.
Manager Not Downloading Mods
- Check your internet connection.
- Temporarily disable your antivirus or add the Thunderstore Mod Manager folder to the exclusions list. Security software sometimes blocks the download process.
- Restart the manager and try again.
Manager Crashing on Launch
- Uninstall and reinstall the manager.
- Delete the manager’s data folder (usually found in %appdata%/Thunderstore Mod Manager) and reinstall fresh. This clears any corrupted configuration files.
Thunderstore Mod Manager vs. r2modman
Many older guides reference r2modman, which was the predecessor to Thunderstore Mod Manager. The two tools are functionally very similar since Thunderstore Mod Manager was built from the same codebase. The main differences in 2026 are:
- Thunderstore Mod Manager supports a wider range of games
- It has a more actively maintained codebase with more frequent updates
- The interface is slightly cleaner and more modern
If you are starting fresh, use Thunderstore Mod Manager. If you already use r2modman and it works for you, there is no urgent reason to switch, but the Thunderstore Manager is the better long-term choice.
The Short Answer
Thunderstore Mod Manager is the cleanest, most reliable way to manage mods for supported PC games in 2026. Download it from thunderstore.io, select your game, install mods through the Online tab, always launch through Start modded, and use profiles to keep different mod setups organized. For most common issues, the fix is either launching through the manager rather than Steam, updating outdated mods, or adding the app to your antivirus exclusions. Start simple, get comfortable with one profile, then branch out from there.
