Instructions for getting started making mods for Beat Saber.

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 temporarily supported by BSIPA. We still use IPA for the mod tutorial, however it is recommended to use BSIPA for any future modding endeavors.

For those of you who prefer BepInEx over either of these options, Bepis is supposedly working on a BSIPA emulator for BepInEx, and already has one available for regular IPA plugins. As for developing Beat Saber plugins for BepInEx, well, you're kinda on your own.

Need to setup a project?

If you are interested in creating a Beat Saber mod, but do not have a template or Visual Studio template set up, follow the Intro guide to get your project all set up.

Ready to go?

If you have a plugin template ready to go, and don't know how exactly to program a Beat Saber mod, follow the example Modding Tutorial to get a basic grasp on Beat Saber modding.

Want more?

If you've completed the modding tutorial, and still want more ways to improve your mod development experience, check out the Extras page.

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.

Other Links