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)

<details> <summary>See full changes in v4.0.0</summary>

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

</details>

---

🛠️ 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. 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
4. Enable or disable mods.
5. 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 | |------|---------| | <img src="./screenshots/sync_copy_v405.gif" width="260" /> | <img src="./screenshots/sync_symlink_v405.gif" width="260" /> |

---

📸 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

<a href="https://www.star-history.com/#bruhnn/BD2ModManager&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bruhnn/BD2ModManager&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bruhnn/BD2ModManager&type=Date" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=bruhnn/BD2ModManager&type=Date" /> </picture> </a>