Skip to main content
General settings control where BD2 Mod Manager looks for your game, where it stores mods, and how it keeps itself up to date. Open the Settings tab to access these options.

Directories

The folder that contains BrownDust II.exe. BD2 Mod Manager must know this path before it can sync mods.When syncing, enabled mods are written to:
<game_directory>/BepInEx/plugins/BrownDustX/mods/BD2MM/
A sync manifest is also stored at:
<game_directory>/.bd2mm.json
BD2 Mod Manager cannot sync mods until a valid game directory is set. You will be prompted to set this on first launch.
The folder where BD2 Mod Manager stores all installed mods before they are synced to the game. Defaults to the application data directory.You can point this to a custom location — for example, a faster drive or a shared folder. BD2 Mod Manager will look for mod archives and extracted mod folders here.
If you move your staging directory, copy or move your existing mods manually to the new location before updating this setting.

Appearance

SettingOptionsDefaultDescription
Languageen_US, othersen_USDisplay language for the UI.
Themedark, lightdarkColor theme for the application window.

Sync behavior

Controls how enabled mods are applied to the game folder. See Sync methods for a full comparison.
ValueDescription
copyCopies mod files into the game folder. No admin rights required.
symlinkCreates directory symlinks. Fast and space-efficient; requires admin rights on Windows.
hardlinkCreates hardlinks to mod files. Space-efficient without the symlink admin requirement.
When enabled, mods are synced to the game folder automatically whenever you enable or disable a mod in the Mods tab. When disabled, you must click Sync manually.Default: off
When enabled, BD2 Mod Manager scans subdirectories inside the staging folder when looking for mods. Useful if you organize mods into subfolders.Default: off

Update settings

BD2 Mod Manager checks the GitHub releases API on startup and notifies you when a new version is available. You can skip a specific version to suppress the notification without disabling update checks entirely.Default: onThe releases endpoint is configurable via Releases URL (see Advanced settings below).
Automatically fetches the latest character and mod-type data from the configured manifest URL when BD2 Mod Manager starts. This keeps character icons and metadata current without manual intervention.Default: on
Automatically refreshes mod preview images when game data is updated or a mod is modified.Default: on

Advanced settings

These settings let you point BD2 Mod Manager at a self-hosted or forked data source. Changing them is not required for normal use.
The URL from which BD2 Mod Manager downloads character and game data. Defaults to the official raw GitHub URL for the bruhnn/bd2modmanager repository.Change this only if you are hosting your own game data manifest or testing a fork.
The GitHub API endpoint used to check for new BD2 Mod Manager releases. Defaults to https://api.github.com/repos/bruhnn/bd2modmanager/releases.Change this only if you are running a fork and want update checks to target a different repository.
The skip_update_version field is set automatically when you choose to skip a specific release from the update notification dialog. You do not need to edit it manually.

Build docs developers (and LLMs) love