The basics
Shows and cues
A show is a list of cues. A cue says what happens and when:
/sc add <show> <time> <trigger> [arguments]
/sc add finale 12.5s firework @stage color:red
│ │ │ └ arguments
│ │ └ trigger
│ └ time
└ show
- The trigger is the effect, like
firework,laserortitle. See Triggers for all of them. - The time is when the cue fires, counted from the start of the show.
- A show ends after its last cue.
Show names can have 1 to 64 letters, digits, - and _. They are case-sensitive: Finale and finale are two
different shows.
Times
You can write a time in two ways.
| Style | Examples | Meaning |
|---|---|---|
| Units | 5s, 1.5s, 500ms, 2m, 1h | seconds, milliseconds, minutes, hours |
| Ticks | 20t | 20 ticks = 1 second |
| Combined | 1m30s, 1m30.5s | 1 minute and 30 (.5) seconds |
| Clock | 00:01:30, 01:30, 00:01:30.500 | hours:minutes:seconds(.ms) |
The server runs 20 ticks per second, so cues fire with an accuracy of 50 milliseconds.
Show time follows the real clock, not the server ticks. When the server lags, late cues fire as soon as possible and the show stays in sync with the music.
Locations
Most triggers need a location. You can give it in four ways.
| You type | Meaning |
|---|---|
@stage | The named point stage |
world 100 64 -20.5 | A world and x, y, z coordinates (decimals allowed) |
here | Where you are standing |
world ~ ~2 ~ | Relative to where you are standing (here: 2 blocks above you) |
here and ~ only work for players. They are turned into fixed coordinates when you add the cue, so the cue doesn't
follow you around.
Named points
A named point is a saved location with a name. Use named points for every spot you use more than once: the stage, each laser, each fountain.
/sc point set stage Save your current location as "stage"
/sc point set stage world 100 64 -20 Save exact coordinates
/sc point tp stage Teleport to the point
/sc point list List all points
/sc point delete stage Delete the point
The big advantage: run /sc point set stage again somewhere else, and every cue that uses @stage moves with it.
You never have to edit those cues.
Point names are not case-sensitive. If you delete a point, the cues that use it are skipped when the show plays.
Targets
Text triggers (title, actionbar and message) need to know who sees the text.
| Target | Who |
|---|---|
all | Every online player |
world:world_nether | Every player in that world |
near:stage:30 | Every player within 30 blocks of the named point stage |
player:Steve | One player |
perm:show.vip | Every player with that permission |
Colored text
All text uses MiniMessage. Some examples:
| You type | Result |
|---|---|
<gold>Welcome! | Gold text |
<bold><red>Warning | Bold red text |
<#ff66cc>Pink | Any hex color |
<rainbow>Showtime</rainbow> | Rainbow text |
<gradient:aqua:blue>Ocean</gradient> | Color gradient |
Options
Many triggers take options written as key:value, for example height:6 or duration:2s. Options can be given in any
order, and you only need the ones you want to change. Everything else uses its default.
/sc add finale 10s fountain @stage height:8 duration:3s
Playing a show
/sc start finale Start from the beginning
/sc start finale 1m Start from 1 minute in (earlier cues are skipped)
/sc start finale loop Start and repeat forever
/sc start finale 1m loop Both
/sc pause finale
/sc resume finale
/sc stop finale
Starting a show that is already running restarts it.
Cleanup after a show
Lasers, spots and displays only appear while a show uses them. When a show ends or is stopped, ShowControl turns off everything that show turned on. If another running show still uses a laser, spot or display, it stays.
Pausing or looping a show keeps everything as it is.
To clean up by hand:
/sc clear finale Turn off the lasers and spots and remove the displays of one show
/sc clear Do this for all shows
Lamps switched by the light trigger are blocks in the world. They stay as they are when a
show ends.