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.
| Form | What it does |
|---|---|
<name> <location> [speed] | Switch the beam on (if needed) and point it at the location |
<name> on | Switch the beam on, pointing where it last pointed |
<name> off | Switch 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:
- Save the spot of the fixture as a named point, for example
/sc point set laser1. - Make the first cue for that beam point at the fixture itself.
- 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.
| Speed | Result |
|---|---|
0.05 | Slow, soft movement |
0.1 | Default |
0.3 | Fast |
1 | Jumps 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 clearswitches 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]
| Pattern | Movement |
|---|---|
circle | The beams circle around the center, evenly spread |
sweep | All beams swing from side to side together |
wave | The beams stand in a line and move up and down, one after the other |
fan | The beams stand in a line and spread open and closed like a fan |
random | Each beam glides to a new random spot every period |
| Option | Default | Meaning |
|---|---|---|
radius | 3 | Size of the pattern, in blocks |
period | 2s | Time for one full round of the pattern |
duration | 0 | How long the pattern runs. 0 means until the beam gets a new cue. |
axis | x | Direction 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.