Revision as of 17:03, 22 January 2015

Template:Mentors only

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

• Auto Initiative -- Adds the players to the initiative tracker, rolls randomly for them and adds relevant modifiers.
• Automatic Initiative Roller and Round Counter --
• Cone and Circle Templates --
• Highlight Token at Top of Initiative -- Highlights the token at the top of initiative.
• Initiative Highlighter -- Highlights a token whose turn it is with a flashing aura.
• InitiativeTracker -- Round counter and status effect manager with optional announcements to chat.
• Random Turn Order -- Randomly assigns a turn to selected tokens.
• Range Finder -- Determines the distance between two named tokens
• Roll comparisons -- Comparing roll results.
• Round Tracker -- Adds a marker in the initiative which increments automatically.

Tokens - Conditions / Status / Health

• Automatic Status Markers -- Automatically adjust status markers on tokens
• Automatic Temp HP Management -- Uses temporary hit points and sets it to automatically remove them first.
• 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
• Heal Chat Command -- Use commands to heal characters
• HP Change Announcement -- Announces when tokens' hit points changes.
• Target Marking -- System for marking tokens with status markerAuto create a token
• Updated Heal Chat Command --

Template:Apibox top Template:Apibox getting started Template:Apibox reference Template:Apibox bottom

Tokens - Movement

• Auto Teleporting and Chat Based Teleporting -- Teleporting based on text commands or token locations.
• Carrying Tokens -- Tokens carrying other tokens such as torches.
• Character Token Locator -- Creates an aura and shrinks it slowly to help you find your token.
• Collision Detection -- Handles collisions between player-controlled tokens and a subset of path objects on the page
• Disable Rotation via Chat Window Command -- Disable the rotation of tokens in the chat window.
• It's a Trap -- Script for setting traps and detecting collisions with them at any point during movement.
• Marching Order -- Tracking marching order of characters
• Movement Tracker and Aura Highlighter -- Uses auras to track character movement based on speeds.
• No Token Rotation -- Prevents tokens from being rotated
• Patrolling Tokens -- Script for patrolling tokens.
• Time/Torch Tracker -- Shrinking light auras of torches.
• Trap script -- Script for using traps.
• Units Moved -- Tracks units moved.
• Visual Hourglass -- Visual UI interface. Uses for asking players to wait.

Lighting and Revealing

• Dynamic Lighting Animation -- Animate a sequence of changes to the dynamic lighting layer
• Light Switch -- Script for turning on and off lights with chat commands.
• Reveal command -- Automatically moves tokens from the GM layer to objects layer, making them reveal to players.
• The Darkness is Closing In -- Example script for reducing light on a token every time it moves.

Characters - Equipment

• Set Weapon Values Using the API -- Tracks weapons equipped by characters.
• Trader Joes -- Inventory Management

Generators

• It's the Monster Mash! -- It's the Monster Mash! An adventure in Encounters!
• Random Dungeon Generator -- Generates random dungeons with geomorphic tiles
• Weather Generator Script --

System

• Chat Command Script -- Script for standardizing and preventing duplication of chat commands.
• Custom Power Cards -- Format messages for chat in an compact and appealing manner
• Detecting Nearest Token -- Script for detecting the nearest token after one is moved.
• Graphic/Token snapshot saving/loading for building your own macros -- System for tracking a loading token set ups
• Scrolling Macro Bar --
• Store Commands -- Store a series of commands for repeated execution
• String Formatter -- Formats a string for printing.

Roleplay

• Language Script -- A script for auto converting text to elven or dwarven.
• What Did He Say? -- Language based scripting

Misc

• API command process, standard model -- API command process, standard model.

Game Specific Scripts

AD&D (Dungeons and Dragons 2e)

• Character Sheet (AD&D) --

Basic Fantasy Role Playing Game

• Basic Fantasy Role-Playing Game --

DnD 4th Edition

• Combat -- temporary hit points. Also prevents over healing.
• Combat Engine --
• Helper -- 4th edition collection of scripts.
• Monster Generator --
• Tools -- 4th edition. Adds marking to the Combat script.

Edge of the Empire

• Dice --
• Dice with Images in the Chat Window --

Exalted Second Edition

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

Fantasy Craft 2nd Printing

• Damage Save --
• Token Management --

HERO System

• Automate Combat --

Pathfinder

• All In One --
• Character Sheet --
• Inspired Collection --

Savage Worlds

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

Star Wars Saga

• Character Sheet --

Zombie Dice

• Zombie Dice -- A Script for playing 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.

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