Skip to main content

Quick Start

Download the app and get your first mod running in minutes.

Installing Mods

Add mods from ZIP, RAR, 7z archives or folders.

Sync Methods

Choose between Copy, Symlink, and Hardlink sync modes.

BrownDustX

Detect and install BepInEx and BrownDustX directly from the app.

What is BD2 Mod Manager?

BD2 Mod Manager is a desktop application for Windows that lets you install, organize, enable, disable, and sync mods for Brown Dust 2. Built with Tauri and Vue, it provides a fast, lightweight interface for managing your entire mod library.
BD2 Mod Manager requires BrownDustX to be installed in your game directory. The app can install it for you from the BrownDustX tab.

Key features

Mod management

Enable, disable, rename, delete, and preview mods from a single interface with sorting and filtering.

Conflict detection

Automatically flags mods that edit the same character or files so you can resolve conflicts before syncing.

Characters tab

Browse characters in a grid view, filter by name or mod type, and manage mods per character directly.

Profiles

Save named mod configurations and switch between them instantly without re-enabling mods manually.

Mod preview

Preview spine animations and textures directly using the integrated BD2ModPreview tool.

Auto-sync

Optionally sync mods automatically whenever you enable or disable them, keeping your game up to date.

How it works

1

Download and launch

Get the latest release from GitHub Releases and run the installer.
2

Set your game directory

Point the app to the folder where BrownDust II.exe is located, for example F:\Neowiz\Browndust2\Browndust2_10000001.
3

Add mods

Drop mod archives or folders into the app’s mods/ staging directory, or drag them directly onto the app window.
4

Enable and sync

Toggle mods on or off in the Mods tab, then hit Sync to apply changes to the game directory.

Community & resources

Build docs developers (and LLMs) love