Roll20 Wiki

{{supporters only}}
{{Tocright}}

This repository is the collection of all the community-contributed API scripts that are available for use on Roll20.

== Contributing ==
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.

== Scripts By Category ==
=== General Purpose Scripts ===
==== Combat Scripts ====
* [[Script:Auto_Initiative|Auto Initiative]] -- Adds the players to the initiative tracker, rolls randomly for them and adds relevant modifiers.
* [[Script:Initiative_highlighter|Initiative Highlighter]] -- Highlights a token whose turn it is with a flashing aura.
* [[Script:Roll_Comparisons|Roll comparisons]] -- Comparing roll results.
* [[Script:Random_Turn_Order|Random Turn Order]] -- Randomly assigns a turn to selected tokens.
* [[Script:Round_Tracker|Round Tracker]] -- Adds a marker in the initiative which increments automatically.
* [[Script:Highlight_Token_at_Top_of_Initiative|Highlight Token at Top of Initiative]] -- Highlights the token at the top of initiative.
* [[Script:Range_Finder|Range Finder]] -- Determines the distance between two named tokens
* [[Script:Automatic_Initiative_Roller_and_Round_Counter|Automatic Initiative Roller and Round Counter]] --
* [[Script:Cone_and_Circle_Templates|Cone and Circle Templates]] --

==== Tokens - Conditions / Status / Health ====
* [[Script:Blood_And_Honor:_Automatic_blood_spatter,_pooling_and_trail_effects|Blood And Honor]] -- Automatic blood spatter, pooling and trail effects
* [[Script:Conditions_and_Status_Tracker|Conditions and Status Tracker]] -- Tracks the status of tokens and announces them as the duration passes.
* [[Script:Automatic_Status_Markers|Automatic Status Markers]] -- Automatically adjust status markers on tokens
* [[Script:HP_Change_Announcement|HP Change Announcement]] -- Announces when tokens’ hit points changes.
* [[Script:Heal_Chat_Command|Heal Chat Command]] -- Use commands to heal characters
* [[Script:Updated_Heal_Chat_Command|Updated Heal Chat Command]] -- 
* [[Script:Automatic_Temp_HP_Management|Automatic Temp HP Management]] -- Uses temporary hit points and sets it to automatically remove them first.
* [[Script:Target_Marking|Target Marking]] -- System for marking tokens with status markerAuto create a token

==== Tokens - Movement ====
* [[Script:Auto_Teleporting_and_Chat_Based_Teleporting|Auto Teleporting and Chat Based Teleporting]] -- Teleporting based on text commands or token locations.
* [[Script:Marking_Order|Marching Order]] -- Tracking marching order of characters
* [[Script:Carrying_Tokens|Carrying Tokens]] -- Tokens carrying other tokens such as torches.
* [[Script:Movement_Tracker_and_Aura_Highlighter|Movement Tracker and Aura Highlighter]] -- Uses auras to track character movement based on speeds.
* [[Script:Character_Token_Locator|Character Token Locator]] -- Creates an aura and shrinks it slowly to help you find your token.
* [[Time/Torch Tracker]] -- Shrinking light auras of torches.
* [[Script:Units_Moved|Units Moved]] -- Tracks units moved.
* [[Script:Disable_Rotation|Disable Rotation via Chat Window Command]] -- Disable the rotation of tokens in the chat window.
* [[Script:Visual_Hourglass|Hourglass, Stopwatch, etc.]] -- Visual UI interface. Uses for asking players to wait.
* [[Script:Patrolling_Tokens|Patrolling Tokens]] -- Script for patrolling tokens.
* [[Script:Trap_Script|Trap script (like in vid)]] -- Script for using traps.
* [[Script:Interpolated_Trap_Detection|Interpolated trap detection]] --

==== Lighting and Revealing ====
* [[Script:Light_Switch|Light Switch]] -- Script for turning on and off lights with chat commands.
* [[Script:Reveal_Command|!reveal command]] -- Automatically moves tokens from the GM layer to objects layer, making them reveal to players.
* [[Script:Light_Is_Closing_In|Light is Closing In...]] -- A light reduction script for token movement.

==== Characters - Equipment ====
* [[Script:Set_Weapon_Value_Using_The_API|Set Weapon Values Using the API]] -- Tracks weapons equipped by characters.
* [[Script:Trader_Joes|Trader Joes]] -- Inventory Management

==== Generators ====
* [[Script:Its_the_Monster_Mash|It's the Monster Mash!]] -- It's the Monster Mash! An adventure in Encounters!
* [[Script:Weather_Generator_Script|Weather Generator Script]] --

==== System ====
* [[Script:Graphic_Token_Snapshot_Saving_and_Loading|Graphic/Token snapshot saving/loading for building your own macros]] -- System for tracking a loading token set ups
* [[Script:String_Formatter|String Formatter]] -- Formats a string for printing.
* [[Script:Detecting_Nearest_Token|Detecting Nearest Token]] -- Script for detecting the nearest token after one is moved.
* [[Script:Chat_Command_Script|Chat Command Script]] -- Script for standardizing and preventing duplication of chat commands.
* [[Script:Scrolling_Macro_Bar|Scrolling Macro Bar]] --
* [[Script:IsGM Auth Module|IsGM Auth Module]] -- Provides a function isGM() for determining if a player id refers to a gm. Intended for use alongside other scripts.

==== Roleplay ====
* [[Script:Language_Script|Language Script]] -- A script for auto converting text to elven or dwarven.
* [[Script:What_Did_He_Say|What Did He Say?]] -- Language based scripting

==== Misc ====
* [[Script:API_Command_Process_Standard_Model|API command process, standard model]] -- API command process, standard model.

{{apibox top|right}}
{{apibox getting started}}
{{apibox reference}}
{{apibox bottom}}

=== Game Specific Scripts ===
==== Edge of the Empire ====
* [[Script:Edge_Of_The_Empire:Dice_With_Images_In_The_Chat_Window|Edge of the Empire Dice with Images in the Chat Window]] --
* [[Script:Edge_Of_The_Empire:Dice|Edge of the Empire Dice]] --

==== DnD 4th Edition ====
* [[Script:DnD4E:Combat|Combat]] -- temporary hit points. Also prevents over healing.
* [[Script:DnD4E:Tools|Tools]] -- 4th edition. Adds marking to the Combat script.
* [[Script:DnD4E:Helper|4e Helper]] -- 4th edition collection of scripts.
* [[Script:DnD4E:Combat_Engine|4e combat engine]] -- 
* [[Script:DnD4E:Monster_Generator_Base_On_MM3_Math|4e Monster generator based on MM3 math]] --

==== Zombie Dice ====
* [[Script:Zombie_Dice:Zombie_Dice|Zombie Dice]] -- A Script for playing zombie dice

==== Basic Fantasy Role Playing Game ====
* [[Script:Basic_Fantasy_Role_Playing_Game:General|Basic Fantasy Role-Playing Game]] --

==== HERO System ====
* [[Script:HERO_System:Scripts_To_Automate_Combat|Scripts to Automate the Combat]] --

==== AD&D (Dungeons and Dragons 2e)  ====
* [[Script::DnD2E:Character_Sheet|2nd Ed Character Sheet]] --

==== Pathfinder ====
* [[Script:Pathfinder:All_In_One|All In One]] --
* [[Script:Pathfinder:Character_Sheet_Generator_v3|Pathfinder Character Sheet Generator v3]] -- 
* [[Script:Pathfinder:Character_Sheet_Generator|Character Sheet Generator]] -- 
* [[Script:Pathfinder:Inspired_Collection|Inspired Collection]] --

==== Star Wars Saga ====
* [[Script:StarWarsSaga:Character_Sheet|Star Wars Saga Edition Character Sheet]] --

==== Fantasy Craft 2nd Printing ====
* [[Script:FantasyCraft2E:Standard_Character_Token_Management|Fantasy Craft (2nd printing) - Standard character token management]] --
* [[Script:FantasyCraft2E:Standard_Character_Damage_Save|Fantasy Craft - Standard character damage save]] --

=== Utility Scripts ===


[[Category:API|Script Index]]