Skip to content

Modding your game

Tudor Brindus edited this page May 1, 2018 · 4 revisions

BNSBoost offers easy override of game resources (UPK) files through mods. You may use this to use different voice packs, change models, and so on.

Mods are stored in %appdata%\BNSBoost\mods, and are accessible from the UI under the "Mods" tab.

To add a mod, first click the Open mod folder button, then copy your (extracted) mod into it. Then, Refresh mod list, and finally check the box next to your mod. Your mod will be applied when you click Launch!

Format of a Mod

For compatibility, BNSBoost mods follow the same format as BnS Buddy mods, so you can switch over with minimal effort. A mod consists of a directory, and contained within that directory all the override files, as well as a description.txt. The first line of description.txt is used as a short display in the UI, to give some extra info on the mod.

Under the Hood

Under the hood, when you select a mod, BNSBoost will create a symlink for each file in the selected mod from %appdata%\BNSBoost\mods to %gamedir%\contents\Local\NCWEST\ENGLISH\CookedPC\mods. Since a symlink is basically a "shortcut", this involves no file copying, and as a result enabling/disabling mods is instant.

The launcher hook also adds -UNATTENDED to the game's startup options, which suppresses dialogs regarding ambiguous UPK package names from appearing.