Shows

Using show commands to schedule and make shows,commands

Shows

With shows, you can make time coded shows. Our definition of a show is a list of cues, or scheduled events.

The major benefit about shows is that they are multithreaded. Meaning that in-game lag (TPS drops) will NOT affect or hinder the timing of your show to always keep it in sync with the audio.

So get started, make a show called demo

/openaudio show create demo

We now have a show called demo . We can start/stop it, but this won’t really do anything, we need to add cues first. To do so, you first need to understand what a time code is.
A time code is the amount of time from when the start command is executed. OpenAudioMc supports the following formats:
- m resembles minutes : 1m = 1 minute, 1.5m = 1 minute and 30 seconds.
- s resembles seconds : 1s = 1 second, 1.5s = 1 second and 50 milliseconds
- ms resembles milliseconds : 1ms = 1 millisecond
- t resembles ticks : 1t = 1 minecraft tick, or 50 mlliseconds
- HH:mm:ss resembles HourHour:MinuteMinute:SecondSecond : 00:05:00 = 5 minutes

Supported trigger types and their format:
- command : Executes a command though the console, all arguments will be joined to form the command, /openaudio show add demo 0s command say Hi there!
- chat : Sends a chat message to everyone who fits a specific player selector (read selectors ), the first argument is always the select, followed by the message. Example: /openaudio show add demo 0s chat @a[region=spawn] &7Welcome to spawn!
- actionbar : Follows the same general format as the chat trigger, but displays the message in the actionbar instead of chat
- your own feature : You can also add custom java show triggers with the API

For this demo, we are going to add two cues. One cue after 0 seconds, a cue after 1 second, and a cue after 1 minute. To add these cues, use the following commands:

/openaudio show add demo 0s command say I fire at the start
/openaudio show add demo 1s command say I fire after one second
/openaudio show add demo 1m command say I fire after one minute

The basic format here is:

/openaudio show add <show name> <timecode> <type> <data>

To get the status of a show, you can use:

/openaudio show info demo

To start or cancel:

/openaudio show <start/cancel> <showname>

You can also edit a show via a gui using:

/openaudio show gui <show name>

you can change the show state, scroll through cues and delete them from this GUI.

Want more? read The redis documentation