Beat Saber IPA (BSIPA)

How to manage, configure and work with BSIPA.

BeatSaber IPA (BSIPA) is the mod loader used by Beat Saber mods. It's responsible for actually loading all the mods you install with Vortex and needs to be installed for other mods to work correctly.

Some of the features that BSIPA provides overlap a bit with Vortex and BeatVortex's feature sets, so it's worth knowing a few things first.

Game Upgrade Detection aka Mod Yeeting

Plugin Yeeting refers to a feature in BSIPA intended to simplify game ugprades. When BSIPA detects that the game itself has been updated since BSIPA last ran, it will move all your installed plugins into a special folder in your install directory to ensure that incompatible mods aren't loaded after an upgrade. This process is called “yeeting”.

While this isn't a problem if you're manually installing mods (or presumably using Mod Assistant), when BSIPA does this Vortex will lose track of the files it deployed to the install directory and think you deleted them. If BSIPA does “yeet” your mods, you'll see a dialog in Vortex asking you whether you really want to delete all the files in your mod folders (no, you don't).

BeatVortex will now also detect when Beat Saber has been upgraded and offer to disable all your currently installed mods (except for BSIPA) until you can run your game (thus updating BSIPA) and you can then re-enable your mods once you've verified they are compatible with the latest game version.

Plugin/mod Updates

Also, by default, BSIPA will auto-update your mods when you launch the game. While this won't bother Mod Assistant, this means that the mods in your install directory won't be the same ones Vortex put there. This means a) your in-game mods might not be the same versions you have installed with Vortex and b) Vortex might ask you to save/revert changes made by BSIPA when you next deploy.

Like with OneClick installs, things will go a lot smoother if you have only one app handling updates, so we recommend disabling updates in BSIPA or in BeatVortex depending on which one you want handling updates.

Even if BeatVortex's updates are disabled, Vortex will still prompt you to save/revert the changes made when BSIPA updates your mods

Configuration Tweaks

This feature is available in v0.3.3 or later

Since these overlapping areas can sometimes cause problems, BeatVortex includes the ability to apply overrides/tweaks to the BSIPA configuration file when you deploy your mods. Check the Workarounds tab of the Settings page to find them. Enabling these tweaks will edit Beat Saber IPA.json to disable certain features when you deploy.

Disabling plugin yeeting will set the YeetMods value of the configuration file to false, disabling BSIPA's plugin yeeting entirely. We don't recommend using this unless you are running into problems as BeatVortex's own game update detection should help you through the upgrade process without getting in BSIPA's way.

Disabling plugin auto-updates will set the Updates.AutoCheckUpdates and Updates.AutoUpdate values of the configuration file to false, disabling BSIPA's automatic plugin updates entirely. We recommend turning this on if you're using Vortex to handle your BeatMods plugin updates as it will mean that your installed version is the version you see in-game, and BSIPA won't update mods that you haven't updated in Vortex.

Last modified January 1, 0001