Skip to content

Change various aspects of the default Beat Saber note

License

Notifications You must be signed in to change notification settings

TheBlackParrot/NoteTweaks

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NoteTweaks

This is a Beat Saber mod that lets you tweak various aspects of the default note.

This is currently actively maintained for Beat Saber versions 1.29.1, 1.34.2, 1.37.1, 1.39.1, and 1.40.0 (currently through 1.39.1).

Downloads

See the releases page for mod downloads. Pre-release builds are subject to change, it is highly recommended to use the latest Release build.

Heads up!

  • It is recommended to disable other mods that also change aspects of the default note if you want to use this mod, as conflicts can occur.
    • The Custom Notes mod does not appear to cause any conflicts, should be fine.
    • Some users have reported that NalulunaNoteDecor causes some conflicts, although I haven't seen any issues crop up with it. (ymmv)
  • Note Scaling is forcibly turned off if the Pro Mode, Strict Angles, or Small Notes modifiers are enabled.
  • Face symbol modification is forcibly turned off if the Ghost Notes or Disappearing Arrows modifiers are enabled.

Configuration

Configuration is done in-game via a Menu button in the left panel of the Main Menu, or by editing UserData/NoteTweaks.json.
Presets can also be saved/loaded in-game via the menu on the right in the settings menu.

Custom Cubemap textures

Cubemap textures can be changed on notes and bombs; NoteTweaks will pull individual face textures from folders in UserData/NoteTweaks/Textures/Notes, and can dynamically generate a cubemap from a single texture as well.

Each folder should have a 512x512 image (in .jpg, .png, or .tga) for each side of a cube:

  • nx (left)
  • ny (bottom)
  • nz (back)
  • px (right)
  • py (top)
  • pz (front)

If any images are missing, or if an image is not any of the expected filetypes, the folder will not be selectable in-game.

Individual images outside of folders can also be selected.

I've provided 36 cubemap textures that you can use with the mod, ready-to-go. If you want to convert a panoramic image, Kyle Nguyen's Optifine Sky Generator is an easy online tool to split the image into 6 cube faces. (use a 2048x1024 image to get 512x512 face textures, no post-resizing needed)

Dependencies

  • BSIPA
  • BeatSaberMarkupLanguage
  • SiraUtil
  • SongCore

Reference Mods

  • BeatLeader
  • BSExtraColorPresets
  • SoundReplacer (Meivyn's fork)
  • BeatSaberPlus
  • JDFixer
  • CustomNotes
  • CustomSabersLite
  • Camera2
  • BetterSongSearch
  • ImageFactory (DJDavid98's fork)
  • SaberFactory
  • NoteMovementFix
  • BS Utils