Beatsaber Multiplayer with Mods: Difference between revisions

From MondoCat.TV Wiki - Welcome Nerds!
(Michelle's stuff)
 
(67 intermediate revisions by 6 users not shown)
Line 1: Line 1:
= PSSST =
* Join our [https://beatleader.xyz/clan/MNDO/1 BEATLEADER CLAN] (Fill out [https://discord.com/channels/676165028168204338/991539613757878332 #Tell-Us-Things] with your profile URL!)


= Prerequisites =
= Prerequisites =
[https://bslegacy.com/ Beat Saber Legacy Launcher] - Click utilities at the top, and download BSLegacyLauncher
[https://github.com/Zagrios/bs-manager?tab=readme-ov-file#how-to-install BSManager] - Download & use for launching modded Beat Saber


[https://github.com/Assistant/ModAssistant/releases/latest Beat Saber Mod Assistant] - Download ModAssistant.exe
Optional: [https://beatsaver.com Beatsaver] - Find songs you'd like to play (Easier to search on PC than in game sometimes!)


[https://beatsaver.com Beatsaver] - Download and bring all the songs you’d like to play


= Current version =
<h1>Current MODDED Version: We are currently using '''Beat Saber 1.40.8''' </h1>
We are currently using '''Beat Saber 1.28.0'''


= Setup guide =
 
{| width="70%" class="menu3" align="center"
<Strike>The closed beta for 1.35.0 is currently undergoing testing. We have also participated in this testing in the past. That said, generally speaking, we're sticking with the old version until at least a public beta is announced. Keep an eye on the BeatTogetherBS twitter for announcements. https://x.com/BeatTogetherBS</strike>
|- style="font-size: 179%;"
| PLEASE NOTE: These instructions require you own the game on Steam. It is currently not possible to play Beat Saber Multiplayer via the Oculus store/app due to a recent Meta software update.
|}


= Disclaimers =
= Disclaimers =
* '''Bring water''', this is a game where you’ll do aerobic exercise, so remember to hydrate.
* '''Bring water''', this is a game where you’ll do aerobic exercise, so remember to hydrate.
* '''If you need a break,''' to your left while in the multiplayer lobby, there’s a toggle to be an “Spectator”. Once turned on you won’t be pulled into the next map to play and you can watch.
* '''If you need a break,''' to your left while in the multiplayer lobby, there’s a toggle to be an “Spectator”. Once turned on you won’t be pulled into the next map to play and you can watch.
* '''Clear some IRL space,''' some maps have obstacles that will require you to move around a little, so make sure there’s nothing you can knock at arms reach or that you can trip on.
* '''Clear some IRL space,''' some maps have obstacles that will require you to move around a little, so make sure there’s nothing you can knock at arms reach or that you can trip on.
* We will be doing songs '''up to expert difficulty with no fail mode on.'''
* We will be doing songs '''up to expert+ difficulty with no fail mode on.''' Everyone will have a chance to choose a song and difficulty that works for them.
* Push yourself only to where you are comfortable. If you need to rest, please do so.
* Push yourself only to where you are comfortable. If you need to rest, please do so.
* If you just want to hang out and listen to music, feel free to just hang out!
* If you just want to hang out and listen to music, feel free to just hang out!
* If you've got a fitness tracker, turn it in and let's compare afterwards!
* If you’ve got a fitness tracker, turn it in and let’s compare afterwards!
* Together as a team we will get in shape! Round is a shape, right?
* Together as a team we will get in shape! Round is a shape, right?


== Setup instructions ==
= Setup guide =
{| class="wikitable" class="menu3" align="center" style="width: 75%;"
[[image:Pasted image 20240507163209.png|400px|right|thumb|Make sure to select the current MODDED version]]
| palign="left"|
<B><Center>PLEASE NOTE: These instructions require you own the game on Steam or the Oculus Store on PC</center></B>
<p>Extract BSLegacyLauncher somewhere it'll live permanently.<br>
* Step 1: Download and install [https://github.com/Zagrios/bs-manager?tab=readme-ov-file#how-to-install BSManager] following the instructions on that page.
#  For convenience, move ModAssistant.exe to the same folder<br>
* Step 2: If it doesn’t start automatically after install, launch BSManager manually.
#  Open up "Beat Saber Legacy Launcher.exe". It may be in a folder called BSLegacyLauncher. It should look something like below.</p>
* Step 3: Select the current MODDED version of beat saber as specified above as the [https://mondocat.tv/wiki/index.php/Beatsaber_Multiplayer_with_Mods#Current_version Current MODDED Version], and then select download. You will have to login using Steam (Or Oculus).  
|| [[image:BSLegacyLauncher Main Page.png | 800px ]]
** Follow the instructions here if you need help authenticating with Oculus. Steam is pretty straightforward, but it might be worth a read if you're still stuck: [https://github.com/Zagrios/bs-manager?tab=readme-ov-file#downloading-multiple-versions Zagrios' guide]
|-
** You may get a message saying that you need to install .NET 6 runtime. Download it by clicking the button and running the installer that automatically downloads.  
|
[[image:Pasted image 20240507163326.png|300px|right|thumb| Do not be alarmed! Install .net if it prompts you to!]]
# Choose "Select Version", select the year along the top, select the version number in the middle, and hit download.  
* Step 4: Once the [https://mondocat.tv/wiki/index.php/Beatsaber_Multiplayer_with_Mods#Current_version Current MODDED Version] of beat saber version is installed, click on it on the left hand side
# See [[Beatsaber Multiplayer with Mods#Current version|Current Version]] to download the correct version for multiplayer.
* Step 5: Go to the mods tab, select the mods listed in the required mods list (below) on this page, and hit “Install or Update” at the bottom right.
|| [[image:BSLegacyLauncher Main Page.png | 800px ]]
*Step 5 again because you may not have read it above: After you select each mod hit INSTALL on the bottom right! (or it wont work!)
|-
<P>
|
==Mods==
# <p>Enter your steam credentials, and then wait while the game downloads.<br>
=== Required Mods ===
#  After the download is complete, back at the main menu, select "Advanced Settings" at the bottom, and then "Browse Game Files". Keep the window that comes up open, and move on to the next step.<br>
■ BeatTogether - Lets you play multiplayer<BR>
|| [[image:BSLegacyLauncher Advanced Settings Browse Game Files.png | 800px ]]</p>
■ MappingExtensions - Displays custom song stuff<BR>
|-
■ Chroma - Custom song stuff <BR>
|
■ NoodleExtensions - Displays custom song stuff <BR>
<p>Extract BSLegacyLauncher somewhere it'll live permanently.<br>
■ Vivify - "Brings your maps to life"<BR>
#  For convenience, move ModAssistant.exe to the same folder<br>
 
#  Open up "Beat Saber Legacy Launcher.exe". It may be in a folder called BSLegacyLauncher. It should look something like below.</p>
=== Recommended Mods ===
|| [[image:BSLegacyLauncher Main Page.png | 800px ]]
■ BetterSongSearch - Helps you find AND display custom songs in the song list<br />
|-
■ BetterSongList - A better song... list! <BR>
|
■ Custom Notes (Changes the appearance of your notes, just remember to enable the setting to auto disable them or else some maps breaks)<br />
<p>Open up ModAssistant.exe, and make sure to read the section completely and follow the instructions on screen. For where to get it, see [[Beatsaber Multiplayer with Mods#Prerequisites]].<br>
■ MultiplayerExtensions (Gives you more settings in the multiplayer arena. Like the ability to use solo environments and hide other players notes, walls and platform)<BR>
#  Instead of going to the mods tab, instead <span style="color:#ed1c24">go to options.</span><br> Under Install folder, <span style="color:#3f48cc">select "Select Folder"</span><br>
■ CustomSabersLite - Custom model for your Sabers, can make it easier to see if you pick a thinner model<BR>
#  From the folder you pulled up from Beat Saber Legacy Launcher, <span style="color:#22b14c">click on some blank space to the right of the folder path, and copy the entire line of text that appears</span><br>
■ SongChartVisualizer - Shows the flow/speeds of the currently playing map<BR>
#  In the "Select your Beat Saber Install folder" window, again <span style="color:#7f7f7f">click on some space to the right of the path</span>, and paste the path you copied in the previous step.<br>
 
#  Hit the <span style="color:#a349a4">Save button</span> towards the bottom</p>
===Beat Leader Mods===
|| [[image:BS Mod Manager Select Install Folder.png | 800px | Left ]]
■ BeatLeader Group - https://beatleader.xyz/clan/MNDO (Submit a ticket with your username to be added!)<BR>
|-
■ BeatLeader - For leaderboard submission to BeatLeader and the Clan<BR>
| Now in the mods tab, check off the various mods indicated in [[Beatsaber Multiplayer with Mods#Mods]], and then hit "Install or Update" towards the bottom right. You at least need the required mods, but you are also able to install other mods as you see fit. Bear in mind additional mods may cause issues with multiplayer, especially those under the gameplay category.
■ ScoreSaber - For leaderboard submission to ScoreSaber<BR>
 
=== Extra Mods ===
■ Camera2 (third person camera in the desktop window, useful for streaming)<br />
■ [https://mondocat.tv/wiki/index.php/Beatsaber_Multiplayer_with_Mods#Importing_Your_Avatar Custom Avatars] (Import your Unity model into Beat Saber, primarily useful in conjunction with Camera2)<BR>
■ [https://mondocat.tv/wiki/index.php/Beatsaber_Multiplayer_with_Mods#Song_Request_System_(Song_Request_Manager) Song Request Manager] (Lets your friends/twitch viewers request songs)<br />
 
=== Want EVEN MOAR mods? ===
* [https://beatmods.com/#/mods Beatmods] - Check at your own risk! If things break in game, disable extra mods!
 
== DONT INSTALL THIS MOD ==
* BeatSaviourUI also breaks Multiplayer, in 1.39.1 at least


    {| class="menu1" align="center"
== Launching the Game ==
    |
[[image:Pasted image 20240528175222.png|300px|Right|thumb|BSManager in your start menu]]
    == Required Mods ==
# Launch BSManager, which you installed by going through the instructions in the Setup Guide above. If you’re not sure, try searching your start menu for it. <br />
    |-
# On the left, select the appropriate <B> [https://mondocat.tv/wiki/index.php/Beatsaber_Multiplayer_with_Mods#Current_version Current MODDED Version] </B> of Beat Saber<br />[[image:Pasted image 20240528175506.png|300px|Right|thumb|Check current MODDED version for your correct version]]
| style="text-align:left;" |
# Click Launch <br />[[image:Pasted image 20240528175542.png|300px|Right|thumb|LAUNCHTIME]]
    <p>
BeatTogether<br>
    Chroma<br>
    MappingExtensions<br>
    NoodleExtensions<br>
    BSIPA*<br>
    BeatSaberMarkupLanguage*<br>
    SongCore*<br>
    BeatSaverSharp*<br>
    SiraUtil*<br>
    MultiplayerCore*<br>
    <i><nowiki>*</nowiki>If using the Beat Saber mod assistant, these mod will be selected automatically when selecting the other mods.</i></p>
    |-
    |
    == Recommended mods ==
|-
| style="text-align:left;" |
    <p>
    BetterSongSearch (Helps you find songs within beat saber much easier than using the website)<br>
    Camera2 (third person camera in the desktop window, useful for streaming)<br>
    Custom Avatars (Import your Unity model into Beat Saber, primarily useful in conjunction with Camera2)</p>
    |-
    |}


|| [[image:BS Mod Manager Mods Tab.png | 800px ]]
<P>
|-
<center>[[image:beatsaber_big.png|650px]]</center>
| colspan="2" | You are now ready to play!
<P>
|-
<PRE>
|}




== Launching the game ==
&nbsp;
# Ensure SteamVR is running
&nbsp;
# Start Beat Saber Legacy launcher (NOT THROUGH STEAM)
&nbsp;
# Ensure the correct game version is selected
&nbsp;
# Hit launch
&nbsp;
# Select Play Online (& Ensure Beat Together is selected)
TIME TO BEAT IT!
[[image:BSLegacyLauncher With Installed Version Main Page.png | 640px ]]
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;
&nbsp;


== Importing your avatar ==
</PRE>
* If you want to import your own model into BeatSaber you’ll need to download the Unity project from the next link and prepare it: [https://github.com/nicoco007/BeatSaberCustomAvatars BeatSaber Custom Avatars github]
* Here's a video about the process of turning a model into a .avatar file and using it into BeatSaber: https://www.youtube.com/watch?v=G3Id_zuhiqY


=Errors & How To Fix Them=
== “This song is not owned by all players” ==
== “This song is not owned by all players” ==
From what we’ve seen, this is very likely due to the song requiring certain mods, if it’s giving an error along the lines of “This song is not owned by all players”, please send us the name or link to it so we can list it here and hopefully figure out what we might be missing to be able to play it. Make sure you have all the required mods listed above.
From what we’ve seen, this is very likely due to the song requiring certain mods, if it’s giving an error along the lines of “This song is not owned by all players”, please send us the name or link to it so we can list it here and hopefully figure out what we might be missing to be able to play it. Make sure you have all the required mods listed above.
==Something just DOESNT WORK==
* Make sure you are launching through BS Manager
* Make sure Mod Assistant's options > Install Folder is pointed TOWARDS THE BS LEGACY LAUNCHER INSTALLATION FOLDER, <B> NOT THE STEAM INSTALLATION! </B>
* Make sure after you select the mods in Mod Assistant, click "Install"! They are NOT installed just simply by clicking them.
==Required/Some Mods Not Appearing In Mod Assistant==
* Launching the game once (through BS Manager!) and it should show the full list of mods in the Mod Assistant if they do not appear for you!
* Some of the mods might not be supported in that version </3.
=Song Request System (Song Request Manager)=
There exists a Beat Saber Song Request Mod that enables your friends or Twitch stream viewers to send you song requests directly!
*<B>NOTE: YOU DO NOT HAVE TO BE STREAMING FOR PEOPLE TO USE THIS!</B>
==SRM Setup Guide==
{| class="wikitable" class="menu3" align="center" style="width: 75%;"
| palign="left"|
* 1) Install CatCore <U>and</U> websocket-sharp from Mod Assistant <B>(Make sure to hit "Install" after selecting them!)</B>
* 2) Install Enhanced Stream Chat from https://github.com/denpadokei/EnhancedStreamChat-v3/releases/latest <U>and</U> Song Request Manager from https://github.com/Krayn/SongRequestManager/releases/latest
* 3) <B>Run the game through BS Legacy Launcher</B> and go to http://localhost:8338/ in your web browser. (You have to be in the main menu!)
* 4) Login with twitch by clicking the LOGIN ON TWITCH button and then hit save.
* 5) Go to https://beatsaver.com/ to find the songs
* 6) In Streamlabs Chat Box or your Twitch Chat (YOU DO NOT HAVE TO BE STREAMING) type: <B><U>!bsr (NAME OF SONG) or !bsr (SONG ID)</B></U>
** The Song ID is in the URL: For example: https://beatsaver.com/maps/c6cb
** So, !bsr Revenge - Captain Sparklez or !bsr c6cb
* 7) Go in game and download it from the twitch queue system (SRM Icon) and play :3
| [[image:beatsaber2.png|300px|thumb|How To Request A Song]]
| [[image:beatsaber.png|300px|thumb|How To Queue A Requested Song]]
|}
= Importing Your Avatar =
* If you want to import your own model into BeatSaber you’ll need to download the Unity project from the next link and prepare it: [https://github.com/nicoco007/BeatSaberCustomAvatars BeatSaber Custom Avatars github]
=Thanks=
Thanks to:
*Michelle for [https://docs.google.com/document/d/1lBNdXMKnKrR7bbiPuzHr8Ld7BJ6eIvy9A8TpoaJXOzc/edit the original guide] and hosting Beat Saber for many weeks! <3 <3
*Rekka for working on the original guide <3 <3
*[https://mondocat.tv/wiki/index.php?title=Beatsaber_Multiplayer_with_Mods&action=history Everyone who worked on this page] <3 <3
* JaySee & Kojso for hosting it in 2024/2025 <3

Latest revision as of 15:31, 5 August 2025

PSSST

Prerequisites

BSManager - Download & use for launching modded Beat Saber

Optional: Beatsaver - Find songs you'd like to play (Easier to search on PC than in game sometimes!)


Current MODDED Version: We are currently using Beat Saber 1.40.8


The closed beta for 1.35.0 is currently undergoing testing. We have also participated in this testing in the past. That said, generally speaking, we're sticking with the old version until at least a public beta is announced. Keep an eye on the BeatTogetherBS twitter for announcements. https://x.com/BeatTogetherBS

Disclaimers

  • Bring water, this is a game where you’ll do aerobic exercise, so remember to hydrate.
  • If you need a break, to your left while in the multiplayer lobby, there’s a toggle to be an “Spectator”. Once turned on you won’t be pulled into the next map to play and you can watch.
  • Clear some IRL space, some maps have obstacles that will require you to move around a little, so make sure there’s nothing you can knock at arms reach or that you can trip on.
  • We will be doing songs up to expert+ difficulty with no fail mode on. Everyone will have a chance to choose a song and difficulty that works for them.
  • Push yourself only to where you are comfortable. If you need to rest, please do so.
  • If you just want to hang out and listen to music, feel free to just hang out!
  • If you’ve got a fitness tracker, turn it in and let’s compare afterwards!
  • Together as a team we will get in shape! Round is a shape, right?

Setup guide

Make sure to select the current MODDED version
PLEASE NOTE: These instructions require you own the game on Steam or the Oculus Store on PC
  • Step 1: Download and install BSManager following the instructions on that page.
  • Step 2: If it doesn’t start automatically after install, launch BSManager manually.
  • Step 3: Select the current MODDED version of beat saber as specified above as the Current MODDED Version, and then select download. You will have to login using Steam (Or Oculus).
    • Follow the instructions here if you need help authenticating with Oculus. Steam is pretty straightforward, but it might be worth a read if you're still stuck: Zagrios' guide
    • You may get a message saying that you need to install .NET 6 runtime. Download it by clicking the button and running the installer that automatically downloads.
Do not be alarmed! Install .net if it prompts you to!
  • Step 4: Once the Current MODDED Version of beat saber version is installed, click on it on the left hand side
  • Step 5: Go to the mods tab, select the mods listed in the required mods list (below) on this page, and hit “Install or Update” at the bottom right.
  • Step 5 again because you may not have read it above: After you select each mod hit INSTALL on the bottom right! (or it wont work!)

Mods

Required Mods

■ BeatTogether - Lets you play multiplayer
■ MappingExtensions - Displays custom song stuff
■ Chroma - Custom song stuff
■ NoodleExtensions - Displays custom song stuff
■ Vivify - "Brings your maps to life"

Recommended Mods

■ BetterSongSearch - Helps you find AND display custom songs in the song list
■ BetterSongList - A better song... list!
■ Custom Notes (Changes the appearance of your notes, just remember to enable the setting to auto disable them or else some maps breaks)
■ MultiplayerExtensions (Gives you more settings in the multiplayer arena. Like the ability to use solo environments and hide other players notes, walls and platform)
■ CustomSabersLite - Custom model for your Sabers, can make it easier to see if you pick a thinner model
■ SongChartVisualizer - Shows the flow/speeds of the currently playing map

Beat Leader Mods

■ BeatLeader Group - https://beatleader.xyz/clan/MNDO (Submit a ticket with your username to be added!)
■ BeatLeader - For leaderboard submission to BeatLeader and the Clan
■ ScoreSaber - For leaderboard submission to ScoreSaber

Extra Mods

■ Camera2 (third person camera in the desktop window, useful for streaming)
Custom Avatars (Import your Unity model into Beat Saber, primarily useful in conjunction with Camera2)
Song Request Manager (Lets your friends/twitch viewers request songs)

Want EVEN MOAR mods?

  • Beatmods - Check at your own risk! If things break in game, disable extra mods!

DONT INSTALL THIS MOD

  • BeatSaviourUI also breaks Multiplayer, in 1.39.1 at least

Launching the Game

BSManager in your start menu
  1. Launch BSManager, which you installed by going through the instructions in the Setup Guide above. If you’re not sure, try searching your start menu for it.
  2. On the left, select the appropriate Current MODDED Version of Beat Saber
    Check current MODDED version for your correct version
  3. Click Launch
    LAUNCHTIME



 
 
 
 
 
TIME TO BEAT IT!
 
 
 
 
 
 

Errors & How To Fix Them

“This song is not owned by all players”

From what we’ve seen, this is very likely due to the song requiring certain mods, if it’s giving an error along the lines of “This song is not owned by all players”, please send us the name or link to it so we can list it here and hopefully figure out what we might be missing to be able to play it. Make sure you have all the required mods listed above.

Something just DOESNT WORK

  • Make sure you are launching through BS Manager
  • Make sure Mod Assistant's options > Install Folder is pointed TOWARDS THE BS LEGACY LAUNCHER INSTALLATION FOLDER, NOT THE STEAM INSTALLATION!
  • Make sure after you select the mods in Mod Assistant, click "Install"! They are NOT installed just simply by clicking them.

Required/Some Mods Not Appearing In Mod Assistant

  • Launching the game once (through BS Manager!) and it should show the full list of mods in the Mod Assistant if they do not appear for you!
  • Some of the mods might not be supported in that version </3.

Song Request System (Song Request Manager)

There exists a Beat Saber Song Request Mod that enables your friends or Twitch stream viewers to send you song requests directly!

  • NOTE: YOU DO NOT HAVE TO BE STREAMING FOR PEOPLE TO USE THIS!

SRM Setup Guide

Importing Your Avatar

  • If you want to import your own model into BeatSaber you’ll need to download the Unity project from the next link and prepare it: BeatSaber Custom Avatars github


Thanks

Thanks to: