bruhnn /BD2ModManager

Brown Dust 2 Mod Manager to help you manage mods.

★ 406⑂ 25👁 2⑃ 44● 51▤ 29
VueGPL-3.0Created 2025-05-31
Download: BD2ModManager v4.3.0BD2ModManager-4.3.0 ↓4.3.02026-11-02
406
stars
25
forks
2
watchers
44
prs
51
issues
29
releases

README

Brown Dust 2 Mod Manager






 🛠 Easily manage, preview, and sync mods for Brown Dust 2.
 
 🎉 Download the latest version: GitHub Releases


If you have suggestions or run into any problems with the app, feel free to open an issue or contact me.

 [!WARNING]
 Before Uninstalling Brown Dust II !!!

 If you use the Symlink sync method, unsync all mods before uninstalling the game. Otherwise, the uninstaller may delete your mods from the staging folder.

---

 🛠️ How to Use
1. Download the app from GitHub Releases.
2. Select your Brown Dust 2 directory (where BrownDust II.exe is located)
   - Example: F:\Neowiz\Browndust2\Browndust2_10000001
3. Install BepInEx and BrownDustX
   - Download both from the BrownDustX Discord:
     discord.gg/B3Aqz6tDG2

   - Manual Steps:
        
      Install BepInEx
      
      Extract the contents of the BepInEx archive into the game folder (you can open the game folder from the mod manager)
      (NOT the launcher folder).
     
      Your folder should look like this:
      text
         Browndust2_10000001/
         ├─ BepInEx/
         ├─ winhttp.dll
         └─ BrownDust II.exe
      
  
       The BepInEx archive from the BrownDustX Discord already includes ConfigurationManager.
   
      Install BrownDustX
     
      Extract the BepInEx folder from BrownDustX-[VERSION].zip
      into the same game folder.
     
      Your folder should look like this:
      text
         Browndust2_10000001/
         ├─ BepInEx/
         │  └─ plugins/
         │     └─ BrownDustX/
         └─ BrownDust II.exe
      
4. Verify the installation
   - Launch the game.
   - On the loading screen, the game version and BrownDustX version should appear in red at the top-right corner.
5. Add your mods by:
   - Moving them into the mods/ folder  
     ⚠️ Note: This is not the BrownDustX mods directory. It's a separate folder used by this manager
6. Enable or disable mods.
7. Sync your mods to apply changes:
   - This will create a folder named BD2MM inside the BrownDustX mods folder with all your enabled mods.

 ⚠️ After making any changes (enable, disable, delete, rename), you must sync your mods to update the game folder.

 Sync Method: Copy vs Symlink

Choose how mods are synced to your BrownDust X mods folder:

 📁 Copy
Copies all enabled mods into the folder.  

- ✅ No admin rights needed
- ❌ Slower
- ❌ Uses more disk space

 🔗 Symlink  
Creates shortcuts instead of copying files.  

- ✅ Much faster
- ✅ Saves disk space
- ❌ Requires admin rights

 Example Comparison (383 mods)

| Copy | Symlink |
|------|---------|
|  |  |

---

 📸 Screenshots

 Mods Page (v4.0.1)
!Mods Page

 Characters Page (v4.0.1)
!Characters Page

 Mod Preview (BD2ModPreview v1.0.0)
!Mod Preview

---

 ❤️ Support the Project

If you enjoy the mod manager and want to support development, you can support me here:

- Ko-Fi: https://ko-fi.com/bruhnn
- Afdian (🇨🇳): https://afdian.com/a/bruhnn

 ❓ FAQ

 Where can I get mods?
You can find mods on the BrownDustX D

Top issues

Discussions

Latest release

BD2ModManager v4.3.0 v4.3.0 2026-11-02
If you have feature suggestions or encounter any issues with the mod manager, feel free to open an issue or contact me @ka. (@bruhnnn) on Discord.

 [!IMPORTANT]
 Sync and unsync were reworked in this update. Please report any problems with syncing, removing mods, or upgrading from an older version.

 [!IMPORTANT]
 本次更新重做了同步和取消同步功能。如果在同步、移除模组或从旧版本升级时遇到问题,请提交 issue。

---- 

 ✨ What's New in v4.3.0

- Added keyboard shortcuts: Space to enable or disable selected mods, Delete to remove them, P to preview one mod, and Ctrl+R to refresh the mod list.
- Added "Compare all" in the charac

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON