BSMG Wiki

Making Mods

Beat Saber does not have built in mod support.

Development for PC and Quest standalone are two vastly different workflows.

PC Mod Development

Injecting Mods

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

For those of you who prefer BepInExopen in new window over either of these options, Bepis has created a loader for BSIPA plugins, available hereopen in new window. As for developing Beat Saber plugins with the BepInEx plugin API, a generic guide exists on their documentation siteopen in new window, but other than that you're kinda on your own.

Project Setup

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?

Check out the links below for documentation relating to Unity and related tooling. If you have any questions, the best place to ask is in the #pc-mod-dev channel on the BSMG Discordopen in new window

Launch args

Helpful launch arguments that will make modding / debugging easier.

Argument              Description
--verboseEnables the output log window for IPA. This will show the debug console that mods use.
fpfc"First Person Flying 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 oculusIf you are running Beat Saber through Steam, this allows you to play the game on an Oculus headset.

Quest Mod Development

The following guide covers most of the concepts you will need for creating mods for the Quest. This includes but is not limited to:

  • Hooking
  • Configuration using config-utils
  • Manual configuration
  • User Interfaces using questui or QUC

Visit the Quest Mod Development Intro page for more information on getting started!