PERFORMANCE DIRECTOR - 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
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?
|
|
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.
|
|
CHANNEL
|
0 is the channel for speaking to the audience, OR
Use the channel your object is listening on. For example, your curtains are on channel 52. (See Example Notecard below) |
|
COMMAND
|
Emote you want to tell the audience, OR
A command to send to an object to make it react. In the example below, your lights are on channel 28 and your curtains are on channel 52. You also send chat to the audience on channel 0. |
EXAMPLE COMMANDS:
|
This example shows the commands to turn on and off for the Spot On Glow Fader using Regsion 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! 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 per hotkey:
@button1=s:51:curtainopen|s: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