Skip to content

bruhnn/BD2ModManager

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 v3.2.0

  • Updated BD2ModPreview to v0.3.0 See Screenshot
    • ✨ Load original character Spine animations directly from GitHub assets
    • ✨ Added Spine folder history feature
    • ✨ Added option to download missing skeleton files from the mod folder (requested by @CalbeeDaLock)
  • 🐛 Fixed Spine animations not working because of Korean characters in atlas (reported by @Love-156)
  • ✨ BD2ModPreview now automatically updates when a new version is available
  • ✨ App update notifications now appear in a pop-up
  • 🐞 Collaboration characters now display as "Unavailable" on the characters page (requested by @CalbeeDaLock)

✨ Features

  • Mod Profiles: Create and manage different mod setups and switch between them.
  • Mod Previews: Double-click any mod to preview its Spine animations.
  • Automatic Game Detection: The manager automatically finds your Brown Dust 2 installation.
  • Automatic Content Updates: New characters and assets are added automatically, eliminating manual updates.
  • Multi-Language Support: Available in Portuguese (pt-BR), Japanese (ja-JP), and Korean (ko-KR) (auto-translated, so might not be perfect).
  • Search mods by name, character, author, or type.
  • Filter mods by status directly on the characters page.
  • One-click install to game folder (symlink or copy).
  • Drag-and-drop to install new mods.
  • Enable/disable mods with a single click.
  • Easily view which characters have each mod type enabled on the characters page.
  • Edit .modfile JSON data directly inside the app.

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

    • Dragging and dropping them into the Mod Manager
    • Or 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.

  • ✅ Works everywhere
  • ✅ No admin rights needed
  • ❌ Slower and uses more disk space

🔗 Symlink

Creates shortcuts instead of copying files.

  • ✅ Much faster, saves space
  • ❌ Requires admin rights

Example Comparison with 200 mods

Copy Symlink

📸 Screenshots

Mods Page (v3.1.0)

Mods Page

Characters Page (v3.1.0)

Characters Page

Mod Preview (BD2ModPreview v0.3.0)

Mod Preview


🧰 Other Tools

If you're looking for alternatives, check out this manager by kxdekxde

❓ FAQ

Where can I get mods?

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

Why is the .exe flagged as a virus?

This is a false positive caused by how PyInstaller packages apps. The program does not contain any malware.
If you're unsure, you can check the source code and build the .exe yourself.

Can I use the app on Linux or macOS?

Currently, BD2ModManager is only tested and built for Windows. No official builds for Linux or macOS are available yet.

What's the difference between the .exe and the *-Bundled.zip version?

  • The .exe is a standalone, single-file version.
  • The .zip is bundled with all required files and less likely to trigger false positives. It's recommended if you run into issues with the single .exe.

How can I contribute to BD2ModManager's development?

You can contribute by:

  • ⭐ Starring the project on GitHub to show your support.
  • 🐛 Reporting bugs and suggesting features via GitHub Issues.
  • 👩‍💻 If you're a developer, fork the repository and submit pull requests with improvements or bug fixes.

🤝 Credits

Star History

Star History Chart

About

Brown Dust 2 Mod Manager to assist you in managing mods.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Languages