Latest revision as of 15:46, 3 October 2022

Page Updated:   2022-10-03

This page is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account.

Main Page: API:Script Index

APIs that focus on interacting with tokens, or some aspect of them.

• TokenMod -- An interface to adjusting properties of a token from a macro or the chat area. Very versatile and tons of options, and it can perform features of several other Token-related APIs.
• Reporter^(Forum) -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
• SelectManager - can patch and extend token selection between APIs
• Supernotes^(Forum) -- script pulls the contents from a token's GM Notes field.
• Clock Tokens
  -- easy way to manage multi-sided tokens which are being used to represent progress clocks, or any other kind of incrementing timer or countdown.
• Random Token Tinter -- will randomly assign (or remove) tints on tokens based on either a command-line list, a predefined Rollable Table, or a default rainbow (ROYGBV). See !!randtint --help for more.
• TokenController^(Forum) - Automate Token Movement for Patrols, following, roaming, and more
• WeaponArcs^(Forum) -- provides a means to add weapon arcs to tokens for visualization of range and targetable tokens
• Faces^(Forum) -- This is a short script that is designed to provide a quick visual interface for swapping token images and names. Great for any changeling. by Keith

[edit] Movement, Rotation, and Size

Scripts which are triggered by or change the location of tokens should generally be placed in this category.

• Bump^(Forum) - provides a way to invisibly manipulate tokens on the GM Layer from the Objects Layer, and vice versa.
• TokenLock -- Allows GMs to selectively lock the movement of Player Tokens.
• Carry Tokens^(Forum) -- Allows tokens to "carry" and move other tokens, like dragging other characters or moving items.
• Collision Detection -- Handles collisions between player-controlled tokens and a subset of path objects on the page
• DupCharToken -- Duplicate a Character and Token, and add identifying number to Character and Token.
• It's a Trap! -- Script for setting traps and detecting collisions with them at any point during movement. Has separate versions customised for specific games/sheets
• KABOOM -- Creates explosion effects that move tokens away from or towards a point.
• Marching Order -- Makes tokens follow each other in some specified order.
• Measure -- Measure distances between multiple tokens, both from the corners and the center.
• Random Rotate -- Allows the GM to easily rotate all selected tokens to a random angle.
• Teleport -- Teleports tokens within a page or between pages either by chat menu or token movement by using teleport tokens on the GM layer.
• Spawn Default Token^(Forum) -- general idea is to automatically spawn the default token for a given "character" with various options for token qty, location/arrangement, and certain token properties such as size, side(for multi-sided tokens), light emission etc.
• Token Fate -- Let fate decide! Randomly selects a token from the selected group.
• Flip Tokens -- Flip graphics horizontally and/or vertically
• SpinTokens -- Allows the GM to toggle spinning of selected tokens.
• TokenController -- Allows GMs to quickly create patrol path shapes, assign tokens one or more paths, lock tokens in place, set tokens to follow each-other, and more. Uses complete menu system, no chat commands required.

[edit] Conditions, Status, Health

Tokens are used to represent player characters as well as non-player characters. Naturally, both occasionally get punched around a bit. Scripts in this category deal with the changing conditions of tokens, often but not necessarily as a result of combat.

• Emojibubble^(Forum) -- System to easily display emojis in a bubble above Character Tokens, or on the map.
• Flight -- Mark how high tokens are flying
• Health Status
  -- makes it possible for GM & players to see roughly how much health an enemy has.
• Mark -- Places a numbered Marker under tokens, clears on turn change/close, and page change.
• Marking Conditions -- Set status markers on targeted on individual tokens
• TurnMarker1 -- provides a visual marker to show which token's turn it is & centers map on them.
• TokenNameNumber -- Automatic numbering of tokens with special placeholder.
• Monster Hit Dice -- Set Monster hit points from hit dice on add, usually via drag from journal.
• Aura/Tint HealthColors^(Forum) --
  code
  -- Script to set health indicator on tokens via aura or tint, based on a bar's value.
  • script variant by David M., uses only one aura1
• RoundMaster -- Manages token statuses, Effect Macros, and Turn Order
• [Token Patrol https://app.roll20.net/forum/post/11115799/script-token-patrol] by Patrick P.