🛠 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.
- 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)
- 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.
-
Download the app from GitHub Releases.
-
Select your Brown Dust 2 directory (where
BrownDust II.exe
is located)- Example: F:\Neowiz\Browndust2\Browndust2_10000001
-
Add your mods by:
- Dragging and dropping them into the Mod Manager
- Or moving them into the
mods/
folder
⚠️ Note: This is not the BrownDustXmods
directory. It's a separate folder used by this manager
-
Enable or disable mods.
-
Sync your mods to apply changes:
- This will create a folder named
BD2MM
inside theBrownDustX
mods folder with all your enabled mods.
- This will create a folder named
⚠️ After making any changes (enable, disable, delete, rename), you must sync your mods to update the game folder.
Choose how mods are synced to your BrownDust X mods
folder:
Copies all enabled mods into the folder.
- ✅ Works everywhere
- ✅ No admin rights needed
- ❌ Slower and uses more disk space
Creates shortcuts instead of copying files.
- ✅ Much faster, saves space
- ❌ Requires admin rights
Copy | Symlink |
---|---|
![]() |
![]() |
If you're looking for alternatives, check out this manager by kxdekxde
You can find mods on the BrownDustX Discord server: https://discord.gg/B3Aqz6tDG2
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.
Currently, BD2ModManager is only tested and built for Windows. No official builds for Linux or macOS are available yet.
- 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
.
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.
- Character assets by myssal/Brown-Dust-2-Asset
- Thanks to Synae for Brown Dust X