Skip to content

Caeden117/BeatSaberTilted

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tilted - A Beat Saber Plugin

A plugin that fucks up the scene when you fuck up. This plugin may crash the game when exiting the level.

Setup

Add the release .dll to <Beat Saber Directory>/Plugins and start the game. A configuration file will automatically be created in <Beat Saber Directory>/UserData/Tilted.txt.

Supported Plugins

Anything that adds custom GameObjects. No really. Anything from:

CustomSabers
CustomPlatforms
CustomAvatars
Perfection Display
FullComboDisplay
HitScoreVisualizer
HitSwap
TwitchIRC
Saber Tailor

And a whole lot more mods will be effected by Tilted.

Configuration

enabled (Default: true) | Toggles the plugin on/off.

mode (Default: standard) | Changes plugin mode from standard, how it was meant to be played, and shakeCamera, where any and all external cameras would shake when you hit a note.

scalar (Default: 10) | A float value of how fucked up the scene will get (or how hard the cameras should shake) every time the function gets called. Negative numbers will work!

includeCameras (Default: false) | Avoids GameObjects with Cameras tied to them. This ensures any outside Cameras (CameraPlus first/third person, Dynamic Camera, etc.) do not get messed with. Ignored when avoidFilters is enabled.

shakeCamera_AlsoShakeNotes (Default: true) | Because the plugin cannot modify the main camera in game (Players will not notice a shake), notes can now shake as well.

avoidFiltersBecauseYouAreAFuckingMadManAndItWillMakeBeatSaberUnplayable (Default: false) | Toggles the built-in filters that make the plugin actually playable. BY ENABLING THIS OPTION, BEAT SABER WILL BECOME UNPLAYABLE AND MOST LIKELY CRASH WHEN EXITING A LEVEL.

Advanced Details

By default, the plugin will ignore any GameObject with the following components added on to it:

NoteData (Generic notes)
NoteController (What spawns the notes)
Sabers (What you control and swing)
ObstacleData (Obstacles that you dodge)
ObstacleControllers (What spawns the obstacles)
Cameras (Although it has its own configuration setting, the includeCameras config will be ignored if the avoidFilters option is enabled)

This ensures that while the rest of the scene will be messed up, Beat Saber will still be playable and you will still be able to complete the level (With a chance of having your view cut off by the level itself)

When enabling the avoidFilters configuration option, the plugin will skip this check, causing obstacles to spawn weirdly, notes to be rotated randomly. I believe it will also make sabers stop following your controllers, so it makes the entire level unbeatable.

About

A plugin that fucks up the scene when you fuck up a note.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages