Character Vault
Any Concept / Any System
Compendium
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Script:InitiativeTrackerPlus

From Roll20 Wiki

Revision as of 13:55, 29 March 2022 by James C. (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Main Page: API:Script Index

API ScriptAuthor: Chuz
Version: 1.29
Last Modified: 2022-03
Code: InitiativeTrackerPlus
Dependencies: None
Conflicts: None

Initiative Tracker Plus (Formerly TrackerJacker) is an API to improve Initiative Tracking on Roll20.

Help & Start commands:

!itp -help
!itp -start

The intent is to continue supporting the script and update it with new features and functionality as they are requested or come to me.

Contents

Installation and Configuration

Script is now available on the one-click API installer.

Copy the script's code, available from the menu on the right and stored at Roll20's API Repository. Paste the code into a new script in your campaign's API Script Editor. Save the new script and it will be available inside your campaign.

Script Use

!itp -help
Display help message

!itp -start
Start/Pause the tracker. If not started starts; if active pauses; if paused, resumes. Behaves as a toggle.

!itp -stop
Stops the tracker and clears all status effects.

!itp -clear
Stops the tracker as the -stop command, but in addition clears the turnorder

!itp -pause
Pauses the tracker.

!itp -reset [round#]
Reset the tracker's round counter to the given round, if none is supplied, it is set to round 1.

!itp -addstatus [name]:[duration]:[direction]:[message]
Add a status to the group of selected tokens, if it does not have the named status. name name of the status. duration duration of the status (numeric). direction + or - direction (+# or -#) indicating the increase or decrease of the the status' duration when the token's turn comes up. +0 or -0 for a permanent affect. message optional description of the status. If dice text, ie: 1d4 exist, it'll roll this result when the token's turn comes up.

!itp -removestatus [name]
Remove a status from a group of selected tokens given the name.

!itp -dispmultistatusconfig removeall>
Remove all statuses from one or more selected tokens.

!itp -edit
Edit statuses on the selected tokens

!itp -addfav [name]:[duration]:[direction]:[message]
Add a favorite status for quick application to selected tokens later.

!itp -listfavs
Displays favorite statuses with options to apply or edit.

!itp -listfavs 1
Displays favorite statuses (in alphabetical order) with options to apply or edit.

!eot
Ends a player's turn and advances the tracker if the player has control of the current turn's token. Player usable command.

!itp -saveFavs
Save your current Favorites into in the GM notes section of a handout called "ITPFavsJSON". This can be copy/pasted into a handout with the same name in another lobby and then "!itp -loadFavs" can be run to load them there.

!itp -loadFavs
Load Favorites previously saved via "!itp -saveFavs". Requires the handout "ITPFavsJSON" to exist and have properly exported data in the GM notes section.

!itp -setIndicatorImage
Replaces the current initiative indicator with a new image Note: The token will be removed from the field, along with any others with the name 'tracker_image'

  • Place the image you wish to use as the indicator image (animated turn indicator) on the play field (any layer). Please note, rollable tokens can be used for this as well.
  • Edit the new token and change it's name to 'tracker_image', save the change
  • Pause the tracker if it's currently active
  • Use this command
  • Unpause the tracker if it was active, else wise the next time the tracker is started your new indicator will be used.


!itp -defaultIndicatorImage
Revert the initiative indicator to the original green one.

  • Pause the tracker if it's currently active
  • Use this command
  • Unpause the tracker if it was active, elsewise the next time the tracker is started the indicator will be the default green one.


!itp -setConfig [key]:[value] Changes various configuration values. Permitted keys and what they expect for values are:

  • trackerImgRatio - [2.25] - a decimal number, how much larger than the token it's highlighting that the turn indicator should be
  • rotation_degree - [15] - an integer number, how many degrees per step of the indicator animation that it rotates.
  • rotation_rate - [250] - an integer number, how many milliseconds between frames of the animation, smaller numbers are a faster animation but will load down roll20 more.
  • round_separator_initiative - [-100] - an integer number, displays the "initiative" for the round separator 100 will put it at the top of the round, -100 will put it at the bottom of the round.
  • rotation - [true] - true or false, turns the spinning animation for the turn indicator on (true) or off (false)
  • show_eot - [true] - true or false, shows or hides the EOT button when announcing actor turns.
  • turncolor - [#FFFFFF] - Hex color code, changes the color of the background of the chat message announcing who's turn it is.
  • turnbgcolor - [#D8F9FF] - Hex color code, changes the background color of the background of the chat message announcing who's turn it is.
  • roundcolor - [#FFFFFF] - Hex color code, changes the color of the round announcement chat message.
  • roundbgcolor - [#363574] - Hex color code, changes the background color of the round announcement chat message.
  • statuscolor - [#FFFFFF] - Hex color code, changes the color of the text of the chat message announcing statuses of the current actor.
  • statusbgcolor - [#333333] - Hex color code, changes the background color of the chat message announcing statuses of the current actor.
  • statusbordercolor [#430D3D] - Hex color code, changes the color of the border of the chat message announcing statuses of the current actor.
  • statusargscolor [#FFFFFF] - Hex color code, changes the color of the feedback text when changing the marker for a status.
  • statusargsbgcolor [#333333] - Hex color code, changes the background color of the feedback text when changing the marker for a status.
  • eotcolor [#FFFFFF] - Hex color code, changes the color of the EOT button.
  • eotbgcolor [#FF0000] - Hex color code, changes the background color of the EOT button.
  • playcombatmusic [0] - Will a track from the jukebox be played when the tracker is active. Values should be 0 for off, 1 for on.
  • combatmusic [] - The name of the track to play when the tracker is active if playcombatmusic is turned on [1]. Track can not contain spaces (example: Combat).

History

Initiative Tracker Plus is a derived from the older TrackerJacker written by Ken L. which was apparently related to The Aaron's TurnMarker. The author James C. (Chuz) has updated TrackerJacker to automatically detect token markers included in a lobby and allow their use in the status effects.

Changelog

Changelog