A plugin that fucks up the scene when you fuck up a note.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Tilted
.gitattributes
.gitignore
README.md
Tilted.sln

README.md

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.