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 "Player API"

From Roll20 Wiki

Jump to: navigation, search
m (add TokenMod)
m
(5 intermediate revisions by 2 users not shown)
Line 12: Line 12:
 
Most of these APIs makes the GMs life easier by themselves, even without granting players any access to them.
 
Most of these APIs makes the GMs life easier by themselves, even without granting players any access to them.
 
==Expand Permissions==
 
==Expand Permissions==
</noinclude>Some [[GM]]-only features can be indirectly be granted to [[players]] through using different [[API|APIs]]:
+
</noinclude>Some [[GM]]-only features can be indirectly granted to [[players]] through the use of different [[API|APIs]]:
  
 
* '''[[Script:CharSheet|CharSheet]]''' -- A simple and easily customizable script allowing players to create their own character sheets, using the command <code>!charsheet</code>
 
* '''[[Script:CharSheet|CharSheet]]''' -- A simple and easily customizable script allowing players to create their own character sheets, using the command <code>!charsheet</code>
Line 19: Line 19:
 
** '''v1.211''' Introduces option to create "[[Windows|windows]]", sections that stop movement but not sight.  {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}}
 
** '''v1.211''' Introduces option to create "[[Windows|windows]]", sections that stop movement but not sight.  {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}}
 
* '''[[Script:emas|emas]]''' -- Provides player <code>!emas</code> and <code>!as</code> commands. This is equvivalent to the [[Text_Chat#Speaking_and_Emoting_as_a_Random_NPC_.28.2Fas.29_.28.2Femas.29|<code>/emas</code>]], which is GM-only
 
* '''[[Script:emas|emas]]''' -- Provides player <code>!emas</code> and <code>!as</code> commands. This is equvivalent to the [[Text_Chat#Speaking_and_Emoting_as_a_Random_NPC_.28.2Fas.29_.28.2Femas.29|<code>/emas</code>]], which is GM-only
* '''[[Script:MapChange|MapChange]]''' -- has option to allow players to move between map pages, and GM can choose which pages are available/visible to them  
+
* '''[[Script:MapChange|MapChange]]''' -- has option to allow players to move between map pages, and GM can choose which pages are available/visible to them
 +
* '''{{fpl|4742980/ Observer}}''' -- handy way to add/remove players as "Observer", who can see & control all player characters.
 
* '''{{forum|permalink/6213379/ PublicSheet}}''' — create public, read-only versions of character sheets
 
* '''{{forum|permalink/6213379/ PublicSheet}}''' — create public, read-only versions of character sheets
 
* '''[[Roll20AM|Roll20 Audio Master]]''' (aka. '''Roll20AM''') -- API commands to manage the {{Jukebox}}, GM can grant selective access to individual players/tracks
 
* '''[[Roll20AM|Roll20 Audio Master]]''' (aka. '''Roll20AM''') -- API commands to manage the {{Jukebox}}, GM can grant selective access to individual players/tracks
Line 28: Line 29:
 
==Restrict Permissions==</noinclude>
 
==Restrict Permissions==</noinclude>
 
There are also API that can be used to '''restrict players''' more that normal:
 
There are also API that can be used to '''restrict players''' more that normal:
* '''{{forum|permalink/2948292/ DryErase}}''' – An API that can stop players from [[Drawing Tool|drawing]] on the map, deleting any drawing instantly.
+
* '''{{fpl|2948292/ DryErase}}''' – An API that can stop players from [[Drawing Tool|drawing]] on the map, deleting any drawing instantly.
* '''[[Script:Token Lock|TokenLock]]''' – Allows GMs to selectively lock the movement of Player [[Tokens]]. - Useful for when you want to pause the situation and prevent players from accidentally revealing too much.
+
* '''[[Script:Token Lock|TokenLock]]''' – Allows GMs to lock/unlock the movement of all Player [[Tokens]]. - Useful for when you want to pause the situation and prevent players from accidentally moving forward.
 +
* '''[[MapLock]]''' - similar to TokenMod, but can be used for locking down any individual graphic/token on the map, so even the GM can't accidentally move things.
 +
** Useful if you want players to have control over a token otherwise(see stats, edit/see name & notes), but stop it form being moved.
 
<noinclude>==Related Pages==
 
<noinclude>==Related Pages==
 
* [[Game Management]]
 
* [[Game Management]]
Line 40: Line 43:
 
* [[Complete Macro Guide]]
 
* [[Complete Macro Guide]]
 
* [[Community FAQ]]
 
* [[Community FAQ]]
 +
* [[Streaming|Streaming Roll20]]
 
<br>
 
<br>
 
<br>
 
<br>
 
[[Category:API]][[Category:Tips]]</noinclude>
 
[[Category:API]][[Category:Tips]]</noinclude>

Revision as of 11:59, 13 April 2021

Main Page: API

This is a guide listing various API scripts that can be used for expanding or restricting what players normally can do in Roll20. Normally, people in a campaign is either:

  • the GM/Creator, who have full access and visibility to everything in a game, or
  • a player, who can only see and affect a limited number of things, most of which a GM explicitly needs give the player permissions/access to


This base system lacks some granularity and has some frustrations to first-time users(like how a GM needs to create & assign character sheets to players), but there are surprisingly many API that can change that.

Using these APIs you can hand some campaign responsibilities to individual or all players, or to create a "Co-GM" that can do almost as many things as an actual GM, when needed.

Most of these APIs makes the GMs life easier by themselves, even without granting players any access to them.

Expand Permissions

Some GM-only features can be indirectly granted to players through the use of different APIs:

  • CharSheet -- A simple and easily customizable script allowing players to create their own character sheets, using the command !charsheet
  • DoorKnocker(Forum) -- Enables players to reveal/hide Dynamic Lighting sections such as doors. The GM can change doors from between locked/unlocked to adjust which doors the players can open. Speeds up DL management for GM as well.
    • can be used for revealing hidden door
    • v1.211 Introduces option to create "windows", sections that stop movement but not sight. sourcecode
  • emas -- Provides player !emas and !as commands. This is equvivalent to the /emas, which is GM-only
  • MapChange -- has option to allow players to move between map pages, and GM can choose which pages are available/visible to them
  • Observer(Forum) -- handy way to add/remove players as "Observer", who can see & control all player characters.
  • PublicSheet(Forum) — create public, read-only versions of character sheets
  • Roll20 Audio Master (aka. Roll20AM) -- API commands to manage the u Jukebox, GM can grant selective access to individual players/tracks
  • Teleport -- provides a way for GMs or players to teleport tokens within,or between, map pages
  • TokenMod -- For managing token properties with chat commands. Usually players have limited control of their token settings, apart from editing the three bubbles.
    • Includes setting that enables players to target tokens they don't control


Restrict Permissions

There are also API that can be used to restrict players more that normal:

  • DryErase(Forum) – An API that can stop players from drawing on the map, deleting any drawing instantly.
  • TokenLock – Allows GMs to lock/unlock the movement of all Player Tokens. - Useful for when you want to pause the situation and prevent players from accidentally moving forward.
  • MapLock - similar to TokenMod, but can be used for locking down any individual graphic/token on the map, so even the GM can't accidentally move things.
    • Useful if you want players to have control over a token otherwise(see stats, edit/see name & notes), but stop it form being moved.

Related Pages