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

Difference between revisions of "API:Script Index"

From Roll20 Wiki

Jump to: navigation, search
m (Chat)
m (Special Thanks)
 
(52 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{pro only}}
 
{{pro only}}
<div style="float:left;margin-right:15px">__TOC__</div>
 
 
{{apibox}}
 
{{apibox}}
  
 +
The '''API Script Index''' is a listing of community-contributed API scripts that are available for use on Roll20.
  
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 [https://github.com/Roll20/roll20-api-scripts API GitHub Repository] and follow the instructions in the README.md file at the bottom of the page.
+
If you're interested in contributing to the Roll20 API Community Scripts please visit the {{repo|Roll20/roll20-api-scripts Roll20 API Scripts Repository}} and follow the instructions in the {{repo|Roll20/roll20-api-scripts#roll20-api-scripts README}}, and then continue to [[API:Introduction]].
 +
 
 +
__TOC__
  
<br clear="both">
 
 
=APIs available in One-Click Menu=
 
=APIs available in One-Click Menu=
 
{{Ambox
 
{{Ambox
 
|nocat=true
 
|nocat=true
 
| type  = content
 
| type  = content
| text  = The best instructions for most API Scripts can be found on the script's description when selected from the One-Click Install, or through installing it and using any "help/instuctions" command built into them.  
+
| text  = '''Script-specific Instructions & Descriptions:''' Most API Scripts have a description (&possibly instructions) in the [[API:Use_Guide#Install_API|API One-Click Install]] when selected. Many API have a built it "help/instructions" command that can be accessed in-game.  
 
}}
 
}}
{{notebox|This list resemble the list found in the one-click menu, but currently lists only APIs that have their own wiki pages, or are otherwise popular enough. There are ''hundreds'' of APIs missing from this list, but an effort to update it have been started [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 18:34, 26 December 2020 (UTC)}}
+
{{notebox|This list ''resemble'' the list found in the [[API:Use_Guide#Install_API|API One-Click Install]], but currently lists only APIs that have their own wiki pages, or are otherwise popular enough. There are ''hundreds'' of APIs missing from this list, but an effort to update it have been started. The Index have been updated in batches through Feb-March. [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 14:03, 29 March 2021 (UTC)}}
If your script are designed for use with a ''specific'' game system ruleset or specific Roll20 character sheet, please  list the API under that game system, instead of listing under one of the generic categories. Some API are listed under more than one category.
+
If your script are designed for use with a ''specific'' game system, ruleset, or specific [[CS|Roll20 character sheet]], please  list the API under that game system, instead of listing under one of the more generic categories. When approprate, API can be listed under more than one category.
  
Some great or popular APIs have their name highlighted in bold to stand out.
+
Some '''great''' or '''popular APIs''' have their '''name highlighted in bold''' to stand out.
  
 
== Characters==
 
== Characters==
Line 22: Line 23:
  
 
* [[Script:CharSheet|CharSheet]] -- Allow players to create their own character sheets.
 
* [[Script:CharSheet|CharSheet]] -- Allow players to create their own character sheets.
* {{forum|post/5281433/slug} Welcome Package}} -- API create and assigns character sheet to new people who join a game
+
* {{fpl|5281433/ Welcome Package}} -- API create and assigns character sheets to new people who join a game
* PublicSheet -- Creates a "public" version of character sheets that players can't edit, which mirrors the ''actual'' character sheet.
+
* {{fpl|9888024/ PlayerCharacters}} -- Player & Character Manager. List all Player Characters divided by Player for the GM, or all assigned Characters for a Player. Add Characters for GM and Players.
 
+
* {{fpl|6213379/ PublicSheet}} -- Creates a "public" version of character sheets that players can't edit, which mirrors the ''actual'' character sheet.
 +
* {{fpl|9934364/ Reporter}} -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
 +
* {{fpl|4742980/ Observer}} -- Manages observer players, who are given the visiblilty (and control) of all player characters. This is useful for both podcasting views and local play on a single player screen.
 
===Equipment===
 
===Equipment===
 
Most game systems have some form of equipment to make characters better. While scripts dealing with that equipment may necessarily be system-specific, there are scripts which handle equipment in a more general fashion.
 
Most game systems have some form of equipment to make characters better. While scripts dealing with that equipment may necessarily be system-specific, there are scripts which handle equipment in a more general fashion.
* [[Script:Ammo|Ammo]] -- Provides inventory management for ammunition stored in an attribute of a character.
+
* [[Script:Ammo|Ammo]] -- Provides inventory management for ammunition stored in an attribute of a character. Can be used with any char sheet
  
 
===Attributes===
 
===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.
 
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.
 +
* '''[[Script:ChatSetAttr|ChatSetAttr]]''' -- Create, modify, and delete character attributes via chat commands or macros. ChatSetAttr can be embedded into normal macros.
 
* [[Script:Conditions|Conditions]] -- Track attribute-modifying conditions.
 
* [[Script:Conditions|Conditions]] -- Track attribute-modifying conditions.
* '''[[Script:ChatSetAttr|ChatSetAttr]]''' -- Create, modify, and delete character attributes via chat commands or macros.
 
 
* [[Script:EasyExperience|EasyExperience]] -- Make awarding experience easy and choose your experience progression.
 
* [[Script:EasyExperience|EasyExperience]] -- Make awarding experience easy and choose your experience progression.
* '''Experience Tracker''' -- Automatic tracking of a Dungeons and Dragons 5e like experience system, aswell as level up announcement in chat. !xp handles experience and announces level up.
+
* {{fpl|6872561/ LazyExperience}} -- to record experience during a game. Inspired by EasyEx, biggest difference is that it has an option to reward experience directly.
 
* '''[[Script:GroupCheck]]''' -- A way to quickly roll a group check for everyone and see if they succeed
 
* '''[[Script:GroupCheck]]''' -- A way to quickly roll a group check for everyone and see if they succeed
** {{forum|permalink/4359153/ ApplyDamage}} -- Supplementary API to GroupCheck, which enables to automatically apply damage to a group of characters, based on failed/succeeded GroupCheck rolls. Example: Damage of an AoE Spell, based on success/fail on saving throw
+
** {{fpl|4359153/ ApplyDamage}} -- Supplementary API to GroupCheck, which enables to automatically apply damage to a group of characters, based on failed/succeeded GroupCheck rolls. Example: Damage of an AoE Spell, based on success/fail on saving throw
 +
* ''Experience Tracker'' -- Automatic tracking of a Dungeons and Dragons 5e like experience system, aswell as level up announcement in chat. !xp handles experience and announces level up.
  
 
== Chat ==
 
== Chat ==
 
Various APIs that primarily help you out by creating API commands & options that can be used in the {{Text Chat}}.
 
Various APIs that primarily help you out by creating API commands & options that can be used in the {{Text Chat}}.
 
* '''[[Script:ChatSetAttr|ChatSetAttr]]''' -- Create, modify, and delete character attributes via chat commands or macros.
 
* '''[[Script:ChatSetAttr|ChatSetAttr]]''' -- Create, modify, and delete character attributes via chat commands or macros.
* '''ChatTurnManager''' -- A script to simplify Turn Order Management, and move it into chat.
+
* ''ChatTurnManager'' -- A script to simplify Turn Order Management, and move it into chat.
 
* [[Script:emas|emas]] -- Provides player <code>!emas</code> and <code>!as</code> commands.(emote as)
 
* [[Script:emas|emas]] -- Provides player <code>!emas</code> and <code>!as</code> commands.(emote as)
 
* [[Script:ScriptCards|ScriptCards]] -- A scripting language in an API Script. Used to produce nicely formatted output cards for attacks, spells, and other abilities.
 
* [[Script:ScriptCards|ScriptCards]] -- A scripting language in an API Script. Used to produce nicely formatted output cards for attacks, spells, and other abilities.
Line 49: Line 53:
 
* [[Script:Rollable_Table_Macros|Rollable Table Macros]] -- Use macros and chat commands with [[Roll Table|rollable tables]]
 
* [[Script:Rollable_Table_Macros|Rollable Table Macros]] -- Use macros and chat commands with [[Roll Table|rollable tables]]
 
* '''{{forum|permalink/9430875/ DiscreteWhisper}}''' -- multi-recipient whispers with asides and buttons
 
* '''{{forum|permalink/9430875/ DiscreteWhisper}}''' -- multi-recipient whispers with asides and buttons
 +
* {{forum|permalink/7506126/ Check It Out}} -- allows players to examine nearby objects(tokens) and learn more information about them by having a message appear in the chat. Can be set up with system-specific properties, such as automated Investigation skill checks that reveal more information based on the rolled result.  {{repo|Roll20/roll20-api-scripts/blob/master/CheckItOut/README.md Readme}}
 +
* {{forum|permalink/9956771/ Dialog}} -- a script that makes chat a bit more fun and easier to parse, especially for games that don't use voice. It also makes it much easier to get the GM's attention in a busy game. by [[Keith]]
 +
** {{repo|keithcurtis1/Scripts/tree/main/Dialog sourcecode}}
  
 
== Combat==
 
== Combat==
Combat scripts assist in making combat flow more easily. This can mean anything from automatically handling initiative, to automating exchanges between combatants.
+
Universal combat scripts assist in making combat flow more easily. This can mean anything from automatically handling initiative({{Turn Tracker}}), automating exchanges between combatants, or doing more comprehensive management. Scripts made for specific Game systems or Roll20 sheets are listed on [[#D&D 5E]] &
 
* '''[[Script:Group Initiative|GroupInitiative]]''' -- Adds the selected tokens to the turn order after rolling their initiative + configurable data.
 
* '''[[Script:Group Initiative|GroupInitiative]]''' -- Adds the selected tokens to the turn order after rolling their initiative + configurable data.
 
* '''{{forum|permalink/9441420/ CombatMaster}}''' -- API for improving various aspects of combat. Automating condition duration in combat, Initiative improvement, and more. Version of CombatMaster in API Drowdown might not be latest version, check thread/repo for latest version. {{repo|vicberg/CombatMaster CombatMaster repo}}
 
* '''{{forum|permalink/9441420/ CombatMaster}}''' -- API for improving various aspects of combat. Automating condition duration in combat, Initiative improvement, and more. Version of CombatMaster in API Drowdown might not be latest version, check thread/repo for latest version. {{repo|vicberg/CombatMaster CombatMaster repo}}
Line 58: Line 65:
 
* [[Script: Fumbler|Fumbler]] -- Quick method of determining the outcome of a fumble.
 
* [[Script: Fumbler|Fumbler]] -- Quick method of determining the outcome of a fumble.
 
* [[Script:InitiativeTrackerPlus|InitiativeTrackerPlus]] -- Initiative and effect tracker with other features.
 
* [[Script:InitiativeTrackerPlus|InitiativeTrackerPlus]] -- Initiative and effect tracker with other features.
 
+
* ''ChatTurnManager'' -- A script to simplify Turn Order Management, and move it into chat.
== Dynamic Lighting ==
+
[[Dynamic Lighting]] is a Plus/Pro 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 <code>walls</code> 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.
+
 
+
Not all APIs, or all thier features work on both Legacy DL and [[UDL|Updated DL]], you have to check them closer to know that.
+
 
+
* '''{{forum|permalink/7698809/ DoorKnocker}}''' -- Script helps quickly open and close doors by controlling the dynamic lighting lines. {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}}
+
* [[Script:DLEllipseDrawer|DLEllipseDrawer]] -- Draw circles and ellipses on the dynamic lighting layer.
+
* [[Script:Dynamic Light Recorder|Dynamic Light Recorder]] -- Save dynamic lighting paths for map tiles and automatically regenerate later
+
* LightCrumbTrails -- Produces lit, shared-vision breadcrumbs behind character tokens. This allows them to see where they've been on maps with dynamic lighting.
+
* [[Script:Move Lighting|Move Lighting]] -- Move dynamic lighting polygon path objects between game layers.
+
* {{forum|post/4932580/script-one-way-dynamic-lighting/ One-Way Dynamic Lighting}} -- Allows you to set up dynamic lighting walls that allow you to see through one side, but not the other. (Works for [[LDL|Legacy DL]])
+
* [[Script:Torch|Torch]] -- A simple script for giving lights to tokens and turning off and on dynamic lighting.
+
* {{forum|post/9521203/script-udlwindows-dynamic-lighting-paths-that-block-movement-but-not-vision-or-light-warning-updated-dynamic-lighting-only#post-9532981 UDLWindows}} -- API for creating DL lines that blocks movement, but doesn't block vision. (for [[UDL|Updated Dynamic Lighting]]
+
* [[Script:Walls|Walls]] -- Builds Dynamic Lighting walls with an exported SVG path file.
+
* [[Script:ShareVision|ShareVision]] -- Allows normal vision and darkvision to be shared.
+
  
 
== Jukebox ==
 
== Jukebox ==
Line 87: Line 79:
  
 
==Maps & Drawing==
 
==Maps & Drawing==
Various APIs related to the Map that isn't related to Dynamic Lighting, or focused on Tokens.
+
Various APIs related to the Map that isn't related to [[Dynamic Lighting]], nor focused on [[Tokens]].
* ''Areas of Effect''
+
* {{fpl|4041327/ Areas of Effect}} -- let's players spawn AoE effects on the map(based on what GM made available.
* ''DryErase'' – An API that can stop players from drawing on the map.
+
* {{forum|permalink/2948292/ DryErase}} – An API that can stop players from drawing on the map.
 +
* {{forum|permalink/8339585/ Hexploration}} -- Script allows the GM to conceal areas of a hex grid with individual opaque hexes. Then characters can explore the hexes to reveal them. {{repo|Roll20/roll20-api-scripts/tree/master/Hexploration#hexploration Readme}}
 
* [[Script:Map Lock|MapLock]] -- Provides locking of graphics to prevent moving/resizing/rotating them.  Also highlighting.
 
* [[Script:Map Lock|MapLock]] -- Provides locking of graphics to prevent moving/resizing/rotating them.  Also highlighting.
 
* [[Script:MapChange|MapChange]] -- Provides an easy and user friendly way to move players between maps.
 
* [[Script:MapChange|MapChange]] -- Provides an easy and user friendly way to move players between maps.
 
* [[Script:Page Navigator|Page Navigator]] -- Easily move players from page to page, and allow players to move to pages by moving their tokens. '''Note:''' Version 2 have some known issues.
 
* [[Script:Page Navigator|Page Navigator]] -- Easily move players from page to page, and allow players to move to pages by moving their tokens. '''Note:''' Version 2 have some known issues.
* [[Script:TruePageCopy|TruePageCopy]] -- Duplicate page graphics by chat command, or with the Duplicate Page button. ''(Partially obsolete since Roll20 implemented their update to Copying Pages in Q4 2020)''
 
 
* '''{{forum|permalink/9137492/ Radar}}''' -- to simulate various types of radar, tremor sense etc. Includes options for [[DL]].
 
* '''{{forum|permalink/9137492/ Radar}}''' -- to simulate various types of radar, tremor sense etc. Includes options for [[DL]].
 +
* [[Script:TruePageCopy|TruePageCopy]] -- Duplicate page graphics by chat command, or with the Duplicate Page button. ''(Partially obsolete since Roll20 implemented their update to Copying Pages in Q4 2020)''
 +
 +
=== Dynamic Lighting ===
 +
[[Dynamic Lighting]] is a [[Plus]]/[[Pro]] 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 <code>walls</code> [[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.
 +
 +
Not all APIs, or all thier features work on both Legacy DL and [[UDL|Updated DL]], you have to check them closer to know that.
 +
 +
* '''{{fpl|9919591/ DoorKnocker}}''' -- Script helps quickly open and close doors by controlling the dynamic lighting lines. '''v1.211''' Introduces option to create "[[windows]]", sections that stop movement but not sight. {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}} | {{yt.be|JaRF9LhhPcc Tutorial}}
 +
* {{forum|post/9521203/script-udlwindows-dynamic-lighting-paths-that-block-movement-but-not-vision-or-light-warning-updated-dynamic-lighting-only#post-9532981 UDLWindows}} -- API for creating DL lines that blocks movement, but doesn't block vision. (for [[UDL|Updated Dynamic Lighting]])
 +
* {{forum|permalink/9939691/ UDLPasswall}} - Walls that block sight but not movement
 +
* [[Script:DLEllipseDrawer|DLEllipseDrawer]] -- Draw circles and ellipses on the dynamic lighting layer.
 +
* [[Script:Dynamic Light Recorder|Dynamic Light Recorder]] -- Save dynamic lighting paths for map tiles and automatically regenerate later
 +
* {{fpl|4428847/ LightCrumbTrails}} -- Produces lit, shared-vision breadcrumbs behind character tokens. This allows them to see where they've been on maps with dynamic lighting. (Made for [[LDL]])
 +
** {{gist|shdwjk/29cd674266fce53387899f3e797b2100 UDL version of LightCrumb}}, by [[Aaron]] (not tested)
 +
* [[Script:Move Lighting|Move Lighting]] -- Move dynamic lighting polygon path objects between game layers.
 +
* {{forum|post/4932580/script-one-way-dynamic-lighting/ One-Way Dynamic Lighting}} -- Allows you to set up dynamic lighting walls that allow you to see through one side, but not the other. (Works for [[LDL|Legacy DL]])
 +
* [[Script:Torch|Torch]] -- A simple script for giving lights to tokens and turning off and on dynamic lighting.
 +
* [[Script:Walls|Walls]] -- Builds Dynamic Lighting walls with an exported <code>.svg</code> path file.
 +
* [[Script:ShareVision|ShareVision]] -- Allows normal vision and darkvision to be shared.
 +
* {{fpl|9719344/ ToggleDaylight}} -- turn daylight mode on, off, or toggle it for LDL or UDL on the current page.
  
 
==Tokens==
 
==Tokens==
 +
APIs that focus on interacting with [[tokens]], or some aspect of them.
  
 
* '''[[Script:Token Mod|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.
 
* '''[[Script:Token Mod|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.
 +
* {{forum|permalink/9934364/ Reporter}} -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
 +
* {{forum|permalink/8996556/ WeaponArcs}} -- provides a means to add weapon arcs to tokens for visualization of range and targetable tokens
  
 
===Movement, Rotation, and Size ===
 
===Movement, Rotation, and Size ===
 
Scripts which are triggered by or change the location of tokens should generally be placed in this category.
 
Scripts which are triggered by or change the location of tokens should generally be placed in this category.
  
 +
* {{forum|permalink/8584976/ Bump}} - provides a way to invisibly manipulate tokens on the GM Layer from the Objects Layer, and vice versa.
 
* '''[[Script:Token Lock|TokenLock]]''' -- Allows GMs to selectively lock the movement of Player Tokens.
 
* '''[[Script:Token Lock|TokenLock]]''' -- Allows GMs to selectively lock the movement of Player Tokens.
 +
* {{forum|permalink/5503029/ Carry Tokens}} -- Allows tokens to "carry" and move other tokens, like dragging other characters or moving items.
 
* [[Script:Collision Detection|Collision Detection]] -- Handles collisions between player-controlled tokens and a subset of path objects on the page
 
* [[Script:Collision Detection|Collision Detection]] -- Handles collisions between player-controlled tokens and a subset of path objects on the page
 
* [[Script:DupCharToken|DupCharToken]] -- Duplicate a Character and Token, and add identifying number to Character and Token.
 
* [[Script:DupCharToken|DupCharToken]] -- Duplicate a Character and Token, and add identifying number to Character and Token.
* [[Script:It's a Trap|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
+
* '''[[Script:It's a Trap|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
 
* [[Script:KABOOM|KABOOM]] -- Creates explosion effects that move tokens away from or towards a point.
 
* [[Script:KABOOM|KABOOM]] -- Creates explosion effects that move tokens away from or towards a point.
 
* [[Script:Marching Order|Marching Order]] -- Makes tokens follow each other in some specified order.
 
* [[Script:Marching Order|Marching Order]] -- Makes tokens follow each other in some specified order.
 
* [[Script:Measure|Measure]] -- Measure distances between multiple tokens, both from the corners and the center.
 
* [[Script:Measure|Measure]] -- Measure distances between multiple tokens, both from the corners and the center.
 
* [[Script:Random Rotate|Random Rotate]] -- Allows the GM to easily rotate all selected tokens to a random angle.
 
* [[Script:Random Rotate|Random Rotate]] -- Allows the GM to easily rotate all selected tokens to a random angle.
* {{forum|post/9436375/script-teleport-from-scratch-teleport-token Teleport}} -- Teleports tokens within a page or between pages either by chat menu or token movement by using teleport tokens on the GM layer.
+
* '''[[Script:Teleport|Teleport]]''' -- Teleports tokens within a page or between pages either by chat menu or token movement by using teleport tokens on the GM layer.
 
* [[Script:tokenFate|Token Fate]] -- Let fate decide! Randomly selects a token from the selected group.
 
* [[Script:tokenFate|Token Fate]] -- Let fate decide! Randomly selects a token from the selected group.
 
* [[Script:Flip Tokens|Flip Tokens]] -- Flip graphics horizontally and/or vertically
 
* [[Script:Flip Tokens|Flip Tokens]] -- Flip graphics horizontally and/or vertically
Line 119: Line 136:
 
===Conditions, Status, Health ===
 
===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.
 
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'' -- System to easily display empjis in a bubble above Character Tokens, or on the map.
+
* {{forum|permalink/9605567/ Emojibubble}} -- System to easily display emojis in a bubble above Character Tokens, or on the map.
* ''Aura/Tint HealthColors'' -- Script to set health indicator on tokens via aura or tint, based on a bars value.
+
 
* [[Script:Flight|Flight]] -- Mark how high tokens are flying
 
* [[Script:Flight|Flight]] -- Mark how high tokens are flying
 +
* ''Health Status'' -- makes it possible for GM & players to see ''roughly'' how much health an enemy has. can be used with this macro: <code>!hp @{target|token_id}</code>
 
* [[Script:Mark|Mark]] -- Places a numbered Marker under tokens, clears on turn change/close, and page change.
 
* [[Script:Mark|Mark]] -- Places a numbered Marker under tokens, clears on turn change/close, and page change.
 
* [[Script:Marking Conditions|Marking Conditions]] -- Set status markers on targeted on individual tokens
 
* [[Script:Marking Conditions|Marking Conditions]] -- Set status markers on targeted on individual tokens
 
* [[Script:Token Name Number|Token Name Number]] -- Automatic Numbering of tokens with special placeholder.
 
* [[Script:Token Name Number|Token Name Number]] -- Automatic Numbering of tokens with special placeholder.
 
* [[Script:Monster Hit Dice|Monster Hit Dice]] -- Set Monster hit points from hit dice on add, usually via drag from journal.
 
* [[Script:Monster Hit Dice|Monster Hit Dice]] -- Set Monster hit points from hit dice on add, usually via drag from journal.
 +
* ''Aura/Tint HealthColors'' -- Script to set health indicator on tokens via aura or tint, based on a bars value.
  
 
== Utility ==
 
== Utility ==
 
Scripts in this category are a bit more ''meta'', or does a variety of things, so they didn't fit neatly into any other category. These scripts assist with Roll20 itself more than they assist the game you're playing.
 
Scripts in this category are a bit more ''meta'', or does a variety of things, so they didn't fit neatly into any other category. These scripts assist with Roll20 itself more than they assist the game you're playing.
  
* [[Script:API Heart Beat|API Heart Beat]] -- Provides an API Heartbeat for how the APIs in the game perform,  by setting the requesting player's color continuously.
+
* [[Script:API Heart Beat|API Heart Beat]] -- Provides an API Heartbeat for how the APIs in the game perform,  by setting the requesting player's color continuously. Diagnostics Tool.
 +
* {{forum|permalink/7580899/ Hands Up}} -- allows players to "raise their hand" to get GM's attention witha simple button that makes the players character flash.
 
* [[Script:Game Timer|Game Timer]] -- This is a simple script to court how long does player use the game room.
 
* [[Script:Game Timer|Game Timer]] -- This is a simple script to court how long does player use the game room.
 
* [[Script:MetaMacros|MetaMacros]] -- Precompiler enabling C-style textual substitution macros in macro definitions.
 
* [[Script:MetaMacros|MetaMacros]] -- Precompiler enabling C-style textual substitution macros in macro definitions.
* [[Script:Table Export|Table Export]] -- A script for exporting Rollable Tables between accounts.
 
 
* [[Script:Customizable Roll Listener|Customizable Roll Listener]] -- Customizable responses to API or non API chat messages.
 
* [[Script:Customizable Roll Listener|Customizable Roll Listener]] -- Customizable responses to API or non API chat messages.
 +
* {{fpl|9817678/ SelectManager}} -- a way to preserve the portions of a message that are present in a user-generated message but lost in an api-generated message (the selected tokens, who sent the message, and the playerid).
 +
** Useful for transferring token selection from one API to another, such as [[PowerCards]] to [[ChatSetAttr]]
 
* [[Script:StatusInfo|StatusInfo]] -- StatusInfo works nicely together with Tokenmod, DeathTracker, and InspirationTracker scripts. It shows condition descriptions whenever a statusmarker is set or when the command <code>!condition</code> is used, eg: <code>!condition prone</code>
 
* [[Script:StatusInfo|StatusInfo]] -- StatusInfo works nicely together with Tokenmod, DeathTracker, and InspirationTracker scripts. It shows condition descriptions whenever a statusmarker is set or when the command <code>!condition</code> is used, eg: <code>!condition prone</code>
 
* {{forum|post/8824428/script-universalvttimporter-import-dd2vtt-files-to-create-dynamic-lighting-lines-and-lights UniversalVTTImporter}} -- for importing DL settings and other info from maps created with the <code>.dd2vtt</code>, as used by Dungeondraft.
 
* {{forum|post/8824428/script-universalvttimporter-import-dd2vtt-files-to-create-dynamic-lighting-lines-and-lights UniversalVTTImporter}} -- for importing DL settings and other info from maps created with the <code>.dd2vtt</code>, as used by Dungeondraft.
 +
* {{forum|permalink/8293909/ Supernotes}} -- script pulls the contents from a token's GM Notes field.
 +
** If the token represents a character, you can optionally pull in the Bio or GM notes from the character. The user can decide whether to whisper the notes to the GM or broadcast them to all players.
 +
** Finally, there is the option to add a footer to notes whispered to the [[GM]]. This footer creates a chat button to give the option of sending the notes on to the players.
 +
* {{fpl|4121164/ NoteLog}} -- provides an easy interface to keeping notes for your players.
 +
* {{fpl|5250301/ Search}} --  provides full text searching across handouts and characters (including attributes). Search respects permissions on handouts and characters.
 +
===[[Cards]] & [[Roll Tables]]===
 +
APIs specifically for interacting with [[Cards]] & [[Roll tables]]
 +
* {{fpl|7687278/ Dealer}} -- Deals and takes cards from players, can specify selection by deck (by [[Keith]])
 +
* {{forum|permalink/7081435/ PeekCards}} -- See what you played face down, but don't let others peek at them.
 +
* {{fpl|2286409/ DealInit}} -- Deals initiative cards for Savage Worlds
  
== D&D 5E ==
+
 
 +
* [[Script:Table Export|Table Export]] -- A script for exporting Rollable Tables between accounts.
 +
* {{forum|permalink/7844658/ RecursiveTable}} -- RecursiveTable provides a way to expand the results of Rollable Tables which have inline rolls within them.
 +
* [[Script:Rollable_Table_Macros|Rollable Table Macros]] -- Use macros and chat commands with [[Roll Table|rollable tables]]
 +
 
 +
== [[5E|D&D 5E]] ==
 
Many APIs( beyond the ones listed here) are made with '''Dungeons & Dragons 5th Edition''' in mind, or have specific commands tailored to work with the popular [[D&D 5E by Roll20]]-character sheet. In the one-click menu, most APIs made for 5E should have a name starting with '''D&D 5E'''. 5E is the system that have most system-specific APIs by a large margin. Several generic APIs have configuration settings tailored for the 5E sheets, such as '''[[Script:Group Initiative|GroupInitiative]]''' or '''GroupCheck'''.
 
Many APIs( beyond the ones listed here) are made with '''Dungeons & Dragons 5th Edition''' in mind, or have specific commands tailored to work with the popular [[D&D 5E by Roll20]]-character sheet. In the one-click menu, most APIs made for 5E should have a name starting with '''D&D 5E'''. 5E is the system that have most system-specific APIs by a large margin. Several generic APIs have configuration settings tailored for the 5E sheets, such as '''[[Script:Group Initiative|GroupInitiative]]''' or '''GroupCheck'''.
  
 
* '''[[D%26D_5E_by_Roll20#Utilizing_the_5th_Edition_OGL_by_Roll20_Companion_API_Script|5th Edition OGL by Roll20 Companion]]''' -- Official Companion script for '''[[D&D 5E by Roll20]]''' character sheet
 
* '''[[D%26D_5E_by_Roll20#Utilizing_the_5th_Edition_OGL_by_Roll20_Companion_API_Script|5th Edition OGL by Roll20 Companion]]''' -- Official Companion script for '''[[D&D 5E by Roll20]]''' character sheet
 
* [https://github.com/Roll20/roll20-api-scripts/blob/master/5E%20Resting%20in%20Style/README.md 5E Resting in Style] -- This script for the 5E OGL character sheet solves the error prone task of updating your character sheet when resting. Using !long-rest and !short-rest commands will update your sheet, and report to you everything it is doing.
 
* [https://github.com/Roll20/roll20-api-scripts/blob/master/5E%20Resting%20in%20Style/README.md 5E Resting in Style] -- This script for the 5E OGL character sheet solves the error prone task of updating your character sheet when resting. Using !long-rest and !short-rest commands will update your sheet, and report to you everything it is doing.
* ''5E BattleMaster'' -- streamlining combat with the 5E sheet. {{repo|iantoon0/5E-BattleMaster Readme}}
+
* {{repo|iantoon0/5E-BattleMaster 5E BattleMaster}} -- streamlining combat with the 5E sheet.  
* ''5E Dungeon Master Tools'' -- Tool Framework for extending Roll20, auto mark tokens dead, award xp, add on modules for Barbarian and Paladin abilities.  {{repo|Roll20/roll20-api-scripts/tree/master/RatWorkshop_DungeonMasterTools Readme}}
+
* {{repo|Roll20/roll20-api-scripts/tree/master/RatWorkshop_Dungeon 5E Master Tools}} -- Tool Framework for extending Roll20, auto mark tokens dead, award xp, add on modules for Barbarian and Paladin abilities.   
 +
* ''{{forum|forum/permalink/8652406/ Rest and Recovery}}'' -- Short & Long Rest automation, by Keith
 +
* ''{{forum|permalink/8856337/ WildShape}}'' -- Managing Druid Wildshape, changing token image, setting HP and temporary stats, etc.
 +
* [[Script:5e Shaped Companion Script|5e Shaped Companion]] -- Support script for the [[DnD5e Shaped Character Sheet|DnD5e Shaped]] Character Sheet - provides monster import, auto-ammo, auto-HD, auto-death saves, loads of config options and more
 +
* '''D&D 5E - Token Action Maker''' - This script creates token actions on selected tokens for the [[D&D 5E by Roll20]] sheet, very helpful for both NPCs and Players.
 +
** {{forum|permalink/8458497 forum thread}} (Created by Kevin, modified by keithcurtis, {{user profile|157788|GiGs}}, & Bretmckee)
 +
* {{fpl|9989663/ Blind Rolls for 5E}}
 +
* ''Rest in Style'' -- Short & Long Rest automation
 
* ''CashMaster'' -- for managing you currencies
 
* ''CashMaster'' -- for managing you currencies
 
* ''Concentration'' -- Concentration keeps track of characters concentration, and reminds to do a concentration check.
 
* ''Concentration'' -- Concentration keeps track of characters concentration, and reminds to do a concentration check.
Line 150: Line 192:
 
* ''ShortRest'' -- Automating recovery of various resource during Short Rest
 
* ''ShortRest'' -- Automating recovery of various resource during Short Rest
 
* ''SpellMaster'' -- a high-performance total-replacement for the Spells page of the [[D&D 5E by Roll20]]-sheet, with several additional key features that go beyond the default spells page.
 
* ''SpellMaster'' -- a high-performance total-replacement for the Spells page of the [[D&D 5E by Roll20]]-sheet, with several additional key features that go beyond the default spells page.
* ''Rest and Recovery'' -- Short & Long Rest automation, by Keith
 
* ''Rest in Style'' -- Short & Long Rest automation
 
* ''WildShape'' -- Managing Druid Wildshape, changing token image, setting HP and temporary stats, etc.
 
* [[Script:5e Shaped Companion Script|5e Shaped Companion]] -- Support script for the [[DnD5e Shaped Character Sheet|DnD5e Shaped]] Character Sheet - provides monster import, auto-ammo, auto-HD, auto-death saves, loads of config options and more
 
*
 
  
 
== System Toolbox ==
 
== System Toolbox ==
 
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 sections above).
 
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 sections above).
  
'''It's A Trap!''' have several game-specific versions.
+
'''[[Script:It's a Trap|It's A Trap!]]''' have several game-specific versions.
 
=== 13th Age ===
 
=== 13th Age ===
  
Line 178: Line 215:
 
* [[Script:Wild Dice|Wild Dice]] -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"   
 
* [[Script:Wild Dice|Wild Dice]] -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"   
  
=== Earthdawn ===
+
=== [[Earthdawn]] ===
 
* [[Earthdawn - FASA Official|Earthdawn (FASA Official)]] -- A companion to the Earthdawn (FASA Official) and 1879 (FASA Official) character sheets, this provides many features such as automatically creating token actions and helping with accounting, calculating Target Numbers and checking for number of successes, Etc.
 
* [[Earthdawn - FASA Official|Earthdawn (FASA Official)]] -- A companion to the Earthdawn (FASA Official) and 1879 (FASA Official) character sheets, this provides many features such as automatically creating token actions and helping with accounting, calculating Target Numbers and checking for number of successes, Etc.
  
Line 194: Line 231:
 
=== Numenera ===
 
=== Numenera ===
 
* [[Script:Cypher Roller|Cypher Roller]] -- Script to automatically roll Cyphers in Numenera, with full descriptions.
 
* [[Script:Cypher Roller|Cypher Roller]] -- Script to automatically roll Cyphers in Numenera, with full descriptions.
* [[Script:Numenera_Natha|Natha's Numenera]] -- Adds Numenera rolls and character update functions to the Natha's Numenera character sheets: [https://github.com/Roll20/roll20-character-sheets/tree/master/Numenera_NathasNumenera_English "Numenera (tabbed)"] and  [https://github.com/Roll20/roll20-character-sheets/tree/master/Numenera_NathasNumenera_French "Numenera (French)"].
+
* [[Script:Numenera_Natha|Natha's Numenera]] -- Adds Numenera rolls and character update functions to the Natha's Numenera character sheets: [https://github.com/Roll20/roll20-character-sheets/tree/master/Numenera_NathasNumenera_English "Numenera (tabbed)"] and  {{repo|Roll20/roll20-character-sheets/tree/master/Numenera_NathasNumenera_French "Numenera (French)"}}.
  
=== Pathfinder ===
+
=== [[Pathfinder]] ===
 
* [[Script:Skillbook|Pathfinder Skillbook]] -- Generate token action to put API buttons for skills in chat window
 
* [[Script:Skillbook|Pathfinder Skillbook]] -- Generate token action to put API buttons for skills in chat window
 
* [[Script:HL-Import|Pathfinder HeroLab Character Import]] -- Import characters from Hero Lab via XML
 
* [[Script:HL-Import|Pathfinder HeroLab Character Import]] -- Import characters from Hero Lab via XML
Line 203: Line 240:
 
=== Pathfinder 2nd Edition ===
 
=== Pathfinder 2nd Edition ===
 
* [[Script:Pathfinder_2_Utilities|Pathfinder 2 Utilities]] -- automatically roll Pathfinder 2 abilities and display their effect references, and track modifiers.
 
* [[Script:Pathfinder_2_Utilities|Pathfinder 2 Utilities]] -- automatically roll Pathfinder 2 abilities and display their effect references, and track modifiers.
* [https://app.roll20.net/forum/post/9683168/script-pathfinder-2e-treat-wounds#post-9686795 Pathfinder 2E Treat Wounds]
+
* {{forum|post/9683168/script-pathfinder-2e-treat-wounds#post-9686795 Pathfinder 2E Treat Wounds}}
* [https://app.roll20.net/forum/post/9718635/script-pathfinder-2e-character-adjustments Pathfinder 2E Character Adjustments]
+
* {{forum|post/9718635/script-pathfinder-2e-character-adjustments Pathfinder 2E Character Adjustments}}
  
 
=== Savage Worlds ===
 
=== Savage Worlds ===
 
* [[Script:Raise Count|Raise Count]] -- Counts raises on a roll against a given target number
 
* [[Script:Raise Count|Raise Count]] -- Counts raises on a roll against a given target number
 
* [[Script:Savage_Worlds_Raise_Roller|Savage Worlds Raise Roller]] -- Rolls for extra or wildcard and then shows a list of target numbers that are success or success with raises.
 
* [[Script:Savage_Worlds_Raise_Roller|Savage Worlds Raise Roller]] -- Rolls for extra or wildcard and then shows a list of target numbers that are success or success with raises.
 +
* {{fpl|2286409/ DealInit}} -- Deals cards for initiative for Savage Worlds
 
* ''Savage Worlds Status Changer'' -- This script makes it easy to assign a status to a set of selected tokens.
 
* ''Savage Worlds Status Changer'' -- This script makes it easy to assign a status to a set of selected tokens.
  
=== Star Wars ===
+
=== [[Shadowrun]]===
 +
 
 +
'''5E'''
 +
 
 +
* {{repo|Roll20/roll20-api-scripts/tree/master/Shadowrun%205th%20Edition Shadowrun 5th Edition}} -- API helper for the "Shadowrun 5th Edition"-sheet by [[Cassie]]
 +
* [[Script:SR-RollExtender|SR-RollExtender]] -- Deals with Shadowrun specific rules like glitches and extended rolls. For the "Shadowrun: 5th Edition (Advanced)" sheet.
 +
* [[Script:SR-NextPass|SR-NextPass]] -- GM aid to handle moving on to the next initiative pass
 +
 
 +
=== [[Star Wars]] ===
 
Scripts for the various Star Wars systems.
 
Scripts for the various Star Wars systems.
  
Line 218: Line 264:
 
* [[Script:Wild Dice|Wild Dice]] -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"   
 
* [[Script:Wild Dice|Wild Dice]] -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"   
  
=== Shadowrun===
+
=== [[Starfinder]] ===
 
+
* [[Script:Starfinder - Guidance Tools for Starfinder (Simple) Character sheet|Starfinder - Guidance Tools for Starfinder (Simple) Character sheet]] -- Provides commands to populate character sheets from Stat blocks. ([https://github.com/russellasinclair/guidance/blob/develop/guidance.js Beta Test Branch can be found at this link.] Disclaimer: Beta Test branch is in active development. )
'''5E'''
+
 
+
* [https://github.com/Roll20/roll20-api-scripts/tree/master/Shadowrun%205th%20Edition Shadowrun 5th Edition] -- API helper for the "Shadowrun 5th Edition"-sheet by Cassie
+
* [[Script:SR-RollExtender|SR-RollExtender]] -- Deals with Shadowrun specific rules like glitches and extended rolls. For the "Shadowrun: 5th Edition (Advanced)" sheet.
+
* [[Script:SR-NextPass|SR-NextPass]] -- GM aid to handle moving on to the next initiative pass
+
  
 
=== Trail of Cthulhu ===
 
=== Trail of Cthulhu ===
Line 240: Line 281:
 
* [[Script:WFRP4e|WFRP4e]] -- Oops!, Critical Hit Location, and Critical Hit result support for Warhammer Fantasy 4th Edition.
 
* [[Script:WFRP4e|WFRP4e]] -- Oops!, Critical Hit Location, and Critical Hit result support for Warhammer Fantasy 4th Edition.
  
== Library==
+
== Library/Meta Scripts==
 
'''Library''' scripts are generally not intended to be used alone or directly by the user. These scripts will not do anything for your campaign directly, but rather they create functions to be used by other APIs.
 
'''Library''' scripts are generally not intended to be used alone or directly by the user. These scripts will not do anything for your campaign directly, but rather they create functions to be used by other APIs.
  
Line 252: Line 293:
 
* [[Script:Token Collisions|Token Collisions]] -- A library for detecting collisions among tokens during movement.
 
* [[Script:Token Collisions|Token Collisions]] -- A library for detecting collisions among tokens during movement.
 
* [[Script:Vector Math|Vector Math]] -- A library for vector mathematics.
 
* [[Script:Vector Math|Vector Math]] -- A library for vector mathematics.
* '''{{forum|permalink/9771314/ APILogic}}''' -- Gives If/ElseIf/Else Processing to Other Scripts
+
* '''{{fpl|10005695/ Meta Toolbox}}''' A set of APIs created by [[timmaugh]] that covers a lot of ground
* '''{{forum|permalink/9770117/ libInline}}''' - provides an easy interface for inlinerolls
+
** [[APILogic]] -- Gives If/ElseIf/Else Processing, Inline Math operations, and Variable Muling to Other Scripts | {{forum|permalink/9771314/ APILogic}}
* '''{{forum|permalink/9097236/ InsertArg}}''' -- script preamp, siege engine, menu maker, command line constructor
+
** {{forum|permalink/9770117/ libInline}} - provides an easy interface for inlinerolls
* '''{{forum|permalink/9817678/ SelectManager}}''' -- Utility to Preserve the Selected Tokens For API-Generated Calls
+
** {{forum|permalink/9817678/ SelectManager}} -- Utility to Preserve the Selected Tokens For API-Generated Calls
 +
* {{forum|permalink/9097236/ InsertArg}} -- script preamp, siege engine, menu maker, command line constructor
  
 
=APIs elsewhere=
 
=APIs elsewhere=
Line 266: Line 308:
  
 
==APIs elsewhere==
 
==APIs elsewhere==
 +
* {{fpl|874303 Splatter v2}} -- Bloodsplatter automatically appear on map when token's HP gets low enough.
 +
* [[Script:Blood_And_Honor:_Automatic_blood_spatter,_pooling_and_trail_effects|Script:Blood And Honor]] -- automatic blood splatters
 
* [[Script:Random Dungeon Generator|Random Dungeon Generator]] -- Generates random dungeons with geomorphic tiles. (link to a github gist of the API)
 
* [[Script:Random Dungeon Generator|Random Dungeon Generator]] -- Generates random dungeons with geomorphic tiles. (link to a github gist of the API)
 
* [[Script:Morality|Morality]] -- A dialog prompt that provides morality choices as decisions (link to github)
 
* [[Script:Morality|Morality]] -- A dialog prompt that provides morality choices as decisions (link to github)
Line 272: Line 316:
 
* [https://app.roll20.net/forum/post/9631549/idea-dimmerswitch Dimmerswitch] -- WIP API to handle changing of lighting intensity/color on the map, such as sunset/sunrise happening
 
* [https://app.roll20.net/forum/post/9631549/idea-dimmerswitch Dimmerswitch] -- WIP API to handle changing of lighting intensity/color on the map, such as sunset/sunrise happening
 
* [https://app.roll20.net/forum/post/6638045/script-simpleroofcontrol SimpleRoofControl] -- A roof "lifting" system to show/hide rooms or houses. It also gives the option to turn the Advanced Fog of War and Dynamic Lighting on or off so you can have those features enabled only inside the building. {{repo|blawson69/SimpleRoofControl sourcecode}}
 
* [https://app.roll20.net/forum/post/6638045/script-simpleroofcontrol SimpleRoofControl] -- A roof "lifting" system to show/hide rooms or houses. It also gives the option to turn the Advanced Fog of War and Dynamic Lighting on or off so you can have those features enabled only inside the building. {{repo|blawson69/SimpleRoofControl sourcecode}}
 +
* {{forum|permalink/9924560/ Live Handouts/GMNotes -tread}} - {{gist|ILiekTofu/3958622e66b500a535122e666936339c sourcecode}}
  
 
= Special Thanks =
 
= Special Thanks =
Roll20 wants to give special thanks to [https://app.roll20.net/users/235259/brian Brian] and [https://app.roll20.net/users/104025/the-aaron Aaron C. M.] for their contributions to the community and this API Script Index.
+
Roll20 wants to give special thanks to [[Brian Shields]] and [[Aaron|Aaron C. M.]] for their contributions to the community and this API Script Index.(2014)
 +
 
 +
In early 2021, [[Andreas J.]] did a major revision of the page, reorganizing with better categories, add several newer and popular APIs to the list, and added wiki/forum thread links to most listed APIs, so more info was easily accessible.
 +
 
 +
::''The category cleanup on the API index is something I intend to bring to the [[API#Install_API|API 1-click Install]], as the One-Click Menu is currently pretty hard to browser, as something like half of the APIs are categorized under "Utility", and there would be a benefit for all D&D5E-specific API to be in a separate category from the other game-specific APIs.'' [[User:1223200|1223200]] ([[User talk:1223200|talk]]) 14:29, 15 May 2021 (UTC)
 
<br>
 
<br>
 
<br>
 
<br>
 
[[Category:API|Script Index]]
 
[[Category:API|Script Index]]

Latest revision as of 14:29, 15 May 2021

Roll20 API Getting Started


Community Scripts

  • Script Index

Reference


Cookbook


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 GitHubLogo.png and follow the instructions in the GitHubLogo.png, and then continue to API:Introduction.

Contents


[edit] APIs available in One-Click Menu

If your script are designed for use with a specific game system, ruleset, or specific Roll20 character sheet, please list the API under that game system, instead of listing under one of the more generic categories. When approprate, API can be listed under more than one category.

Some great or popular APIs have their name highlighted in bold to stand out.

[edit] Characters

Various scripts related to Character Sheets, and managing them.

  • CharSheet -- Allow players to create their own character sheets.
  • -- API create and assigns character sheets to new people who join a game
  • -- Player & Character Manager. List all Player Characters divided by Player for the GM, or all assigned Characters for a Player. Add Characters for GM and Players.
  • -- Creates a "public" version of character sheets that players can't edit, which mirrors the actual character sheet.
  • -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
  • -- Manages observer players, who are given the visiblilty (and control) of all player characters. This is useful for both podcasting views and local play on a single player screen.

[edit] Equipment

Most game systems have some form of equipment to make characters better. While scripts dealing with that equipment may necessarily be 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. Can be used with any char sheet

[edit] 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.

  • ChatSetAttr -- Create, modify, and delete character attributes via chat commands or macros. ChatSetAttr can be embedded into normal macros.
  • Conditions -- Track attribute-modifying conditions.
  • EasyExperience -- Make awarding experience easy and choose your experience progression.
  • -- to record experience during a game. Inspired by EasyEx, biggest difference is that it has an option to reward experience directly.
  • Script:GroupCheck -- A way to quickly roll a group check for everyone and see if they succeed
    • -- Supplementary API to GroupCheck, which enables to automatically apply damage to a group of characters, based on failed/succeeded GroupCheck rolls. Example: Damage of an AoE Spell, based on success/fail on saving throw
  • Experience Tracker -- Automatic tracking of a Dungeons and Dragons 5e like experience system, aswell as level up announcement in chat. !xp handles experience and announces level up.

[edit] Chat

Various APIs that primarily help you out by creating API commands & options that can be used in the q Text Chat.

  • ChatSetAttr -- Create, modify, and delete character attributes via chat commands or macros.
  • ChatTurnManager -- A script to simplify Turn Order Management, and move it into chat.
  • emas -- Provides player !emas and !as commands.(emote as)
  • ScriptCards -- A scripting language in an API Script. Used to produce nicely formatted output cards for attacks, spells, and other abilities.
  • PowerCards -- Create nicely formatted output cards for attacks, spells, and other abilities.
  • PowerCards Macro Helper -- Support the automatic generation of PowerCards for "D&D 5E by Roll20" character sheet actions.
  • Message of the Day -- Greets players that log in with the contents of a particular note.
  • Rollable Table Macros -- Use macros and chat commands with rollable tables
  • -- multi-recipient whispers with asides and buttons
  • -- allows players to examine nearby objects(tokens) and learn more information about them by having a message appear in the chat. Can be set up with system-specific properties, such as automated Investigation skill checks that reveal more information based on the rolled result. GitHubLogo.png
  • -- a script that makes chat a bit more fun and easier to parse, especially for games that don't use voice. It also makes it much easier to get the GM's attention in a busy game. by Keith

[edit] Combat

Universal combat scripts assist in making combat flow more easily. This can mean anything from automatically handling initiative(t Turn Tracker), automating exchanges between combatants, or doing more comprehensive management. Scripts made for specific Game systems or Roll20 sheets are listed on #D&D 5E &

  • GroupInitiative -- Adds the selected tokens to the turn order after rolling their initiative + configurable data.
  • -- API for improving various aspects of combat. Automating condition duration in combat, Initiative improvement, and more. Version of CombatMaster in API Drowdown might not be latest version, check thread/repo for latest version. GitHubLogo.png
  • EncounterHelper -- Group tokens into encounters that can be shown, hidden, and reset to their initial values.
  • Critical -- Quick method of determining the outcome of a critical hit.
  • Fumbler -- Quick method of determining the outcome of a fumble.
  • InitiativeTrackerPlus -- Initiative and effect tracker with other features.
  • ChatTurnManager -- A script to simplify Turn Order Management, and move it into chat.

[edit] Jukebox

The u Jukebox is the music player, and some APIs interact with it

  • Roll20 Audio Master -- Comprehensive jukebox control script; play, stop, and loop tracks. Adjust volume of tracks. Create, edit, play, stop, loop, and shuffle playlists.
  • PowerCards -- Create nicely formatted output cards for attacks, spells, and other abilities. Have options to interact with Jukebox.

[edit] Generators

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

  • Dungeon Utils -- Generates random dungeons from wall and floor images.
  • namegen -- Generates random names of People, Towns/Cities, and Taverns
  • Terrain Generator -- Generate simple outdoor maps (forests, deserts, etc)

[edit] Maps & Drawing

Various APIs related to the Map that isn't related to Dynamic Lighting, nor focused on Tokens.

  • -- let's players spawn AoE effects on the map(based on what GM made available.
  • – An API that can stop players from drawing on the map.
  • -- Script allows the GM to conceal areas of a hex grid with individual opaque hexes. Then characters can explore the hexes to reveal them. GitHubLogo.png
  • MapLock -- Provides locking of graphics to prevent moving/resizing/rotating them. Also highlighting.
  • MapChange -- Provides an easy and user friendly way to move players between maps.
  • Page Navigator -- Easily move players from page to page, and allow players to move to pages by moving their tokens. Note: Version 2 have some known issues.
  • -- to simulate various types of radar, tremor sense etc. Includes options for DL.
  • TruePageCopy -- Duplicate page graphics by chat command, or with the Duplicate Page button. (Partially obsolete since Roll20 implemented their update to Copying Pages in Q4 2020)

[edit] Dynamic Lighting

Dynamic Lighting is a Plus/Pro 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.

Not all APIs, or all thier features work on both Legacy DL and Updated DL, you have to check them closer to know that.

  • -- Script helps quickly open and close doors by controlling the dynamic lighting lines. v1.211 Introduces option to create "windows", sections that stop movement but not sight. GitHubLogo.png | Youtube-logo.png
  • -- API for creating DL lines that blocks movement, but doesn't block vision. (for Updated Dynamic Lighting)
  • - Walls that block sight but not movement
  • DLEllipseDrawer -- Draw circles and ellipses on the dynamic lighting layer.
  • Dynamic Light Recorder -- Save dynamic lighting paths for map tiles and automatically regenerate later
  • -- Produces lit, shared-vision breadcrumbs behind character tokens. This allows them to see where they've been on maps with dynamic lighting. (Made for LDL)
  • Move Lighting -- Move dynamic lighting polygon path objects between game layers.
  • -- Allows you to set up dynamic lighting walls that allow you to see through one side, but not the other. (Works for Legacy DL)
  • 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.
  • ShareVision -- Allows normal vision and darkvision to be shared.
  • -- turn daylight mode on, off, or toggle it for LDL or UDL on the current page.

[edit] Tokens

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.
  • -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
  • -- provides a means to add weapon arcs to tokens for visualization of range and targetable tokens

[edit] Movement, Rotation, and Size

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

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

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

  • -- 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. can be used with this macro: !hp @{target|token_id}
  • 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
  • Token Name Number -- 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 -- Script to set health indicator on tokens via aura or tint, based on a bars value.

[edit] Utility

Scripts in this category are a bit more meta, or does a variety of things, so they didn't fit neatly into any other category. These scripts assist with Roll20 itself more than they assist the game you're playing.

  • API Heart Beat -- Provides an API Heartbeat for how the APIs in the game perform, by setting the requesting player's color continuously. Diagnostics Tool.
  • -- allows players to "raise their hand" to get GM's attention witha simple button that makes the players character flash.
  • Game Timer -- This is a simple script to court how long does player use the game room.
  • MetaMacros -- Precompiler enabling C-style textual substitution macros in macro definitions.
  • Customizable Roll Listener -- Customizable responses to API or non API chat messages.
  • -- a way to preserve the portions of a message that are present in a user-generated message but lost in an api-generated message (the selected tokens, who sent the message, and the playerid).
  • StatusInfo -- StatusInfo works nicely together with Tokenmod, DeathTracker, and InspirationTracker scripts. It shows condition descriptions whenever a statusmarker is set or when the command !condition is used, eg: !condition prone
  • -- for importing DL settings and other info from maps created with the .dd2vtt, as used by Dungeondraft.
  • -- script pulls the contents from a token's GM Notes field.
    • If the token represents a character, you can optionally pull in the Bio or GM notes from the character. The user can decide whether to whisper the notes to the GM or broadcast them to all players.
    • Finally, there is the option to add a footer to notes whispered to the GM. This footer creates a chat button to give the option of sending the notes on to the players.
  • -- provides an easy interface to keeping notes for your players.
  • -- provides full text searching across handouts and characters (including attributes). Search respects permissions on handouts and characters.

[edit] Cards & Roll Tables

APIs specifically for interacting with Cards & Roll tables

  • -- Deals and takes cards from players, can specify selection by deck (by Keith)
  • -- See what you played face down, but don't let others peek at them.
  • -- Deals initiative cards for Savage Worlds


[edit] D&D 5E

Many APIs( beyond the ones listed here) are made with Dungeons & Dragons 5th Edition in mind, or have specific commands tailored to work with the popular D&D 5E by Roll20-character sheet. In the one-click menu, most APIs made for 5E should have a name starting with D&D 5E. 5E is the system that have most system-specific APIs by a large margin. Several generic APIs have configuration settings tailored for the 5E sheets, such as GroupInitiative or GroupCheck.

  • 5th Edition OGL by Roll20 Companion -- Official Companion script for D&D 5E by Roll20 character sheet
  • 5E Resting in Style -- This script for the 5E OGL character sheet solves the error prone task of updating your character sheet when resting. Using !long-rest and !short-rest commands will update your sheet, and report to you everything it is doing.
  • GitHubLogo.png -- streamlining combat with the 5E sheet.
  • GitHubLogo.png -- Tool Framework for extending Roll20, auto mark tokens dead, award xp, add on modules for Barbarian and Paladin abilities.
  • -- Short & Long Rest automation, by Keith
  • -- Managing Druid Wildshape, changing token image, setting HP and temporary stats, etc.
  • 5e Shaped Companion -- Support script for the DnD5e Shaped Character Sheet - provides monster import, auto-ammo, auto-HD, auto-death saves, loads of config options and more
  • D&D 5E - Token Action Maker - This script creates token actions on selected tokens for the D&D 5E by Roll20 sheet, very helpful for both NPCs and Players.
    • (Created by Kevin, modified by keithcurtis, GiGs, & Bretmckee)
  • Rest in Style -- Short & Long Rest automation
  • CashMaster -- for managing you currencies
  • Concentration -- Concentration keeps track of characters concentration, and reminds to do a concentration check.
  • It's a Trap! -- D&D 5E Generic' (should detect automatically what sheet is used)
  • ShortRest -- Automating recovery of various resource during Short Rest
  • SpellMaster -- a high-performance total-replacement for the Spells page of the D&D 5E by Roll20-sheet, with several additional key features that go beyond the default spells page.

[edit] System Toolbox

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 sections above).

It's A Trap! have several game-specific versions.

[edit] 13th Age

  • 13th Age Official Character Sheet Companion -- Enhances the Official 13th Age Character Sheet with quick Escalation Die tracking, automatic recovery tracking, token setup, and automatic staggered and down icons.

[edit] Ars Magica

[edit] Chronique Oubliées

  • COFantasy -- Combats, Skills and Spells support

[edit] Cypher System

  • Cypher System Sheet -- Enables the applying of stat cost, recovery roll advance, auto calculation of PC state and damage track in the Cypher System Sheet, from the roll template or sheet buttons, for both the "English" and "French" versions.
  • Cypher Systems by Roll20 Companion -- Enables the applying to characters of Stats costs and Recovery rolls advancement from the chat roll template, as well as applying Damage to NPCs.

[edit] 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.

  • Wild Dice -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"

[edit] Earthdawn

  • Earthdawn (FASA Official) -- A companion to the Earthdawn (FASA Official) and 1879 (FASA Official) character sheets, this provides many features such as automatically creating token actions and helping with accounting, calculating Target Numbers and checking for number of successes, Etc.

[edit] Exalted

  • Exalted 3rd Edition Dice Roller -- A more robust dice rolling script for use with the Exalted Third Edition game system.
  • exaltScript -- Adds general utility and automation to Exalted 3rd Edition campaigns.

[edit] FATE

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

[edit] HERO Systems

This includes Champions, Star HERO, Fantasy HERO, Traveller HERO, etc.

[edit] Numenera

[edit] Pathfinder

  • Pathfinder Skillbook -- Generate token action to put API buttons for skills in chat window
  • Pathfinder HeroLab Character Import -- Import characters from Hero Lab via XML
  • Pathfinder Companion Script -- The Pathfinder Companion Script automates many of the day to day tasks of playing in and running a pathfinder game. The script is designed for the Neceros Pathfinder Sheet for Roll20

[edit] Pathfinder 2nd Edition

[edit] Savage Worlds

  • Raise Count -- Counts raises on a roll against a given target number
  • Savage Worlds Raise Roller -- Rolls for extra or wildcard and then shows a list of target numbers that are success or success with raises.
  • -- Deals cards for initiative for Savage Worlds
  • Savage Worlds Status Changer -- This script makes it easy to assign a status to a set of selected tokens.

[edit] Shadowrun

5E

  • GitHubLogo.png -- API helper for the "Shadowrun 5th Edition"-sheet by Cassie
  • SR-RollExtender -- Deals with Shadowrun specific rules like glitches and extended rolls. For the "Shadowrun: 5th Edition (Advanced)" sheet.
  • SR-NextPass -- GM aid to handle moving on to the next initiative pass

[edit] Star Wars

Scripts for the various Star Wars systems.

  • Star Wars: FFG - Dice Roller -- Dice Roller for the Star Wars: FFG (API-Compatible)-character sheet
  • Star Wars: Fantasy Flight Games - Destiny Tracker -- SW FFG Destiny Tracker provides a way to prompt, set and track destiny points for Star Wars: Edge of the Empire (Fantasy Flight Games)
  • Wild Dice -- Implements the Wild Dice rolling mechanic, used in "Star Wars D6", "D6 Adventure", "D6 Fantasy", and "D6 Space"

[edit] Starfinder

[edit] Trail of Cthulhu

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


[edit] Warhammer Fantasy Roleplay

2E

  • WFRP 2E Actions (Havoc) -- Functions and Roll Templates in support of the Warhammer Fantasy Roleplay 2E Sheet by Paul "Havoc" Stein

4E

  • WFRP4e -- Oops!, Critical Hit Location, and Critical Hit result support for Warhammer Fantasy 4th Edition.

[edit] Library/Meta Scripts

Library scripts are generally not intended to be used alone or directly by the user. These scripts will not do anything for your campaign directly, but rather they create functions to be used by other APIs.

APIs installed from the one-click menu should automatically install any Library scripts that are needed for them to work, or warn about needing additional APIs installed.

[edit] APIs elsewhere

Some known APIs aren't available in the One-Click Install menu in Roll20, but might be hosted elsewhere and manually installed. This is an attempt to list prominent ones.

[edit] Not Available in One-Click Menu

This is a list of API that are still hosted in Roll20's API script repository, but for one reason or other isn't available in the One-Click install.

  • -- Combat API, formerly known as "Initiative Tracker Plus"
  • Creature Gen -- Generate combat ready tokens from PRD and D20PFSRD statblocks (Obsolete - no longer supported)

[edit] APIs elsewhere

  • -- Bloodsplatter automatically appear on map when token's HP gets low enough.
  • Script:Blood And Honor -- automatic blood splatters
  • Random Dungeon Generator -- Generates random dungeons with geomorphic tiles. (link to a github gist of the API)
  • Morality -- A dialog prompt that provides morality choices as decisions (link to github)
  • Track V20 Attributes -- Track character Disciplines, Paths, and Backgrounds for use with macros and other scripts.(link to Github)
  • Matt's Door Script -- Older Script that's somewhat popular, link to an version that The Aaron have updated in 2017.
  • Dimmerswitch -- WIP API to handle changing of lighting intensity/color on the map, such as sunset/sunrise happening
  • SimpleRoofControl -- A roof "lifting" system to show/hide rooms or houses. It also gives the option to turn the Advanced Fog of War and Dynamic Lighting on or off so you can have those features enabled only inside the building. GitHubLogo.png
  • - GitHubLogo.png

[edit] Special Thanks

Roll20 wants to give special thanks to Brian Shields and Aaron C. M. for their contributions to the community and this API Script Index.(2014)

In early 2021, Andreas J. did a major revision of the page, reorganizing with better categories, add several newer and popular APIs to the list, and added wiki/forum thread links to most listed APIs, so more info was easily accessible.

The category cleanup on the API index is something I intend to bring to the API 1-click Install, as the One-Click Menu is currently pretty hard to browser, as something like half of the APIs are categorized under "Utility", and there would be a benefit for all D&D5E-specific API to be in a separate category from the other game-specific APIs. Andreas J. (talk) 14:29, 15 May 2021 (UTC)