Skip to content

bruhnn/BD2ModManager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

436 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Brown Dust 2 Mod Manager

GitHub License GitHub Release Total Downloads

πŸ›  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.


✨ What's New in v4.0.0+

General

  • Complete UI overhaul
  • Added .rar and .7z mod installation support
  • Much smaller file size (from ~164MB β†’ ~60MB)
  • 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. Add your mods by:
    • Noving 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
  • ❌ Drag & Drop not available (Windows restrictions)

πŸ“Έ Screenshots

Mods Page (v4.0.1)

Mods Page

Characters Page (v4.0.1)

Characters Page

Mod Preview (BD2ModPreview)

Mod Preview


🧰 Community & Related Projects

❓ FAQ

Where can I get mods?

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

🀝 Credits

Star History

Star History Chart