0. Updates

After an update, the BSMG discord #server-announcements channel should have the most up to date instructions on the status of mods. The following are more detailed instructions of the most common procedure.

Update broke my mods

Run the game once on the new update. Then, reinstall your mods using an installer linked in the beginner's guide, preferably Mod Assistant.

1. No mods?

1.1 No mods appear on a fresh copy of the game

First, make sure that the following are correct:

You ran the game once before installing mods. BSIPA removes all mods on the first run of a fresh update to prevent broken old mods from loading on a new version. Reinstall mods again if this is the case.
Steam/Oculus is launching Beat Saber from the same installation that mods are in. e.g. mods are on the D drive but steam is launching from the C drive. Set the correct install location in your choice of installer.
If you installed mods manually, make sure you included all the files from the download and put them in the correct folders, as well as their dependencies.

1.2 I had mods installed on an older version, but nothing loads after an update

If the details in section 1.1 above are correct, try the solutions below, in descending order.

Solution 1

Update BSIPA to the latest version (in ModAssistant or manually)
Go into your Beat Saber folder
Run IPA.exe

Solution 2.

Verify your game files (Steam only, oculus users refer to Solution 4)
Update BSIPA to the latest version
Go into your Beat Saber folder
Run IPA.exe

Solution 3.

Go into your Beat Saber folder
Make a backup of the UserData folder (optional)
Delete UserData

This will reset all plugin settings! {.is-warning}

Solution 4.

Perform a Clean Installation

1.2 Mod Assistant doesn't seem to be installing any plugins

The installers download mods to Beat Saber/IPA/Pending, BSIPA moves these files to root folder when you launch the game. If your game Plugins folder still is empty afterwards, run IPA.exe again and make sure that nothing is preventing it from running, e.g. Anti-viruses, Admin permissions, etc.

2. Game Issues Post-Modding

Game Won't Start

2.1 GetThreadContext Failed Error

If a window pops up saying GetThreadContext Failed and/or you hear a Windows error sound, you may have software on your PC that breaks Beat Saber mods. Many third-party anti-cheat software like ESEA and FaceIt disrupt BSIPA from applying mods to Beat Saber, even when not running. Some Anti-Virus software also exhibit similar behavior.

To solve this problem:

Uninstall the anti-cheat software.
Reboot your PC.
Check if any remnants of the software still exist in your AppData folders.
Run the game. If problems persist then try the following: Additional Note:The problem can continue to persist due to lacking permissions or exceptions, any program that can block bsipa, or programs marked suspicious can make this problem persist Steam: Verify Steam Game Files Oculus: Perform a Clean Installation

This should fix the problem.

2.2 Frozen on Startup

If the game is frozen at the Health and Safety screen, or you see an avatar T-posing with no control of the game, verify your files if you have the game on Steam, or reinstall the game on Oculus Home. Refer to Clean Installation This seems to happen when updating Beat Saber and having mods installed previously, but not to users with clean installs of the game.

Framerate Issues

2.3 The game stutters unbearably after installing mods

If the game lags so badly that you can barely click the Continue button on the Health & Saftey screen, then verify files if you have the game on Steam, or reinstall the game on Oculus Home. Do the same if it won't start up at all and shows no error messages when trying to launch the game.

If that didn't solve the issue, then check section 2.4 Improving framerate

2.4 Improving Framerate

If 2.3 didn't improve your fps, then your PC might simply be struggling to keep up with the stress caused by mods. Here are some things you can do to improve framerate, in no particular order:

NVIDIA GEFORCE EXPERIENCE NOW OPTIMIZES BEATSABER, IT USUALLY SETS YOUR GAMES RENDERING SCALE PAST 1.0 (DEFAULT), USUALLY TO 1.4 OR 1.8. THIS IS THE COMMON REASON FOR LAG RECENTLY.

Use a less complex custom avatar.
The custom saber Plasma Katanas have tons of custom events and are known to introduce lag if you miss.
CameraPlus can be very taxing, especially if you have multiple cameras and increase the FOV.
Turn down Render Scale, Anti-Aliasing, mirror, fog, etc in the base game settings.
For Oculus players: consider using 2 sensors instead of 3+.
Reduce your total mod and song count.
Perform a clean reinstall of the game files. Clean Installation
Low framerate can also be caused by something going wrong within your application data folder, to fix this refer to Deleting The Beatsaber Folder Within Your App Data
CountersPlus counters like scorecounter and swing speed can be expensive. See this github wiki page on performance with Counters+
HTTPStatus mod can cause lag spikes. Test without this mod to see if the lag spikes go away.

VR is very CPU intensive, especially if you add mods. If you're struggling to run the game with the mods you want, consider upgrading your hardware. Note that Beat Saber doesn't utilize the GPU very much as visually it's a fairly simple game.

3. Common Questions

3.1 Blank Menu, No Buttons

If your main window in game is blank, your save file likely got corrupted. To fix this refer to Delete Beatsaber Folder Within Your App Data

Note: This will delete your local scores and statistics. {.is-warning}

3.2 How do I use `x` mod?

If you're using Mod Assistant, click the mod and hit the "Mod Info" button. http://beatmods.com has a "More Info" button on each mod as well.

3.3 Rumble Issues

Gameplay Modifiers Plus adds a toggle to enable/disable controller rumble. If you disabled it then removed the mod, you'll need to modify the configuration file that it writes to manually. Open %appdata%/../locallow/hyperbolic magnetism/beat saber and set controllerRumbleEnabled to true.

If this isn't the cause of your rumble issues and the following are true regarding your haptics:

haptics are miniscule
there is no vibration when hitting multiple blocks
there is a slight delay when touching sabers together
you are using oculus touch controllers

Then there is a good chance that Beat Saber is overloading your motherboard's USB controller. Oculus devours your USB controller bandwidth and most motherboards come with a very cheap controller. Beat Saber pushes it harder than any other game, which is why other games and menus might be fine. There is no clear-cut solution, so try the following:

Shuffle the sensor and HMD USB cables around in different ports
Unplug unecessary USB devices
Buy a PCI-E USB hub
Use -vrmode oculus if you're using SteamVR to bypass it and use the oculus SDK instead

Custom Avatars

3.4 Custom Avatars (Not) Showing Ingame

Click the Home button on your keyboard with the game in focus to toggle visibility in the headset.

3.5 My Avatars Are Broken

Make sure your custom avatars plugin is installed properly and updated, also make sure your dependencies are too. You might have a corrupted/broken avatar, having one avatar break can break all of your avatars likewise with songs and sabers. Refer to Finding Broken Content if you think you have corrupted avatars or if you've made sure your mods and dependencies are updated but avatars still are broken.

Custom Songs

3.6 My Songs Are Missing

Make sure your songs are in your CustomLevels folder, located at Beat Saber/Beat Saber_Data/. This is where the game natively reads custom songs from.

Do not place songs in the old Beat Saber/CustomSongs folder. This location is deprecated as the format for custom songs has changed. If you have maps in the old format (.json and .ogg files instead of .dat and .egg), convert them first using Songe Converter

3.6 Red Play Button

Click the red (?) button in the top right corner. This should tell you what mods are required to play the song, which you are missing. Also try re-installing the plugin again, if that doesn't work reinstall your game, Clean Install

3.7 Map details are infinitely loading

If this only happens on particular maps, those song files are probably broken. If it happens to all of your maps, delete your Plugins folder and reinstall fresh ones.

Camera Plus

3.8 Camera Plus Isn't Working/Past Health Screen

Make sure the setting for "Smooth Camera" is turned off in your ingame settings, If that doesn't work make sure you have the mod installed properly try reinstalling it, and all of its dependencies.

3.9 My desktop view only takes up a small section of the screen

Your CameraPlus display isn't filling up your canvas. Either drag the corner to fit the screen, or right click the window and click "Fit to Canvas".

Beatsaver Downloader

3.10 Beatsaver Downloader More Songs Button

The More Songs button is located in the Mods button in the main menu. If the button for More Songs is greyed out then make sure all your songs loaded first, as seen in the bar on the main menu If your Mods button isn't there then kindly make sure your plugins and dependencies are working and installed properly, refer to No Mods In Game.

3.11 Nothing Showing Up In The More Songs Menu

The probable causes for beatsaver downloader not working are:

Make sure all of your songs have loaded in before, or else the More Songs button will be greyed out.
Your anti-virus or firewall blocking access to beatsaver.

4. Miscellaneous Troubleshooting

Understanding Logs

If you're on Steam you can go to

Beat Saber > Properties > Set Launch Options > Add --verbose to the text field that appears

If you're on Oculus then you will have to Right click on Beat Saber.exe and create a shortcut. Edit the Target to add "--verbose" to the end of it. e.g. C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber\Beat Saber.exe" --verbose

After adding verbose to your game hopefully it will display any errors regarding your avatars, sabers, and songs

This may not show 100% of the time for avatars and sabers, and you may have to remove all your avatars/sabers and try them one by one to see which one breaks the game.

These messages are also written to Beat Saber/Logs.

A list of common exceptions can be found here.

Verify Game Files For Steam

Steam Verify Game Files To verify your game files on steam follow these steps:

Make sure steamvr is closed as it wont let you verify your games otherwise.
Go to your steam library and find Beat Saber
Right click Beat Saber and click on Properties
Go to the "Local Files" tab in properties
Select the last option "Verify Integrity Of Game Files"
Let it finish verifying and downloading any missing files and you should be good to go.

video{.youtube}

Clean Installation

(Optional) Back up your downloaded custom content by making a copy of the following folders:

Beat Saber\Beat Saber_Data\CustomLevels
Beat Saber\CustomSabers
Beat Saber\CustomPlatforms
Beat Saber\CustomNotes
Beat Saber\CustomAvatars

Delete the ENTIRE Beat Saber Folder. This is different from uninstalling the game on steam, as those methods will not remove files that did not come with the game.

Steam: \steamapps\common\Beat Saber\ Oculus: \hyperbolic-magnetism-beat-saber\

Reinstall the game via the Steam or Oculus store
Before modding, launch the game once
Run Mod Assistant, install your mods, and boot up the game.

(Optional) If you want to take it one step further, refer To: Deleting The Beatsaber Folder Within Your App Data

Deleting Your Save in AppData

This will delete your scores and local data, but not your custom leaderboard/ScoreSaber stats. You can find the folder at

%appdata%/../locallow/hyperbolic magnetism/beat saber

Copy and paste everything from inside the bar above and paste it to your address bar in file explorer and delete it.

You can also get to this folder by showing hidden items and navigating to your

Users > "USER" > AppData > Local Low > Hyperbolic-magnetism