Skip to main content
BD2 Mod Manager supports installing mods from compressed archives (.zip, .rar, .7z) and from plain folders. Both methods extract or copy the mod into the app’s staging directory, where it appears in the Mods tab.

​
Install from archive

Use this method when you have downloaded a mod as a .zip, .rar, or .7z file.
1

Open the install dialog

Click the Install mod button in the Mods tab toolbar, then choose From archive.
2

Select the archive file

Browse to and select your .zip, .rar, or .7z archive in the file picker.
3

Wait for extraction

BD2 Mod Manager extracts the archive into the staging directory. A success notification appears when the install is complete.
4

Verify the mod

The new mod appears in the Mods tab. Check the Errors column to confirm the mod was extracted correctly.
If the archive is password-protected, extraction will fail. Download the mod again and ensure you have the correct, unprotected archive.

​
Install from folder

Use this method when you already have a mod extracted on disk, or when a mod is distributed as a plain folder rather than an archive.
1

Open the install dialog

Click the Install mod button in the Mods tab toolbar, then choose From folder.
2

Select the mod folder

Browse to and select the folder that contains the mod files (the folder with the .modfile and spine/texture assets).
3

Confirm

BD2 Mod Manager copies the folder into the staging directory. The mod appears in the Mods tab once the copy is complete.

​
Staging directory structure

All installed mods are stored in the staging directory. BD2 Mod Manager scans this directory on launch and whenever you add a new mod. 
mods/
├── Luvia_Standing_v2/
│   ├── .modfile
│   ├── Luvia_standing.atlas
│   ├── Luvia_standing.skel
│   └── textures/
│       └── Luvia_standing.png
└── Elena_Cutscene/
    ├── .modfile
    └── ...
Each mod must be in its own subfolder inside the staging directory. If the mod’s files are placed directly in the root staging directory without a containing folder, BD2 Mod Manager reports a ShouldBeInFolder error.

​
Supported archive formats

.zip

Standard ZIP archive. Most commonly used for mod distribution.

.rar

RAR archive. Widely used on modding communities like Nexus and Discord.

.7z

7-Zip archive. High compression ratio, common for larger spine mod packs.

​
Install errors

If installation fails, BD2 Mod Manager returns one of the following errors:
ErrorCause
PathNotFoundThe source archive or folder path no longer exists.
InvalidNameThe archive or folder name is empty or cannot be used as a mod name.
InvalidFormatThe archive is corrupted or cannot be read.
ModAlreadyExistsA mod with the same name already exists in the staging directory.
InvalidModNo .modfile was found inside the archive or folder — the mod structure is not recognized.
MultipleModsFoundThe archive contains more than one .modfile, so the app cannot determine which is the root mod.
UnsupportedFormatThe file extension is not .zip, .rar, or .7z.
After installation, refresh the mod list using the Discover mods button if the new mod does not appear immediately.

Build docs developers (and LLMs) love

Get started for freeTalk to us