Skip to main content

Lasers and spots

ShowControl has two kinds of beams:

  • Lasers (laser): the thin beam of a guardian.
  • Spots (spot): the wide beam of an end crystal.

Both work the same way. Every beam has a name, like l1 or left-spot. You use that name to aim, move and switch the beam.

laser and spot​

laser <name> <location> [speed]
laser <name> on
laser <name> off

spot takes exactly the same arguments.

FormWhat it does
<name> <location> [speed]Switch the beam on (if needed) and point it at the location
<name> onSwitch the beam on, pointing where it last pointed
<name> offSwitch the beam off

Where the beam comes from​

The first cue you add for a name decides where the beam is: its emitter is placed one block above that cue's location. Every later cue only changes where the beam points.

So the easiest way to set up a beam is:

  1. Save the spot of the fixture as a named point, for example /sc point set laser1.
  2. Make the first cue for that beam point at the fixture itself.
  3. Aim it anywhere you like in later cues.
/sc point set laser1
/sc point set stage
/sc add finale 0s laser l1 @laser1
/sc add finale 2s laser l1 @stage
/sc add finale 6s laser l1 off

Beam names are shared by all shows. Two shows that both use l1 control the same beam.

Speed​

The beam glides smoothly to its new target. speed is how much of the remaining distance it travels each tick.

SpeedResult
0.05Slow, soft movement
0.1Default
0.3Fast
1Jumps instantly

Good to know​

  • Beams are visible up to 50 blocks away.
  • A beam only appears while a show uses it. When the show ends or is stopped, its beams are switched off.
  • /sc clear switches off all beams by hand.

Groups​

A group is a list of beams of the same kind. With a group you control many beams with one cue.

/sc group create front laser l1 l2 l3 l4
/sc group add front l5
/sc group remove front l2
/sc group list
/sc group delete front

Every beam in a group needs at least one laser (or spot) cue of its own, so ShowControl knows where it is.

group​

group <group> move <location> [speed]
group <group> on
group <group> off

Does the same as laser/spot, but for every beam in the group at once.

/sc add finale 10s group front move @stage 0.05
/sc add finale 20s group front off

chase​

Moves every beam in a group in a pattern around a center point. Each beam gets its own position in the pattern, which gives the "chase" effect.

chase <group> <pattern> <center> [radius:3] [period:2s] [duration:0] [axis:x]
PatternMovement
circleThe beams circle around the center, evenly spread
sweepAll beams swing from side to side together
waveThe beams stand in a line and move up and down, one after the other
fanThe beams stand in a line and spread open and closed like a fan
randomEach beam glides to a new random spot every period
OptionDefaultMeaning
radius3Size of the pattern, in blocks
period2sTime for one full round of the pattern
duration0How long the pattern runs. 0 means until the beam gets a new cue.
axisxDirection of the line for sweep, wave and fan: x or z
/sc add finale 4s chase front circle @stage radius:4 period:2s
/sc add finale 12s chase front wave @stage radius:6 period:1s axis:z duration:8s
/sc add finale 20s group front off

A chase stops when it reaches its duration, or when a beam gets another move, chase or off cue.