Brown Dust 2 Mod Manager (EditVer)

🛠 An edited version of the Brown Dust 2 Mod Manager to 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.

Warning

Before Uninstalling Brown Dust II !!!

If you use the Symlink sync method, unsync all mods before uninstalling the game. Otherwise, the uninstaller may delete your mods from the staging folder.

---

🌟 What's Different in EditVer?

Enhancements not present in the original bruhnn/BD2ModManager v4.1.1:

• 👥 NPC Page (new): Dedicated page for NPC characters, backed by a new npc.json dataset.
• 💕 Dating Page (new): Browse dating costumes with affection tracking, backed by a new dating.json dataset. Toggle visibility via Settings > Interface > Show Dating in Characters.
• 🖼️ Wallpapers Page (new): Manage wallpaper mods in their own page. Wallpaper mods are detected by the "original": "bg" line in the mod file.
• 🧬 Recognize Active Mods (new, experimental): Links mods you already installed in the game's mod directory back to your mod library automatically. Set the active mods directory in Settings > General. Still experimental, so results are not guaranteed to be 100% correct.
• 📦 Mods Tab: Added a "Hide Error Mods" filter (with remembered filter settings), a Wallpaper mod type, an "Only Select One Mod Type" toggle, and a "double-click a row to preview" tip. Mods now sort by Mod Name when that column is selected, and each character allows only one mod per mod type.
• 🎭 Characters Tab: Added an "Only Collab Characters" filter and A-Z sorting.
• 🗂️ Profiles: Edit the Default profile's name and description, and edit your mod list manually.
• ⚙️ Other: A UAC prompt now appears when syncing with the Symlink method.

---

🛠️ 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
   • Install BepInEx: Extract the contents into the game folder (NOT the launcher folder).
   • Install BrownDustX: Extract the BepInEx folder from BrownDustX-[VERSION].zip into the same game folder.
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)

Characters Page (v4.0.1)

Mod Preview (BD2ModPreview)

---

🤝 Credits & Thanks

This project is an edited version of the original Brown Dust 2 Mod Manager.

• Original Creator: bruhnn - Thank you for the amazing work and the original BD2ModManager.
• Character assets: Provided by myssal/Brown-Dust-2-Asset.
• Special Thanks: To Synae for BrownDustX and everyone who contributed to the original project.

---

❓ FAQ

Where can I get mods?

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