Ultimate Guide to Beat Saber Plugins

BEAT SABER TIPS

INTRODUCTION TO PLUGINS

BEGINNERS GUIDE TO MODDING BEAT SABER

 

Modding intro image

 

What are plugins?

Plugins are software components that users (like you) install separately into a game directory to customize it with features not available in its original state.

Who are the modders?

Modders are the community members who built the plugins / mods you’re using. They are not the game developers, they are mod developers.

 

 

-SUPER IMPORTANT UPDATE-

Beat Saber Modding Group has just issued an announcement saying the mod repository – ModSaber has shut down. Now they have released a new mod installer that grabs from the also new repository – beatmods

Beat Saber Mod Manager (BeatMods edition)

 

 

 This means all mods / plugins will need to be installed manually. This video explains how in 100 seconds.

 

 

Here are the latest instructions to installing mods manually: https://wiki.assistant.moe/beginners-guide

Here is every mod available as of today: https://pastebin.com/Bcm85dpd

 

 

[ IMPORTANT NOTE ]

If you mod your game, there is a chance that it will break right after an update. Give it some time and refer to the tips below.

Any issue you encounter with a modded game should not be directed to Beat Saber / Beat Games social media pages. Reach out to Beat Saber Modding Group (BSMG) in #support channel for assistance & troubleshooting. Remember to adhere to the rules – https://discord.gg/beatsabermods

 

The community may assist wherever possible, but ultimately you are the one responsible for your gaming experience. READ Mod Info before attempting a Download. “Do not bite off more than you can chew.”

 

There is also a Modding Community Wiki that provides detailed information on almost everything you’ll find useful : https://wiki.assistant.moe/beginners-guide

 

The people who made all these awesome stuff can often be found in the BSMG Discord server. When you see them, feel free to give some constructive feedback or just simply say thanks. That will make their day.

 

 

TL;DR

The list of available plugins updates frequently. Today you may see things looking slightly different than in this guide. Tomorrow they might take on a different name or even become irrelevant. That is why guides like this are either hard to find or outdated. I will update this guide as often as I can until there is a ‘fix’, but for now here’s a quick tips as easy as 1, 2, 3, 4 :

 

  1. When in doubt, re-run your mod installer (Refer next section)
  2. If that doesn’t work, reinstall the game and then repeat Step 1 (remember to backup your custom songs etc before uninstalling)
  3. If issue still persists, find us on BEASTSABER Discord or Beat Saber Modding Group (BSMG) Discord server

4-minute Guide to Modding

 

 

ModSaber Installer

Modsaber Installer v1.3.3 Dark Theme

 

 

Mod Manager 

 

Mod Manager v2.2.3

 

ModSaber Installer and Mod Manager are two different versions of application that serve the same purpose. They are almost a necessity when performing modifications to Beat Saber – especially for beginners. They serve as your go-to one click application that houses plugins from the repository (https://www.modsaber.org), and will Install or Update your plugins automatically into the Plugins folder. You need only ONE of them so choose whichever that suits your taste.

 

Option 1

To install ModSaber Installer, go to https://github.com/lolPants/modsaber-installer/releases and click on the modsaber-installer-setup-x.x.x.exe link; the one with the ‘Latest Release’ tag. Next, save the application somewhere easily accessible on your computer and then double click to open.

 

Option 2

To install Mod Manager, go to https://github.com/Umbranoxio/BeatSaberModInstaller/releases and click on the BeatSaberModManager.exe link; the one with the ‘Latest Release’ tag. Next, save the application somewhere easily accessible on your computer and then double click to open.

 

So now that you have one of the installers open, the rest is simple.

  1. Make sure the folder path at the top correctly matches where your game is installed
  2. Click on the plugin Name you’re interested in and read its Mod Info
  3. Understand the instructions/information written
  4. Tick the checkbox next to its name and leave the associated Libraries checked
  5. Click the “Install / Update” button and run the game

 

Advanced users: The latest version of plugins you have are sometimes sitting in a queue awaiting approval for quality control purposes. They go through a strict process of testing before being released to us – users. If you feel impatient, you can look up their respective github pages, if any, or download from the #finished-mods channel in BSMG Discord server.

 

 

Core Plugins

Song Loader Plugin

(https://www.modsaber.org/mod/song-loader)

If you’re here to get custom songs, the Song Loader plugin is what you need. It is already checked and locked in both installers so you can skip a few steps and just click the “Install / Update” button. This will create a CustomSongs folder in your game directory along with some additional files that will enable the game to run custom songs.

 

Here is another guide with additional info; https://bsaber.com/installing-the-mod-guide-necessary-for-any-custom-songs/

SongloaderSongloader2

 

 

Score Saber

(https://www.modsaber.org/mod/scoresaber/)

This is an independent plugin that stores all your best scores with or without modifiers upon completing custom songs into the scoresaber website. Installing this plugin allows you to compare scores with your friends and other players in the global leaderboard. If you don’t have this installed, score submission will be limited to only  your Original Soundtrack (OST) songs while your custom songs scores will be recorded locally (in your computer).

Website : https://scoresaber.com

Scoresaber

 

 

BeatSaver Downloader

(https://www.modsaber.org/mod/beatsaverdownloader/)

Download custom songs in game without having to take your VR headset / HMD off.

BeatSaver DownloaderBeatSaver Downloader2

 

 

Camera Plus

(https://www.modsaber.org/mod/camera-plus/)

A less shaky version of the mirrored Beat Saber window from your HMD. If you’re setting up for a demo or if you are streaming your gameplay, this is a must have. There is an option to capture in third person view and the window also doesn’t turn black when you take the headset off.

 

Song Browser

(https://www.modsaber.org/mod/songbrowserplugin/)

Additional sorting and searching options among other useful features. Find latest instructions in Mod Info.

SongBrowser

 

 

 

Cosmetic Changes

Custom Sabers

(https://www.modsaber.org/mod/custom-saber/)

Once you install the plugin and run the game, a CustomSabers folder will be created. This is where your favourite custom models from https://modelsaber.com/ are placed.

You can manually Download the models or directly Install them. Directly installing means you don’t need to manually drag the downloaded custom model into the CustomSabers folder. To perform the “Install” method successfully, you will need the ModSaber Installer.

CustomSabers

 

 

Custom Avatars

(https://www.modsaber.org/mod/custom-avatars/)

Once you installed the plugin and run the game, a CustomAvatars folder will be created. This is where your favourite custom models from https://modelsaber.com/ are placed.

You can manually Download the models or directly Install them. Directly installing means you don’t need to manually drag the downloaded custom model into the CustomAvatars folder. To perform the “Install” method successfully, you will need the ModSaber Installer.

Press Home key to toggle show/hide your avatar in HMD & press PgUp / PgDn to scroll through your avatar list. Find latest instructions in Mod Info.

CustomAvatar

 

 

Custom Platforms

(https://www.modsaber.org/mod/custom-platforms/)

Once you installed the plugin and run the game, a CustomPlatforms folder will be created. This is where your favourite custom models from https://modelsaber.com/ are placed.

You can manually Download the models or directly Install them. Directly installing means you don’t need to manually drag the downloaded custom model into the CustomPlatforms folder. To perform the “Install” method successfully, you will need the ModSaber Installer.

 

Custom Colors

(https://www.modsaber.org/mod/custom-colors/)

Allows you to customize the colors in Beat Saber. Find latest instructions in Mod Info.

 

 

Gameplay Changes

Beat Saber Challenges

(https://www.modsaber.org/mod/bs-challenges/)

This mod adds challenges to the game where you must play with certain modifiers, fulfill certain requirements, or both for a given map. Currently there are Custom Campaigns and Daily Challenges. Find latest instructions in Mod Info.

 

Darth Maul Plugin

(https://www.modsaber.org/mod/darthmaul/)

Reference to Star Wars. If you know one, you will recognize the other. Find latest instructions in Mod Info.

 

Gameplay Modifiers Plus

(https://www.modsaber.org/mod/gameplay-modifiers-plus/)

“Massive pile of stuff. 1/4 of the plugin is for streamers, 1/6 or so quality of life stuff, and about 14/24 options for ways to make gaem funner” – Kyle 1413

Find latest instructions in Mod Info.

 

Hidden Blocks

(https://www.modsaber.org/mod/hidden-blocks/)

If you are familiar with how the Disappearing Arrows modifier looks like in the game, this one takes it one step further – the blocks disappear. Find latest instructions in Mod Info.

 

 

Libraries

The ones you see under Libraries category are tied to certain plugins because of dependencies. They are there to make certain mods work and do nothing on their own. You don’t have to worry about downloading these if you have either ModSaber Installer or Mod Manager installed, since they should auto-select them if necessary for the plugins you were getting.

 

If you do end up having them installed, simply follow the instructions in Mod Info if needed.

 

Async Twitch Library

(https://www.modsaber.org/mod/asynctwitchlib/)

 

Beat Saber Utils

(https://www.modsaber.org/mod/bs-utils/)

 

CustomUI

(https://www.modsaber.org/mod/customui/)

 

Harmony

(https://www.modsaber.org/mod/harmony/)

 

Ini File Parser

(https://www.modsaber.org/mod/ini-parser/)

 

Newtonsoft.JSON

(https://www.modsaber.org/mod/newtonsoft-json/)

 

 

Lighting Changes

ChromaLite

(https://www.modsaber.org/mod/chromalite/)

Enables special colours in maps lighting as well as some other special events for Mappers. You may see a message or indicator stating that it conflicts with another Lighting mod like Rainbow Lighting and this means they cannot coexist. Find latest instructions in Mod Info.

 

Rainbow Lighting

(https://www.modsaber.org/mod/rainbow-mod/)

Randomizes the background lighting in songs for a more colorful experience. You may see a message or indicator stating that it conflicts with another Lighting mod like ChromaLite and this means they cannot coexist. Find latest instructions in Mod Info.

 

 

Multiplayer

Unofficial Multiplayer

(https://www.modsaber.org/mod/beatsaber-multiplayer/)

Play against other players in real time. Find latest instructions in Mod Info.

 

 

Practice / Training

CountersPlus

(https://www.modsaber.org/mod/countersplus/)

A mod that feed you live information on parameters of your gameplay that you enable as you play through a song. Find latest instructions in Mod Info.

 

Full Combo Display

(https://www.modsaber.org/mod/fullcombodisplay/)

Display a ring around your combo multiplier if you haven’t missed a block. Find latest instructions in Mod Info.

 

Hit Score Visualizer

(https://www.modsaber.org/mod/hitscorevisualizer/)

Colors the score popups that appear after hitting notes. Also adds judgement text above (or below) the score. Find latest instructions in Mod Info.

 

Intro Skip

(https://www.modsaber.org/mod/introskip/)

Allows you to skip intros and outros of songs with no significant events that affect scoring. Find latest instructions in Mod Info.

 

Notes Left Counter

(https://www.modsaber.org/mod/notesleftcounter/)

Shows you how many notes are left in the song as you progress. Find latest instructions in Mod Info.

 

Perfection Display

(https://www.modsaber.org/mod/perfectiondisplay/)

Displays how many in a range of scores per block you’ve hit or missed to the results screen. Find latest instructions in Mod Info.

 

Practice Plugin

(https://www.modsaber.org/mod/practice-plugin/)

Control playback speed, seek through songs, set up looping sections and more. Find latest instructions in Mod Info.

 

 

Stream Tools

This category is for people who stream their gameplay or run a demo with attention to detail.

Enhanced Twitch Chat

(https://www.modsaber.org/mod/enhanced-twitch-chat/)

Adds a chat window of your Twitch channel in game and allows your viewers to request songs by typing certain commands. Also useful for other players & spectators in your gaming session to follow the conversation. Song requests require TwitchOAuthToken so only the streamer has the ability to moderate it. Find latest instructions in Mod Info.

Formatting example in game folder > UserData > EnhancedTwitchChat.ini:
TwitchChannelName=”ag0za”
TwitchUsername=”ag0za”
TwitchOAuthToken=”oauth:xxxxxxxxxxxx”
FontName=”Segoe UI”
……………….(cont)…………………

 

HTTP Status

(https://www.modsaber.org/mod/http-status/)

Enables the building of custom stream overlays that displays the song name and player’s performance in real time. There are other potential use cases for modders but stream overlay is what most of us will use this for. Find latest instructions in Mod Info.

 

Song Status

(https://www.modsaber.org/mod/song-status/)

Writes currently playing song status to a text file that can be read by programs like OBS. This behaves similar to HTTP Status stream overlay in functionality but they use different approach. Find latest instructions in Mod Info.

 

 

Text Changes

Custom Fail Text

(https://www.modsaber.org/mod/customfailtext/)

Changes the text when you fail a song. Find latest instructions in Mod Info.

 

Custom Menu Text

(https://www.modsaber.org/mod/custommenutext/)

Customizes the “BEAT SABER” menu text to different wording. Find latest instructions in Mod Info.

 

Custom Miss Text

(https://www.modsaber.org/mod/custommisstext/)

Changes the text that appears when you miss a note. Find latest instructions in Mod Info.

 

 

Tweaks / Tools

Beat Saber Tweaks

(https://www.modsaber.org/mod/beat-saber-tweaks/)

Extra settings options to tweak some variables that you never knew you needed. Find latest instructions in Mod Info.

 

Custom Menu Music

(https://www.modsaber.org/mod/custom-menu-music/)

Changes the music in the menu. Find latest instructions in Mod Info.

 

Particle Overdrive

(https://www.modsaber.org/mod/particle-overdrive/)

Controls the nature and amount of particles to be displayed, generally related to PC performance. Find latest instructions in Mod Info.

 

In Game Song Library Refresher

(https://www.modsaber.org/mod/song-refresher/)

Very simple plugin that adds a button in game to refresh your song library.

 

 

Other

BloomMod

(https://www.modsaber.org/mod/bloom-mod/)

Customize internal bloom effect parameters of each cameras in-game. Find latest instructions in Mod Info.

 

SyncSaber

(https://www.modsaber.org/mod/syncsaber/)

Keeps your songs up to date, optionally downloads the newest releases from your favorite mappers, as well as content from your bookmarks on BeastSaber. Find latest instructions in Mod Info.

 

YUR Fit Calorie Tracker

(https://www.modsaber.org/mod/yurfit/)

Counts your active calories while playing Beat Saber. Find latest instructions in Mod Info.

 

Mapping Extension

Enables custom maps with more than the the default 4×3 grid. Find the latest version in BSMG Discord server – #finished-mods channel.

Mapping Extensions

Comments (1)
  1. Funky says:

    Just delete all the outdated information! I am new to the game and you have made things ten times more difficult with all the conflicting information in here. I still haven’t got ANY mods to work. This page is useless

    (5)

Leave a Reply

Your email address will not be published. Required fields are marked *