Revision as of 02:55, 20 March 2015

Template:Mentors only

The API Script Index is a listing of community-contributed API scripts that are available for use on Roll20. If you're interested in contributing to the Roll20 API Community Scripts please visit the API GitHub Repository and follow the instructions in the README.md file at the bottom of the page.

Scripts By Category

General Purpose Scripts

If your script incorporates specific game system rules, consider listing the script under that game system instead of one of these general purpose categories.

Combat Scripts

Combat scripts assist in making combat flow more easily. This can mean anything from automatically handling initiative to automating exchanges between combatants.

• GroupInitiative -- Adds the selected tokens to the turn order after rolling their initiative + configurable data.
• InitiativeTracker -- Round counter and status effect manager with optional announcements to chat.
• Random Turnorder -- Randomly assigns a turn to selected tokens.
• TurnMarker -- Round counter and a moving marker that shows who's turn it is.

Tokens - 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.

• Blood And Honor -- Automatic blood spatter, pooling and trail effects
• Bloodied and Dead Status Markers -- Automatic bloodied and down icons for HP tracking
• Conditions and Status Tracker -- Tracks the status of tokens and announces them as the duration passes.
• Flight -- Mark how high tokens are flying
• Flip Tokens -- Flip graphics horizontally and/or vertically
• 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
• TempHPAndStatus -- Temp hit point manager and bloodied/dying/dead status markers.

Tokens - Movement, Rotation, and Size

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

• Auto Teleporting and Chat Based Teleporting -- Teleporting based on text commands or token locations.
• Collision Detection -- Handles collisions between player-controlled tokens and a subset of path objects on the page
• It's a Trap -- Script for setting traps and detecting collisions with them at any point during movement.
• No Token Rotation -- Prevents tokens from being rotated
• RandomDepth -- Randomly adjusts the depth of selected tokens.
• RandomRotate -- Allows the GM to easily rotate all selected tokens to a random angle.
• SizeLock -- Toggles a state which reverts any size changes automatically.
• Slide Tokens -- Use an API command to move tokens along a waypoint path, instead of dragging the token and hitting space.
• SpinTokens -- Allows the GM to toggle spinning of selected tokens.
• TableTokenSizer -- Simple script to scale rollable tokens added to the tabletop to a given size (defaults to 3x3) an set them as not drawings.
• TokenLock -- Allows GMs to selectively lock the movement of Player Tokens.
• Twins -- Links two tokens so that they mirror each other across pages.

Lighting and Revealing

Dynamic lighting is a subscriber feature that changes what parts of the map are visible to the players as they move their tokens around. The light-blocking walls are achieved by paths on the walls layer, and tokens are used as point light sources. Scripts which modify either the light emitted by tokens or the walls which block the light belong in this category.

• Dynamic Lighting Animation -- Animate a sequence of changes to the dynamic lighting layer
• The Darkness is Closing In -- Example script for reducing light on a token every time it moves.
• Torch -- A simple script for giving lights to tokens and turning off and on dynamic lighting.
• Walls -- Builds dynamic lighting walls with an exported SVG path file.

Characters - Equipment

Most game systems have some form of equipment to make characters better. While scripts dealing with that equipment may necessarily bet system-specific, there are scripts which handle equipment in a more general fashion.

• Ammo -- Provides inventory management for ammunition stored in an attribute of a character.
• AmmunitionTracker -- A bunch of commands to track ammunition.
• Inventory Manager -- Inventory Management

Characters - Attributes

Manipulate one or more characters' attributes. Anything that is system-specific should be placed in the system's category below; this section is for system-agnostic attribute manipulation.

• ManualAttribute -- Creates a manual copy of an autocalculated field, and assigns it to the bar of a token.

Generators

Content generation can extend the reach of your campaign while minimizing the GM's prep time.

• Random Dungeon Generator -- Generates random dungeons with geomorphic tiles
• Tile -- Create tiled arrays of graphics on the map layer.
• TokenNameNumber -- Automatic Numbering of tokens with special placeholder.

Roleplay

Scripts which attempt to make the game more immersive belong in this category.

• Language Script -- A script for auto converting text to elven or dwarven.
• What Did He Say? -- Language based scripting
• Morality -- A dialog prompt that provides morality choices as decisions

System

Scripts in this category are a bit more meta than the ones listed above. These scripts assist with Roll20 itself more than they assist the game you're playing.

• APIHeartBeat -- Provides an API Heartbeat by setting the requesting player's color continuously.
• emas -- Provides player !emas and !as commands.
• IsGreater -- Trivial little script to check if the first value is greater than the second and report it to chat.
• MapLock -- Provides locking of graphics to prevent moving/resizing/rotating them. Also highlighting.
• Measure -- Measure distances between multiple tokens, both from the corners and the center.
• MotD -- Greets players that log in with the contents of a particular note.
• MovePlayers -- Allows macros to move the player ribbon for players.
• Store Commands -- Store a series of commands for repeated execution
• TableExport -- A script for exporting Rollable Tables between accounts.
• TokenMod -- An interface to adjusting properties of a token from a macro or the chat area.
• WeightedDice -- Automated creation of rollable tables where a minimum value is weighted with values it replaces. (example d6min4 possible values: 4 4 4 4 5 6)

Game Specific Scripts

Scripts that deal with specific rules of a game system should be listed in a sub-heading here. If the appropriate game system is not listed, feel free to create the appropriate heading.

Scripts under each system below may be designed for any use (in other words, had they been system-agnostic, they might fit under any of the sub-headings in the "General Purpose Scripts" section above).

13th Age

• Escalation -- Simple Escalation Die handling script, using the new custom entries with formulae.

BASH! Ultimate Edition

• BashDice -- Rolls the Bash UE Dice format with exploding.

d6 System

The "d6 System" includes a number of games from West End Games which utilize the same (or very similar) game mechanics. Scripts which are more specific to a single game than the system as a whole should be categorized there.

• WildDice -- Implements the Wild Dice rolling mechanic.

d20 System

The "d20 System" includes Dungeons & Dragons and the games it spawned which utilize the same (or very similar) game mechanics. Scripts which are more specific to D&D or one of its spinoffs than the system as a whole should be categorized there.

• AnnounceRoll -- Prints an extra announcment of a critical or fumble to the chat when using /roll
• MonsterHitDice -- Set Monster hit dice on add, usually via drag from journal.

Dungeons & Dragons 4e

• UsePower -- A script for instrumenting and tracking the use of encounter and daily powers.

Dungeons & Dragons 5e

• SpellLevel5e --

Edge of the Empire

• EotE Dice Roller -- A Dice roller for the Edge of the Empire/Age of Rebellion/Force and Destiny Roleplaying Game

Exalted, Second Edition

• Successes -- reports successes for d10 rolls per Exalted rules.

FATE

• FateDots -- Provides numbered multi dots for Fate stress boxes.

Numenera

• Cypher Roller -- Script to automatically roll Cyphers in Numenera, with full descriptions.

Pathfinder

• CreatureGen -- Generate combat ready tokens from PRD and D20PFSRD statblocks

Savage Worlds

• Raise Count -- Counts raises on a roll against a given target number

Trail of Cthulhu

• GUMSHOE -- A point-spending script for GUMSHOE games. Integrates with supporting character sheets.

Zombie Dice

• ZombieDice -- Rolls canceling Zombie Dice

Utility Scripts

These scripts are generally not intended to be used alone, but are often instead required by some of the above scripts. Alone, these scripts will not do anything for your campaign, but rather they create functions to be used by other scripts.

• Base64 -- Base 64 encoding for Roll20 Scripts. (Adapted from http://www.webtoolkit.info/ )
• CommandShell -- Framework for marshalling chat commands with POSIX-shell-style arguments, permissions, and duplicate-command checking.
• GMCode -- Generates a unique code to authenticate the GM.
• Interpreted sendChat -- Send a message to the chat as the same person or character that triggered a chat event
• IsGM Auth Module -- Provides a function isGM() for determining if a player id refers to a gm. Intended for use alongside other scripts.
• levenshteinDistance -- Measure the difference between strings
• splitArgs -- Split a string into arguments
• Token Collisions -- A library for detecting collisions among tokens during movement.
• Vector Math -- A library for vector mathematics.