I felt there needed to be a comprehensive jukebox control script. This script allows you to replicate all of the commands in the basic jukebox and then some via chat commands. The script also allows playlist functionality via script defined playlists; these have no relation to the playlists in the jukebox as the API does not have access to any of the folder structure (which unfortunately includes playlists). The help document is created in game as an archived handout and can be accessed via a link output to chat if you type an invalid command or just !roll20AM into chat.
Most up to date version is always available from my fork of the repository.
Current one-click Version: 1.04
Newest Version: 1.05
Command Details below:
Basic Syntax
All Roll20AM commands use the same basic syntax. The contents of a command will change based on what you are doing, but the basic format will always look like this:
Player Accessible Action Keywords
GM Only Features -Note the fade feature is not currently working due to the asynch nature of setting attributes-
Let me know if this is actually useful for anyone, and if anything needs work,
Scott
And because I'm a horrible person I almost forgot to thank the people who helped make this script what it is:
Aaron and Stephen S. For code review and helping me implement some of the more complicated parts.
William B for alpha testing
and DulfiJavadMalik at plainicon.com for all of the button icons for the chat menus.
ChangeLog:
v1.05
v1.01:
Most up to date version is always available from my fork of the repository.
Current one-click Version: 1.04
Newest Version: 1.05
Command Details below:
Basic Syntax
All Roll20AM commands use the same basic syntax. The contents of a command will change based on what you are doing, but the basic format will always look like this:
Player Accessible Action Keywords
Commands are shown with all possible settings. If a setting is optional, it will be enclosed in brackets. If only one of a series of settings will be accepted, they are separated by a slash "/". The order of options does not matter as long as the action keyword begins the action group and the list of tracks ends the action group.
GM Only Features -Note the fade feature is not currently working due to the asynch nature of setting attributes-
Let me know if this is actually useful for anyone, and if anything needs work,
Scott
And because I'm a horrible person I almost forgot to thank the people who helped make this script what it is:
Aaron and Stephen S. For code review and helping me implement some of the more complicated parts.
William B for alpha testing
and DulfiJavadMalik at plainicon.com for all of the button icons for the chat menus.
ChangeLog:
v1.05
- Fade functionality is working now
- tickTime is now actually in seconds
- Several erroneous pieces of the fade code have been fixed
- The script now whispers directly to the person who sent the command requiring chat output (help, errors, or menus). If the command is sent by an API script, the script will still whisper "gm" instead of a specific player
- Script messages are now noarchive, so they won't pollute your chat archive.
- Script now trims hanging spaces from the start/end of track and playlist names in commands. Fix for this issue.
- Fixed player restriction handling so that it properly handles turning player restrictions off
- Fixed an erroneous state.Roll20AM.{} variable definition that was assuming state.Roll20AM had been created when it hadn't, causing the API to not compile.
v1.01:
- Fixed a crash that could occur when improper action keywords were used
- Added playlist import/update from jukebox functionality
- Release