An event in the editor can have one or more conditionals attached to it. Doing so will prevent the event from running unless all of its conditions are satisfied.
The conditional selector can be accessed via the icon to the left of the event’s bar and beat number.
From this menu, various preset conditionals (such as 2 player mode) can be selected, or a custom one can be defined by pressing “Add New”
The following conditional types can be selected:
| Conditional Type | Description | Example Use Cases |
|---|---|---|
| Custom | A custom RDCode formula. | |
| See Custom Conditionals section below for more information. | • Checking the value of a user-defined variable | |
| • Checking for player or keyboard inputs | ||
| • Checking current letter grade for level | ||
| • Comparing miss count to other variable | ||
| Last Hit | Activates if the most recent hit from a selected row was hit or missed. | • Checking for misses in tutorial levels |
| • Checking if an important beat was hit or missed | ||
| Times Executed | Limits the number of times the event can be run. | |
| An event can be activated multiple times through conditionals with a duration greater than 0, or by running from a tag. | • Ensuring a timed conditional only activates once | |
| Language | Activates if the game is set to a certain language. | • Localizing level text for various languages |
| Player Mode | Activates if the game is in one or two player mode. | • Adjusting the level for 2-player mode |
| Accessibility | Activates based on the state of certain accessibility settings. | |
| ”Flashy Effect” activates if Reduced Flashing is disabled. | • Reducing flashy effects for players who prefer it | |
| • Adjusting the level for players utilizing narration |
<aside> 💡
Any conditional can be negated by clicking it a second time. This will make it activate if the condition is not met.
For example, negating “Language: English” will make the conditional activate if the game language is not English.
Negated conditionals are indicated by a red outline, instead of a blue one.
</aside>
An event with a conditional is indicated by a badge in the top-left corner.
One or more conditionals
One or more negated conditionals
Mixture of regular and negated conditionals
A duration can be set for conditional events by pressing the clock icon in the conditionals menu.
By default, conditional events have a duration of 0. This means they will only be checked once, when their bar and beat number is reached.
If the duration is larger then zero, the event will be run and checked on every frame until the duration has passed.
This can be used to run events as soon as a certain condition becomes true.