Skip to content

Latest commit

 

History

History
81 lines (77 loc) · 6.51 KB

Config Options.md

File metadata and controls

81 lines (77 loc) · 6.51 KB

Basic Chat Config Options (More Below)

Option About
uiOnTop Whether the in game chat integration UI is on the top or bottom
showCooldownOnMessage Whether cooldowns are displayed in chat with the message for command activation
allowModCommands Whether the channel's moderators are allowed to edit the config from chat, if off only the broadcaster can
commandsPerMessage How many commands can be stacked in one chat message
globalCommandCooldown How long in seconds must pass before another chat message with commands will be activated
allowEveryone If on, everyone in chat is allowed to use commands for chat integration
allowSubs If allowEveryone is off and this is on, only subs and moderators will be able to use commands, if this is also off, commands will be limited to moderators
chargesForSuperCharge The amount of additional charges required to activate a supercharge for a command, charge system is explained below
chargesPerLevel The amount of charges generated every time a song starts
maxCharges The max amount of charges that can be accumulated from chargesPerLevel
bitsPerCharge If greater than 0, any message with bits will add charges based on its multiple of this amount
timeForCharges How often to add charges during a song, if not 0
chargesOverTime If charges over time is active, how many charges to give every occurance of the time period
resetChargesperLevel If true, charges will be reset after every song
chatintegration360 If true, 360 Degree Chat Integration Capabilities will be enabled

Charge System

  • Every Command has a chargeCost that you can specify, and the command will only be activated if the amount of charges exceeds the cost, and will subtract the cost accordingly
  • You can choose to either have charges only be generated automatically per level, to provide a "budget" to limit command usage, or restrict the generation of charges to bits, or both using the options explained above
  • You can also set charges to be generated over time during a song, as outlined above, in addition to or instead of the above options
  • SuperCharges require additional charges on top of the chargeCost to use a command, but extend the duration of the effects to be much, much greater...

Command Chat Config Options

  • Since there are enough commands that listing every single option here would be cumbersome, I will explain the "properties" a command can have and what they do
Option About
chargeCost The base amount of charges required to use a command
Duration The base amount of time in seconds the effects of a command last
Cooldown How long in seconds before that command can be used again, cannot be lower than Duration
Min For random commands, the min value of the random range
Max For random commands, the max value of the random range
Chance For commands based on chance, the chance (0-1) of something occuring
Multiplier For multiplier based commands, like faster or slower commands, the multiplier used. I.E. 1.2 = 120%
RandomizeStart For Map Swap Commands, whether to randomize what point the new map starts at
HideNoteArrows For relevant commands, whether to hide note arrow indicators
ForceAnyDirection For relevant commands, whether to make all effected notes have a cut direction of Any

Current Commands

Command Description
DA Temporarily activates disappearing arrows for the duration
Smaller Makes the notes much smaller for the duration
Larger Makes the notes much larger for the duration
Random Makes the note size random within the set range for the duration
InstaFail For the duration, any mistake will cause instant failure, denoted by red health bar
Invincible For the duration, cannot lose any health, denoted by Gold health bar
NjsRandom Randomizes the note jump speed of the notes for the duration
NoArrows Turns the map into no arrows mode for the duration
Funky For the duration, notes are funky
Rainbow Randomizes note colors for the duration, currently left colors will be random warm colors, right will be random cool colors
Pause Literally just pauses the game. Has it's own seperate global command cooldown you can set, pauseGlobalCooldown, instead of a standard cooldown
Bombs For the duration, notes have a chance to be replaced with bombs
Poison For the duration, health regen is disabled
OffsetRandom For the duration, randomizes the note spawn offset
Mirror For the duration, mirrors the map
Reverse For the duration, reverses the direction the notes come from
Faster For the duration, the song speed is altered by the multiplier
Slower For the duration, the song speed is altered by the multiplier
Tunnel For the duration, the player enters a tunnel
Left Rotates the level 30 degrees to the left (If 360 Chat Integration Capabilities are enabled)
Right Rotates the level 30 degrees to the right (If 360 Chat Integration Capabilities are enabled)
RandomRotation Randomly sporadically rotates the level 30 degrees to the left/right for the duration (If 360 Chat Integration Capabilities are enabled)
RCTTS Force Reality Check Through the Skull to play for the duration
GameTime Start a random GameSaber game that will fail the player if they lose before the duration is up (Requires Compatible GameSaber version to be installed)
Jeremy Hide note meshes and telegraph note positions using arcs for the duration

Moderator Commands

Reset Command

  • Moderators can use '!gm reset' to deactivate all non permament commands (Permanent ones being things like noarrows and pause), reset all active cooldowns, and reset charges to the charges per level, or 0 if that value is set to 0

Changing the Config

  • The config can be changed from the file, and will update itself once the game scene changes, without having to restart
  • The config can also be changed from chat by the broadcaster or moderators using the !gm configchange command, the usage of which is below

!gm configchange command property=value

  • Example Usage: !configchange da cooldown=5 would change the cooldown for DA to 5 seconds

!gm configchange property=value

  • To be used for Basic properties not attached to commands
  • Example usage: !gm configchange commandsPerMessage=2 Would change the commands per message to be 2