Difference between revisions of "Player API"
From Roll20 Wiki
Andreas J. (Talk | contribs) m |
Andreas J. (Talk | contribs) m (add DoorKnocker) |
||
| Line 7: | Line 7: | ||
This base system lacks some granularity and has some frustrations to first-time users(like how a GM needs to [[Adding Character Sheet|create & assign character sheets]] to players), but there are surprisingly many API that can change that. | This base system lacks some granularity and has some frustrations to first-time users(like how a GM needs to [[Adding Character Sheet|create & assign character sheets]] to players), but there are surprisingly many API that can change that. | ||
| − | Using these APIs you can hand some campaign | + | 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== | ==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 be granted to [[players]] through using different [[API|APIs]]: | ||
* '''[[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 | ||
* '''[[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 | ||
| − | * ''' | + | * '''[[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: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> | ||
* '''{{forum|permalink/6213379/ PublicSheet}}''' — create public, read-only versions of character sheets | * '''{{forum|permalink/6213379/ PublicSheet}}''' — create public, read-only versions of character sheets | ||
| + | * '''{{forum|permalink/9919591/ DoorKnocker}}''' -- 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|windows]]", sections that stop movement but not sight. {{repo|Roll20/roll20-api-scripts/tree/master/Door%20Knocker sourcecode}} | ||
<br><noinclude> | <br><noinclude> | ||
==Restrict Permissions==</noinclude> | ==Restrict Permissions==</noinclude> | ||
Revision as of 17:25, 3 April 2021
 | This is about a Roll20 feature exclusive to Pro-subscribers (and often to players in a Game created by a Pro-subscriber). If you'd like to use this feature, consider upgrading your account. |
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 be granted to players through using different APIs:
- emas -- Provides player
!emasand!ascommands. This is equvivalent to the/emas, which is GM-only - Roll20 Audio Master (aka. Roll20AM) -- API commands to manage the u Jukebox, GM can grant selective access to individual players/tracks
- MapChange -- has option to allow players to move between map pages, and GM can choose which pages are available/visible to them
- CharSheet -- A simple and easily customizable script allowing players to create their own character sheets, using the command
!charsheet - PublicSheet(Forum) — create public, read-only versions of character sheets
- 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
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 selectively lock the movement of Player Tokens. - Useful for when you want to pause the situation and prevent players from accidentally revealing too much.
Related Pages
- Game Management
- API:Script Index - longer list of APIs
- Subscription | Free vs Plus vs Pro
- Character Sheets
- Complete Macro Guide
- Community FAQ
