Quickstart
Download the app and get your first mod running in minutes.
Installation
System requirements and step-by-step install instructions.
Game directory
How to locate and configure your Brown Dust 2 install path.
First launch
What to expect the first time you open BD2 Mod Manager.
What is BD2 Mod Manager?
Brown Dust 2 loads mods through BrownDustX, a BepInEx-based mod loader that reads loose files from amods/ directory inside your game installation. BD2 Mod Manager sits on top of this system and provides:
- A staging directory where you keep your mod archives. Mods in staging are never touched by the game directly.
- A Sync operation that copies (or symlinks/hardlinks) only your enabled mods from staging into the
BepInEx/plugins/BrownDustX/mods/BD2MM/folder the game reads. - Enable/disable toggles so you can switch mods on and off without deleting files.
- Conflict detection that flags mods overwriting the same character or asset files.
BD2 Mod Manager requires BrownDustX to be installed in your game directory. You can install it directly from the BrownDustX tab inside the app.
Who it’s for
BD2 Mod Manager is aimed at Brown Dust 2 players on Windows who want to run multiple mods without manually moving files or worrying about which mods conflict. It is especially useful if you:- Switch between different mod sets (profiles) for different characters or playstyles.
- Use mods from the BrownDustX Discord or community creators.
- Want to preview spine animations and textures before enabling a mod.
- Prefer a GUI over manually managing files in Explorer.
Key capabilities
Mod management
Enable, disable, rename, delete, and preview mods. Sort and filter by name, character, or status.
Conflict detection
Automatically flags mods that edit the same files so you can resolve conflicts before syncing.
Profiles
Save named mod configurations and switch between them instantly.
Characters tab
Browse all game characters in a grid, filter by name or mod type, and manage mods per character.
BrownDustX integration
Detect and install BepInEx and BrownDustX directly from within the app.
Mod preview
Preview spine animations and textures using the integrated BD2ModPreview tool before enabling.
How syncing works
When you click Sync, BD2 Mod Manager:- Reads your staging directory and collects all enabled mods.
- Creates (if needed) the
BepInEx/plugins/BrownDustX/mods/BD2MM/folder inside your game directory. - Copies (or symlinks/hardlinks, depending on your sync method) each enabled mod’s files into
BD2MM/. - Removes any previously-synced mods that are now disabled.
- The game’s mod loader picks up the files in
BD2MM/on next launch.
BD2MM/ without deleting it from your staging directory, so you can re-enable it at any time.