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.

---

✨ Major Update (v4.0.0)

See full changes in v4.0.0

General

• Complete UI overhaul
• Added .rar and .7z mod installation support
• Much smaller file size (from ~164MB → ~50MB)
• Much faster performance (sync, unsync, and other operations)

Mods Tab

• Conflict indicator (flags mods that edit the same character/files)
• Mod type icons
• Character icons (head)
• Context menu: select all, enabled, or disabled mods

Characters Tab

• Grid view
• Filters by name, mod types (cutscene, dating, standing, etc.)
• Sort by name, release date, or number of mods
• Filter by release period (last week, 2 weeks, month, etc.)
• View and enable/disable a character's mods directly

BrownDustX Tab (new)

• Detect BepInEx and BrownDustX plugin installation
• Install BepInEx and BrownDustX directly from the app

Settings Tab

• Auto sync mods on enable/disable
• Show/hide columns (mod name, character, mod type, author)
• Mod name display: name only or with subfolders
• Character column: icon only, name only, or both
• Mod type column: icon only, name only, or both
• Optional color coding for mod types

---

🛠️ 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:

        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:

        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)

Characters Page (v4.0.1)

Mod Preview (BD2ModPreview)

---

❤️ 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
• 🇨🇳: https://afdian.com/a/bruhnn

---

🧰 Community & Related Projects

• Brown Dust II Mod Manager (by kxdekxde) – An alternative mod manager for Brown Dust 2
• BD2 Live2D Viewer (by jelosus2) – Website to preview character animations
• BDroid_X (by Ark-Repoleved) - Brown Dust II Mod Manager for Android

❓ FAQ

Where can I get mods?

You can find mods on the BrownDustX Discord server: https://discord.gg/B3Aqz6tDG2

🤝 Credits & Thanks

• Character assets by myssal/Brown-Dust-2-Asset
• Thanks to Synae for BrownDustX
• Thanks to everyone who contributed by reporting bugs and suggesting features.
  

✨ Star History