Skip to content
Projects

bruhnn/BD2ModManager

View on GitHub

bruhnn/BD2ModManager has 409 GitHub stars and 25 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-22 09:02 UTC. Last push 2026-11-20.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Brown Dust 2 Mod Manager to help you manage mods.

Developer Tools

README.md

Original

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.

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

If you use the Symlink sync method, unsync all mods before uninstalling the game. Otherwise, the game 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:

         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)

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:

❓ 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

Explore related projects

Loading…