Skip to main content

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, laser or title. 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.

StyleExamplesMeaning
Units5s, 1.5s, 500ms, 2m, 1hseconds, milliseconds, minutes, hours
Ticks20t20 ticks = 1 second
Combined1m30s, 1m30.5s1 minute and 30 (.5) seconds
Clock00:01:30, 01:30, 00:01:30.500hours: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 typeMeaning
@stageThe named point stage
world 100 64 -20.5A world and x, y, z coordinates (decimals allowed)
hereWhere 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.

TargetWho
allEvery online player
world:world_netherEvery player in that world
near:stage:30Every player within 30 blocks of the named point stage
player:SteveOne player
perm:show.vipEvery player with that permission

Colored text​

All text uses MiniMessage. Some examples:

You typeResult
<gold>Welcome!Gold text
<bold><red>WarningBold red text
<#ff66cc>PinkAny 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.