Skip to main content
The BrownDustX tab lets you check whether the required mod-loading infrastructure is present in your game directory and install it with one click if it is not. BD2MM syncs mods into the BrownDustX plugin directory, so both BepInEx and BrownDustX must be installed before mods will load in-game.

​
How BD2MM uses BrownDustX

When you sync your mods, BD2MM writes them to: 
<game_dir>/BepInEx/plugins/BrownDustX/mods/BD2MM/
BrownDustX then reads from its mods/ folder at runtime: 
<game_dir>/BepInEx/plugins/BrownDustX/mods/
This means the full stack must be in place:
1

BepInEx installed

BepInEx must be present at <game_dir>/BepInEx/. It is the mod loader that hooks into the Unity runtime. Key files include BepInEx/core/BepInEx.dll and winhttp.dll in the game root.
2

BrownDustX plugin installed

The BrownDustX plugin must be present at <game_dir>/BepInEx/plugins/BrownDustX/lynesth.bd2.browndustx.dll. It handles BD2-specific asset replacement.
3

BD2MM syncs mods

BD2MM places enabled mods into the mods/BD2MM/ subdirectory that BrownDustX monitors.

​
Status detection

The BrownDustX tab automatically checks your configured game directory for the presence of each component and shows a status for each:

BepInEx

Detected when <game_dir>/BepInEx/core/BepInEx.dll and <game_dir>/winhttp.dll both exist. Status values: INSTALLED, NOT_INSTALLED.

BrownDustX plugin

Detected when <game_dir>/BepInEx/plugins/BrownDustX/lynesth.bd2.browndustx.dll exists. Status values: INSTALLED, NOT_INSTALLED, BEPINEX_MISSING.

ConfigurationManager

Optional plugin that adds an in-game configuration UI. Detected when <game_dir>/BepInEx/plugins/ConfigurationManager/ConfigurationManager.dll exists.
The detection check reads your configured game directory. If you have not set your game directory yet, go to Settings → General and set the path to the folder containing BrownDust II.exe before using this tab.

​
Installing BepInEx

If BepInEx is not detected, click Install BepInEx in the BrownDustX tab. BD2MM will:
  1. Download the correct BepInEx release for Brown Dust 2.
  2. Extract it into your game directory, placing BepInEx/core/BepInEx.dll, doorstop_config.ini, and winhttp.dll in the game root.
  3. Write a manifest file at <game_dir>/BepInEx/.bd2mm_bepinex_manifest.json to track the installed version and files.
  4. Re-run the detection check and update the status indicator.
You can also install from a local archive by providing a path to a BepInEx ZIP file. The app validates the archive before extraction.

​
Installing BrownDustX

If the BrownDustX plugin is not detected (or after you have just installed BepInEx), click Install BrownDustX. BD2MM will:
  1. Download the latest BrownDustX plugin release.
  2. Extract it to <game_dir>/BepInEx/plugins/BrownDustX/, including lynesth.bd2.browndustx.dll and required resource files.
  3. Write a manifest at <game_dir>/BepInEx/plugins/BrownDustX/.bd2mm_bdx_manifest.json.
  4. Re-run the detection check and update the status indicator.
You must install BepInEx before installing BrownDustX. If BepInEx is missing, the Install BrownDustX button will be disabled.

​
Installing ConfigurationManager (optional)

ConfigurationManager adds a configuration panel accessible in-game (usually via F1). To install it, click Install ConfigurationManager. BD2MM will:
  1. Extract the plugin to <game_dir>/BepInEx/plugins/ConfigurationManager/ConfigurationManager.dll.
  2. Write a manifest at <game_dir>/BepInEx/plugins/ConfigurationManager/.bd2mm_configmanager_manifest.json.
BepInEx must be installed first. ConfigurationManager is an optional convenience plugin and is not required for mods to work.

​
Uninstalling components

Components installed by BD2MM can also be removed from this tab. Each installed component shows a Remove button when:
  • The component was installed by BD2MM (a BD2MM manifest file exists).
  • The installed version matches the manifest version.
You cannot remove BepInEx while BrownDustX or ConfigurationManager are still installed. Remove plugins first, then remove BepInEx.
Uninstalling reads the installed_files list from the manifest and deletes each recorded file. Empty directories are cleaned up automatically.

​
Verifying the installation

After installation both BepInEx and BrownDustX status indicators should show as detected. Launch Brown Dust 2 once so BepInEx can complete its first-run initialization, then return to BD2MM and sync your mods.
If a status indicator remains undetected after installation, confirm that your game directory in Settings → General points to the folder containing BrownDust II.exe and not a subfolder inside it.

Build docs developers (and LLMs) love

Get started for freeTalk to us