CustomNotes adds the ability to swap out the default notes with custom ones in Beat Saber.
Download the latest version of CustomNotes from any current mod manager or the Github releases page.
You can install custom note files (.bloq
files) in the CustomNotes
folder found in your game's directory. If this folder doesn't exist, make sure to run the game with the mod installed so it can be automatically generated.
To change which note model is used, simply select a different note in the CustomNotes mod tab in-game.
While a custom note is being used AND you are either playing with the "Ghost Notes" or "Disappearing Arrows" modifier turned on, score submission will be temporarily disabled.
By switching to the default notes, enabling "Auto Disable Custom Notes" or turning off these modifiers, score submission will be re-enabled. No need for a game restart!
The Unity Project to create custom notes can be found here
Documentation on how to use the Unity Project can be found on the BSMG Wiki
In order to build this project, please create the file CustomNotes.csproj.user
and add your Beat Saber directory path to it in the project directory.
This file should not be uploaded to GitHub and is in the .gitignore.
<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<PropertyGroup>
<!-- Set "YOUR OWN" Beat Saber folder here to resolve most of the dependency paths! -->
<BeatSaberDir>E:\Program Files (x86)\Steam\steamapps\common\Beat Saber</BeatSaberDir>
</PropertyGroup>
</Project>
If you plan on adding any new dependencies which are located in the Beat Saber directory, please edit the paths to use $(BeatSaberDir)
in CustomNotes.csproj
...
<Reference Include="SiraUtil">
<HintPath>$(BeatSaberDir)\Plugins\SiraUtil.dll</HintPath>
</Reference>
<Reference Include="IPA.Loader">
<HintPath>$(BeatSaberDir)\Beat Saber_Data\Managed\IPA.Loader.dll</HintPath>
</Reference>
...