Peformance Director
Use the menu below to navigate through the Performance Director documentation.
COMMANDS AND HOTKEYS
Chat Commands and Emotes - What are they?
Chat commands or "emotes" are words sent on a chat channel to either command a device to do something, or send chat to the people near you. Typing something in local chat actually is on Channel 0. Many scripted items such as curtains, particle effects, etc., are programmed to be controlled via a certain chat channel. We refer to anything sent on a channel an "emote."
You can send chat commands in a number of different ways with Performance Director. Each has its benefits and it is up to you how you would like to send commands or emotes to your props and the audience.
For example, you can have your Performance Director say "Welcome to the Show!" on Channel 0 (local chat that everyone sees) and send a command to open your curtains.
NOTE: Lines cannot be more than 255 characters long, including spaces.
Chat commands or "emotes" are words sent on a chat channel to either command a device to do something, or send chat to the people near you. Typing something in local chat actually is on Channel 0. Many scripted items such as curtains, particle effects, etc., are programmed to be controlled via a certain chat channel. We refer to anything sent on a channel an "emote."
You can send chat commands in a number of different ways with Performance Director. Each has its benefits and it is up to you how you would like to send commands or emotes to your props and the audience.
For example, you can have your Performance Director say "Welcome to the Show!" on Channel 0 (local chat that everyone sees) and send a command to open your curtains.
NOTE: Lines cannot be more than 255 characters long, including spaces.
Command Method - SAY, SHOUT and REGION SAY
Use the appropriate command based on the size of your venue and distance from you to an object you want to command.
SAY, SHOUT and REGION SAY:
- Using SAY (or the alias: small s) sends the command within 20 meters in all directions.
- Using SHOUT (or the alias: capital S) sends the command 100 meters in all directions.
- Using REGION SAY (or the alias: capital RS or RSAY) sends the command region-wide - you cannot send a region-wide command on channel 0.
Use the appropriate command based on the size of your venue and distance from you to an object you want to command.
SAY, SHOUT and REGION SAY:
- Using SAY (or the alias: small s) sends the command within 20 meters in all directions.
- Using SHOUT (or the alias: capital S) sends the command 100 meters in all directions.
- Using REGION SAY (or the alias: capital RS or RSAY) sends the command region-wide - you cannot send a region-wide command on channel 0.
Commands / Emotes
You can send multiple commands at the same time. Commands can be sent to objects such as the Glow Fader, particles, curtains, lights, etc. Objects must be on a channel and the object script must allow it to be controlled from an object you are wearing. More about Emote Spoofing here
You can send multiple commands at the same time. Commands can be sent to objects such as the Glow Fader, particles, curtains, lights, etc. Objects must be on a channel and the object script must allow it to be controlled from an object you are wearing. More about Emote Spoofing here
| peformance_director_docs.pdf |
THE FORMAT
Time | Command Method : Channel : Command OR Emote Text
No spaces before or after pipes and colons! They are used here only for clarity.
No spaces before or after pipes and colons! They are used here only for clarity.
|
TIME
|
When in your timeline do you want to send this command or emote? Written in seconds or minutes (Example: 60 seconds = 1:00 minute)
|
|
COMMAND
METHOD |
How do you want to send it? Consider how far away you will from the object or audience. It is a good idea to use RS on all object commands (don't worry, no one will see it) and S for audiences. See Command Methods above.
S = Shout (local chat - Channel 0) RS = Region Say (seen by no one - use for all object / prop commands) |
|
CHANNEL
|
0 is the channel for speaking to the audience, OR the channel your object is listening on. Example: You have a curtain listening on Channel 52.
|
|
COMMAND
|
Emote you want to tell the audience, OR command to make an object or script react at a certain time. Examples are sending commands to Costume Assistant, Glow/Fader Script, particles, and prop movements.
|
|
OPTIONAL EMOTE SPOOF TEXT
|
Used if you want your emotes to the audience to appear to come from a character instead of your avatar name.
See Emote Spoofing |
EXAMPLE COMMANDS
This example shows the commands to turn on and off for the Spot On Glow Fader using Region Say on channel 89:
25|RS:89:show
50|RS:89:hide
This example shows shouting text to the audience at 10 seconds into the routine:
10|S:0:Welcome to the show!
25|RS:89:show
50|RS:89:hide
This example shows shouting text to the audience at 10 seconds into the routine:
10|S:0:Welcome to the show!
MULTIPLE COMMANDS
Multiple commands that happen at the same time can be written on the same line. Separate commands with a pipe ( | ) character.
0|S:0:Welcome to the show!|RS:52:opencurtain
This example shows multiple commands on one line and uses the feature command ONLOAD to sends commands to Stage Manager to rez a set and to Costume Assistant to change an outfit as soon as the notecard is loaded.
onload=SAY:42:showgirl set|SAY:44:change showgirl outfit
For Emote Spoofing, see here.
0|S:0:Welcome to the show!|RS:52:opencurtain
This example shows multiple commands on one line and uses the feature command ONLOAD to sends commands to Stage Manager to rez a set and to Costume Assistant to change an outfit as soon as the notecard is loaded.
onload=SAY:42:showgirl set|SAY:44:change showgirl outfit
For Emote Spoofing, see here.
Example Notecard with Emote and Commands
HOTKEY BUTTONS
The hotkey buttons are used to send chat commands to such things as set rezzers, stage props and equipment, particles, etc., at the touch of a button either before or during PLAY.
Note that when you assign commands to the buttons, it is only good for the notecard in which you add the configurations. If you plan to use this feature with each notecard, you must add the configuration lines shown below in each notecard.
Assigning Button Commands
Examples of SAY command - small letter s:
@button1=s:51:curtainopen
@button2=s:51:curtainclose
Examples of SHOUT command - capital letter S:
@button3=S:12:particleson
@button4=S:12:particleoff
Examples of REGION SAY command - capital letters RS or RSAY:
@button5=RS:22:lightsdim
Example of multiple commands assigned to a hotkey. Separate commands with a pipe ( | ) character.
@button1=RS:51:curtainopen|RS:25:lightsdim|S:0:Welcome to the show!
Private Message - PM
Sends a private message to a specific dancer group and all of their attachments. An example of using this feature would be for the Costume Assistant:
All of your dancers are wearing Costume Assistant and all are on Channel 44. You want to change dancers 1 and 2 at 60 seconds and dancers 3 and 4 at 120 seconds. Using Private Message (PM) alleviates the need for different folders and channels on the Costume Assistant.
Example usage:
@group girls|1,2
@group guys|3,4
girls=
0|dancename1
60|PM:44:removefolder clothes
60|dancename2
guys=
0|dancename3
120|PM:44:removefolder clothes
120|dancename4
Sends a private message to a specific dancer group and all of their attachments. An example of using this feature would be for the Costume Assistant:
All of your dancers are wearing Costume Assistant and all are on Channel 44. You want to change dancers 1 and 2 at 60 seconds and dancers 3 and 4 at 120 seconds. Using Private Message (PM) alleviates the need for different folders and channels on the Costume Assistant.
Example usage:
@group girls|1,2
@group guys|3,4
girls=
0|dancename1
60|PM:44:removefolder clothes
60|dancename2
guys=
0|dancename3
120|PM:44:removefolder clothes
120|dancename4