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 DTop issues
#105Feature request: Add the ability to download the original image of the currently frozen frame in mod preview4 comments · 2026-11-10#107模组为符号链接识别失效问题0 comments · 2026-11-14
Discussions
#75BD2ModManager v4.2.0-beta1 comments · 2026-06-30#27BD2ModManager v3.2.40 comments · 2025-07-26#24BD2ModManager v3.2.30 comments · 2025-07-25#22BD2ModManager v3.2.20 comments · 2025-07-21#21BD2ModManager.exe v3.2.11 comments · 2025-07-20
Latest release
BD2ModManager v4.3.0 v4.3.0 2026-11-02If 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