The Witcher 3 Mod Manager
witcher-3 — Mods & Enhancements
The Witcher 3 Mod Manager (W3MM) is a standalone desktop application (not a script mod) that provides a GUI to install, uninstall, enable/disable, and merge mods for The Witcher 3: Wild Hunt. It handles the game's mod folder structure, .zip/.rar archives, and even integrates with the game's official mod support, allowing you to manage over 100 mods without manually editing the 'mods.settings' file or using Script Merger. It also offers a 'Mod Conflict Detector' that flags overlapping file conflicts (e.g., two mods modifying the same XML), and can automatically invoke Script Merger for script conflicts, making it essential for players with complex mod lists like the popular 'W3EE' or 'Enhanced Edition' setups.
📦 Full mod page on discovermods
Downloads, ratings, compatibility info, installation guides, and user reviews.
View on discovermods →Syntax
UtilitiesExample
Downloads: 1,464,062 | Endorsements: 53,358💡 Notes
By stefan3372 and SullivanMcBlueberry | v0.10.1 | 53,358 endorsements
🎯 Tips & Tricks
If you've downloaded a mod that isn't in the W3MM database (e.g., from Nexus Mods with loose files), click 'File > Import Mod' and select the folder containing the mod's 'mods' subfolder. This ensures the mod is tracked, and you can enable/disable it without manually moving folders in 'The Witcher 3/mods'.
Go to 'Options > Settings > Script Merger' and point to your 'Script Merger.exe' path (usually in the game's directory or a separate install). Then, after installing a new mod, click 'Tools > Run Script Merger' directly from W3MM. This saves time and prevents the 'script compilation errors' that occur when two mods modify the same .ws file (e.g., 'modAutoApplyOils' and 'Enhanced Targeting').
Before the game's Next-Gen update (v4.0), go to 'File > Export Mod List' to save a .json file with all your mods and their versions. After updating, use 'File > Import Mod List' to reinstall all mods in one click, but be aware that some mods (like 'Friendly HUD') may need updates; W3MM will flag these as 'incompatible' with a warning, allowing you to skip them.
🔧 Troubleshooting
Mod list becomes empty after a game update (e.g., from 1.31 to 4.0) because W3MM doesn't recognize the new game version.
Force W3MM to rescan by going to 'Options > Game Directory' and re-selecting your game folder. If that fails, manually delete the 'mods.settings' file in 'Documents/The Witcher 3' and restart W3MM—it will rebuild the list from the 'mods' folder, but you'll need to re-enable mods manually.
Mods installed via W3MM don't appear in the game's Mods menu (in-game mod list), causing them to not load.
W3MM sometimes places mods in a 'Mods' subfolder that the game ignores. Check 'Options > Installation Path' and ensure it's set to 'The Witcher 3/mods' directly, not a subfolder. Also, verify that the mod folder names start with 'mod' (e.g., 'modAutoApplyOils')—if not, rename them using W3MM's 'Rename Mod' feature.
⚠️ Common Mistakes
- [object Object]
- [object Object]
👍 Pros
- 53,358 endorsements
- 1,464,062 downloads
- Category: Utilities
👎 Cons
- Requires mod manager installation
- May conflict with similar mods