Skip to content

Latest commit

 

History

History
72 lines (68 loc) · 6.33 KB

README.md

File metadata and controls

72 lines (68 loc) · 6.33 KB

OBSControl Build Unit Tests|Dev Build Unit Tests - Dev

A Beat Saber mod to automatically start/stop recording in OBS when you play a song.

Installation

  • OBS
    • Requires the OBS-Websocket OBS plugin.
    • You should have something like this in OBS:
    • If OBS is running on the same PC as Beat Saber, you would use ws://127.0.0.1:4444 (default) as the ServerAddress in Beat Saber\UserData\OBSControl.json.
  • Beat Saber
    • Extract the release zip from the Releases page to your Beat Saber folder. OBSControl.dll should end up in your Beat Saber\Plugins folder.
    • You should see OBSControl in the Mod Settings menu if you installed it correctly.

Configuration

Settings can be found in-game in the Mod Settings > OBSControl menu.

  • Enabled: Check to have OBSControl automatically start/stop recording.
  • ServerAddress: The address of your OBS websocket server (in the form of ws://ip:port). This doesn't usually need to be changed.
  • ServerPassword: If you set a password in OBS Websocket, enter it here.
  • LevelStartDelay: Amount of time in seconds to delay the start of the level. When the Play button is clicked, OBS will start recording for this amount of time before the level actually starts.
  • RecordingStopDelay: Amount of time in seconds to wait after the end of a level before stopping the recording or switching to the End Scene.
  • Scene Settings
    • GameSceneName: Set the name of the OBS scene you want to use for gameplay footage, leave blank to disable scene switching.
    • StartSceneName: Name of the OBS scene to use as an intro for your videos. You must have a valid GameSceneName set to use this option.
    • StartSceneDuration: Amount of time in seconds to show the Start Scene before switching to the Game Scene.
    • EndSceneName: Name of the OBS scene to use as an outro for your videos. This scene is shown after RecordingStopDelay has finished. You must have a valid GameSceneName set to use this option.
    • EndSceneDuration: Amount of time in seconds to show the End Scene before stopping the recording.
  • Advanced (Available only by editing OBSControl.json in your Beat Saber\UserData folder)
    • RecordingFileFormat: Defines how the file will be renamed after the recording stops.
      • Substitution characters are prefixed with ?
      • Optional groups are bounded by < >
        • The group is only shown if one or more of the substitutions inside the group are not empty strings.
          • Example: The format VideoFile<_I_Got_A_?F> will be VideoFile_I_Got_A_FC if you get a full combo or VideoFile if you don't.
      • Optional parameters: Some substitutions can have additional parameters inside { }. For example, the format ?@{yyyyMMddHHmm} would rename the file to 202005050807.mkv on 05/05/2020 8:07 AM.

Availble Substitutions:

Song Data:

Key Substitution Parameter(s) Notes
B BeatsPerMinute BPM to two decimal places, ignoring trailing zeroes.
D DifficultyName Full name of the difficulty.
d DifficultyShortName Short name of the difficulty (i.e E+ instead of ExpertPlus).
A LevelAuthorName (int)Max Length Name of the mapper. Example: ?A{10} to use up to 10 characters of the mapper name.
a SongAuthorName (int)Max Length Name of the song artist. Example: ?a{10} to use up to 10 characters of the artist name.
@ CurrentTime (string)DateTimeFormat Date/Time of the recording when stopped. Format Information, default is yyyyMMddHHmm
I LevelId LevelId of the song.
J NoteJumpSpeed NJS to two decimal places, ignoring trailing 0s.
L SongDurationLabeled Duration of the song in minutes and seconds (i.e. 3m.25s for 3 min 25 sec).
l SongDurationNoLabels Duration of the song in minutes and seconds with no labels (i.e. 3.25 for 3 min 25 sec).
N SongName (int)Max Length Name of the song. Example: ?N{10} to use up to 10 characters of the song name.
n SongSubName (int)Max length Subname of the song. Example: ?n{10} to use up to 10 characters of the song subname.

Completion Results Data:

Key Substitution Parameter(s) Notes
1 FirstPlay 1st if you haven't played the song according to Beat Saber's data.
b BadCutsCount Number of bad cuts.
T EndSongTimeLabeled How far into the song you got in minutes and seconds (i.e. 3m.25s for 3 min 25 sec).
t EndSongTimeNoLabels How far into the song you got in minutes and seconds with no labels (i.e. 3.25 for 3 min 25 sec).
F FullCombo FC if you full combo'd the song.
M Modifiers Enabled song modifiers, separated by _ (i.e. DA_FS for Disappearing Arrows and Faster Song).
m MissedCount Number of notes missed.
G GoodCutsCount Number of good cuts.
E LevelEndType Has a value for any level end type (Cleared/Quit/Failed/Unknown).
e LevelIncompleteType Only has a value if the level was incomplete (Quit/Failed/Unknown).
C MaxCombo Max combo for the song.
S RawScore Score before any modifiers were applied.
s ModifiedScore Score after modifiers (your actual score).
R Rank Score rank (SSS/SS/S/A/B/C/D/E).
% ScorePercent Score percent to two decimal places.