Skip to main content
Mods for Brown Dust 2 are shared in the BrownDustX Discord server. You can join at discord.gg/B3Aqz6tDG2.The server has dedicated channels where mod authors post character mods, costume replacements, and other modifications. Download the archive or folder from there, then install it using BD2 Mod Manager.
No. These are two separate locations.
  • mods/ staging directory — A folder managed by BD2 Mod Manager where you store and organize your mod files. This is where you add, rename, and delete mods inside the app. It does not affect the game directly.
  • BrownDustX mods folder — Located at <game_dir>/BepInEx/plugins/BrownDustX/mods/BD2MM/. This is where the game reads active mods from. BD2 Mod Manager populates this folder when you run Sync.
Adding a mod to the staging directory does not make it active in the game. You must enable it and then sync.
Sync reads your current list of enabled mods from the staging directory and applies them to the game’s mod folder using the sync method you have configured (Copy, Symlink, or Hardlink).It also removes any previously synced mods that are now disabled, and writes a manifest file at <game_dir>/.bd2mm.json that tracks what was synced.Any time you enable, disable, delete, or rename a mod, you need to sync for those changes to take effect in the game.
No. BD2 Mod Manager only writes to the <game_dir>/BepInEx/plugins/BrownDustX/mods/BD2MM/ folder and the .bd2mm.json manifest. It does not patch, replace, or modify any original game files.Mods are loaded by the BrownDustX plugin at runtime, which intercepts the game’s asset loading. Removing or unsyncing all mods leaves the original game files intact.
Use Profiles. A profile saves the current enabled/disabled state of all your mods under a name you choose.
1

Create a profile

Go to the Profiles section and create a new profile with a descriptive name, such as “PvP build” or “Story mode”.
2

Switch profiles

Select a different profile from the list. The app restores that profile’s enabled mod states.
3

Sync

After switching, click Sync to apply the new configuration to the game folder.
BD2MM/ is the folder BD2 Mod Manager creates at <game_dir>/BepInEx/plugins/BrownDustX/mods/BD2MM/ to hold your synced mods.It is entirely managed by the app. Do not manually add, remove, or edit files in this folder — any manual changes will be overwritten the next time you sync.
BD2 Mod Manager supports .zip, .rar, and .7z archives as of v4.0.0. Drag the archive onto the app window or use the Install mod button and the app will extract it into the staging directory automatically.You can also add a mod by dropping an already-extracted folder directly into the mods/ staging directory.
Auto-sync must be enabled in Settings. Go to Settings and toggle on Auto sync mods on enable/disable.When enabled, the app syncs immediately after every toggle. If it is off, you need to click Sync manually after making changes.
Brown Dust 2 does not have a built-in modding API. BepInEx is a general-purpose mod loader for Unity games, and BrownDustX is the plugin that hooks into the game’s asset loading to apply texture and animation mods.Without both installed, the game has no mechanism to load the mod files that BD2 Mod Manager syncs. You can install both directly from the BrownDustX tab in the app.
BD2 Mod Manager is an open-source tool licensed under GPL-3.0. The source code is available at github.com/bruhnn/BD2ModManager.Modding is done entirely client-side and does not interact with game servers or modify network traffic. However, any modding carries inherent risk and the developers of BD2 Mod Manager do not provide any guarantee against account action. Use at your own discretion.

Build docs developers (and LLMs) love

Get started for freeTalk to us