How To Update Thunderstore Mod Manager: A Complete Step-by-Step Guide

Updating Thunderstore Mod Manager typically occurs automatically through its integration with the Overwolf application framework during standard system launches. When automated patches fail to deploy, forcing an update requires clearing background tasks in Windows Task Manager, executing the latest setup file, or manually exporting profiles to prevent configuration corruption. Ensuring your client remains updated maintains critical API compatibility for modded titles such as Lethal Company, Risk of Rain 2, and Valheim.

Pre-Update Protocol & System Setup Checklist

Before initiating an update to the Thunderstore Mod Manager, verifying system readiness prevents data loss, configuration overwrites, and dependency conflicts. Because Thunderstore acts as an orchestration layer for game modifications—managing BepInEx frameworks, native dynamic-link libraries (DLLs), and custom JSON manifests—updating the manager software while games or background services are active can corrupt local profile databases.

Executing a pre-update validation protocol minimizes the risk of profile loss. Standard modding setups store profile data within dedicated directories, but an incomplete client upgrade can occasionally break the binding between the manager GUI and the local file system.

Pre-Update Requirements Matrix

• Essential System Credentials & Tools:
  
  
  • Windows Administrator privileges to permit file writes within protected program folders.
  • An active internet connection with unrestricted access to the Thunderstore and GitHub repositories.
  • A compressed archive utility (such as 7-Zip or WinRAR) for emergency manual file extraction.
• Mandatory Prerequisites:
  
  
  • All modded game instances (e.g., Lethal Company, Valheim, Dyson Sphere Program) must be completely closed.
  • The Overwolf platform overlay must be fully shut down via the system tray or Task Manager.
  • Mod profiles must be backed up using the native export tool or manually copied from the local storage path.
• Target Metrics & Benchmarks:
  
  
  • Estimated Duration: 2 to 5 minutes for automated patches; 5 to 10 minutes for manual reinstallation.
  • Disk Overhead: Minimum 250 MB free space on the primary OS drive for installation temp files.
  • Network Bandwidth: Minimum 15 Mbps download rate to prevent timeout during package extraction.

Step-by-Step Thunderstore Mod Manager Update Execution

Modding platforms require precise execution during maintenance cycles. Follow these sequential steps to update your Thunderstore Mod Manager while preserving your active mod profiles, custom configurations, and launch parameters.

Step 1: Force Complete Application & Background Process Closure

The automated update mechanism cannot replace system files that are currently locked by active Windows processes. Closing the user interface window does not always terminate the underlying Overwolf daemon or the Thunderstore background agent.

1. Right-click the Windows Taskbar and select Task Manager (or press Ctrl + Shift + Esc).
2. Navigate to the Processes tab and locate Overwolf and Thunderstore Mod Manager.
3. Select each related process entry and click End Task at the top right of the window.
4. Expand the system tray in the lower-right corner of your desktop, right-click the Overwolf icon, and select Exit.

Warning: Never force an update while your target game is open. Modded game processes hold open handles on injected DLL files located in the BepInEx directory, which can cause severe file system locks and incomplete manager updates.

Step 2: Trigger Automated Updates via the Overwolf Host

Under standard operating conditions, Thunderstore Mod Manager relies on the Overwolf framework to fetch and install version updates automatically.

1. Launch the Overwolf client desktop shortcut.
2. Click the gear icon in the top-left corner to access Settings.
3. Select the About menu item from the left-hand sidebar.
4. Click the blue Check for updates button. If an Overwolf platform update is found, allow it to complete and restart the host.
5. Navigate to the Apps tab inside Overwolf, locate Thunderstore Mod Manager, and verify if an update banner appears alongside the application title.
6. Click Launch; if a patch is pending, Thunderstore will show an overlay indicating that new files are being unzipped and applied.

Step 3: Perform a Manual Binary Replacement (Overwriting Setup)

If the automated channel fails, encounters network timeouts, or remains stuck on an outdated build version, you must perform a direct executable overwrite.

1. Open your web browser and navigate to the official Thunderstore Mod Manager distribution page on the Overwolf App Store or the official GitHub repository.
2. Download the latest installer file (e.g., Thunderstore_Mod_Manager_Installer.exe).
3. Open Windows File Explorer and navigate to your Downloads directory.
4. Right-click the downloaded executable file and select Run as administrator.
5. Follow the installation wizard prompts. The installer will automatically detect your existing installation path (typically located within %localappdata%\Overwolf\CustomizationData or %appdata%\Thunderstore Mod Manager) and overwrite outdated core binaries without erasing user profile data.

Pro-Tip: If the installer prompts you to overwrite configuration settings, select "Keep existing settings" to preserve your custom mod profiles and game installation paths.

Step 4: Verify Post-Update Integrity & Mod Package Sync

Once the installation finishes, launch the manager to verify platform health and ensure mod manifest integrity.

1. Open Thunderstore Mod Manager from your desktop or via the Overwolf overlay.
2. Observe the bottom-left corner of the interface to verify that the version string matches the latest release tag.
3. Select your target game profile (e.g., Default profile for Lethal Company).
4. Navigate to the Installed tab on the left panel.
5. Look for an orange icon next to individual mods indicating out-of-date packages.
6. Click Update all to align your mod dependencies with the newly updated manager version.

Updating Method Comparison & Technical Specifications

Selecting the appropriate updating procedure depends on your current operating environment, system permissions, and network stability. The following table highlights the operational characteristics of each update path.

Common Update Failures & System Remedies

During the update cycle, specific system conflicts can prevent files from copying correctly or break the link between your mod profiles and the manager core engine. Use these field-tested diagnostic protocols to resolve update failures.

Failure Scenario 1: The Installer Freezes at 0% or Returns Network Access Errors

• Root Cause: Windows Defender Firewall, third-party antivirus utilities, or active VPN connections block the installation setup file from establishing a secure connection to the download mirror server.
• Actionable Fix:
  
  
  • Temporarily suspend real-time antivirus protection prior to running the setup executable.
  • Open Windows Defender Firewall with Advanced Security, create an outbound rule allowing the installation program binary full network access, and re-run the setup as Administrator.
  • Disable active VPN interfaces or switch to a direct DNS provider (e.g., Cloudflare DNS 1.1.1.1) to bypass host resolution errors.

Failure Scenario 2: Profiles Disappear or Render as Empty After the Update

• Root Cause: The installer wrote core files to a different local directory, breaking the pointer path to your local profile storage directory.
• Actionable Fix:
  
  
  • Press Windows Key + R to open the Run dialog box.
  • Type %appdata%\Thunderstore Mod Manager\DataFolder and hit Enter.
  • Verify that your game folders (e.g., RiskOfRain2, LethalCompany) are present inside the profiles subfolder.
  • Inside the Thunderstore Mod Manager application, navigate to Settings > Change Data Folder, and point the application directly back to this directory path.

Failure Scenario 3: Overwolf Launch Daemon Fails to Trigger the Application

• Root Cause: Corrupted local cache files or broken registry entries within the main Overwolf overlay framework.
• Actionable Fix:
  
  
  • Fully close Overwolf using the Windows Task Manager.
  • Press Windows Key + R, type %localappdata%\Overwolf, and press Enter.
  • Locate the Cache and BrowserCache folders and delete them.
  • Restart Overwolf, right-click the app icon, and click Repair App if prompted.

Failure Scenario 4: BepInEx Framework Fails to Inject Into Game Processes Post-Update

• Root Cause: An application update reverted custom game directory paths or reset execution flags required for DLL injection.
• Actionable Fix:
  
  
  • Open Thunderstore Mod Manager and select your specific profile.
  • Go to Settings > Locations and confirm that Change Steam directory and Change Game directory accurately target your installed game files.
  • Click Modded at the top right of the client UI to force the app to regenerate the dynamic launch arguments inside Steam or the Epic Games Launcher.

Frequently Asked Questions

Does updating Thunderstore Mod Manager delete my installed mods?

No, updating the application binary does not wipe your installed mod files, local settings, or custom profiles. Profile configurations and mod packages are stored in separate AppData directories. However, creating a profile backup code via the app settings before major version updates is always recommended.

How do I update r2modman instead of Thunderstore Mod Manager?

While r2modman shares the same underlying open-source interface as Thunderstore, it operates without the Overwolf platform layer. To update r2modman, launch the application to allow its built-in auto-updater to download the patch, or download the latest setup executable directly from its GitHub releases page and run it over your current version.

Why does Thunderstore show an available update but fail to download it?

This problem usually occurs when background Overwolf services are locked, disk space is insufficient, or an active antivirus program flags temporary files. Terminate all related software processes in Task Manager, run the application using administrator permissions, and ensure your system drive has ample free storage space.

Can I update individual game mods without updating the main manager?

Yes, you can update individual mods by opening your active profile, clicking the Installed menu tab, and selecting Update next to outdated mod packages. However, older manager versions may lack API capabilities required by newer mod updates, which can occasionally lead to launch errors.

How do I manually back up my mod profiles before performing a full client reinstall?

Open Thunderstore Mod Manager, select your target profile, and navigate to Settings. Scroll down to the profile management options and select Export profile as code to generate an alphanumeric profile string, or select Export profile as file to save a .r2z backup archive file locally.

Optimize Your PC Gaming & Modding Workflow

Keeping your mod manager updated ensures maximum stability, seamless mod dependency management, and instant access to new community-created features across your favorite PC games. Stay ahead of game updates by routinely checking for software patches and backing up your active mod profiles prior to major game releases.