Instructions for modding Beat Saber

Installing Mods

If you have no mods installed, visit the Beginners Guide.

To install other mods that you have downloaded or made, place the plugin into your Plugins folder within the Beat Saber install directory.
Can't find where Beat Saber is installed? See: Install Folder.

Making Mods

Beat Saber does not have built in mod support.

Instead, most mods within the mod installer rely on BSIPA (Beat Saber Illusion Plugin Architecture) to inject plugins into the game, as well as providing some useful tools for us modders.

Previously, we used IPA (Illusion Plugin Architecture). Some plugins still use this, and is still temporarily supported by BSIPA. It is recommended to use BSIPA for any future modding endeavors, however.

Launch args

Helpful launch arguments that will make modding / debugging easier.

Argument Description
--verbose Enables the output log window for IPA. This will show the debug console that mods use.
fpfc "First Person Flight Controller" This allows you to use WASD and the mouse to navigate around the menu in game. This makes testing much easier, because you don't have to put on your headset!
-vrmode oculus If you are running Beat Saber through Steam, this allows you to play the game on an Oculus headset.

Mods Index

Slaynash created an incredible spreadsheet of mods - you can view it here.
We're working on getting the ModSaber archive organized, so hopefully we can have links to those mods in the future!

Other Links