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 "Token Features"

From Roll20 Wiki

Jump to: navigation, search
(Moved bold section labels to subtitles to support linking.)
m (Token Lock)
 
(62 intermediate revisions by 11 users not shown)
Line 1: Line 1:
== Creating a New Token ==
+
{{revdate}}{{HCbox|{{hc|articles/360039674573-Token-Features Here}} }}
 +
{{cleanup-msg|'''This Page is outdated and inconsistent in a number of places.''' The UDL section is just an image + a link to the main [[UDL]] page. The {{forum|post/9483471/release-note-for-november-10-2020 new version of the Token Settings}} haven't been updated. The explaining image at the start doesn't correspond to the info text.| Jan 2020}}
 +
[[File:TokenSS1.jpg|right|thumb|800px|The token features showed when a token is selected.]]
  
Any image that is placed on the '''Objects and Tokens''' or '''GM Info Overlay''' layer automatically becomes a '''Token''' object. You still have the ability to scale and rotate the image, but there are several Token-specific elements added as well.  Note that all of these instructions also apply to [[Card_Decks_and_Rollable_Tables#Creating_a_Rollable_Table_Token | Rollable Table Tokens]].
 
  
Here is an example of a Token:
+
Tokens are the main thing you [[Move Tokens|move]] around the [[tabletop]], and they can be independent, or [[Link Token|linked]] to a [[Journal#Characters|Character]].
  
[[File:TokenSS1.jpg|right]]
+
Only [[GM|GMs]] can create & move new token to the [[Tabletop_Overview|tabletop]] or edit their deeper settings, while [[players]] can move around tokens assigned to them, and edit the name & bubbles of the token.
  
===1. Radial Menu Bubbles===  
+
==Basics==
These three input bubbles can be used by the players or the GM as a counter to keep track of health, turns, money, fuel or whatever else proves useful for your game. Click on a bubble to change the value. You can enter a new value (e.g. "20" or "ABC"), and for numerical values you can also enter relative values (e.g. "+5" will add 5 to the current value, or "-10" will subtract 10.) You can change the colored rims of the bubbles by going to '''"Token Bar Colors + Display Settings"''' section on the My Settings tab on the Sidebar and selecting different palette colors.
+
=== Creating a New Token ===
 +
Any image that is placed on the '''<span style="font-family:Pictos;">b</span> Objects and Tokens''' or '''<span style="font-family:Pictos;">E</span> GM Info Overlay''' [[Layer]] automatically becomes a '''Token''' object. You can always scale the pawn field and its image to scale by right-clicking, advancing, assigning dimensions; if you use a grid that can influence other methods of varying the dimensions of the image and avoid inconvenience. You can rotate the image using the outgrowth that designates the front of the counter from above and the top in portrait use, but several token-specific elements have also been added. Note that generally the image requires a horizontal and then a vertical reversal to respect the direction provided in the programming of Roll20.
  
===2. Bar Overla:===
+
Note that all of these instructions also apply to [[Rollable_tables#Creating_a_Rollable_Table_Token | '''Rollable Table Tokens''']](aka. Multi-sided tokens).
If set to be visible, these are passive bars that fill or empty depending on what's entered in its corresponding colored Value Bubble.
+
  
===3. Nameplate===
+
See Also: [[Link Token|Link Token to Character Sheet]]
If set to be visible, this will display the name of the Token.
+
  
===4. Edit===
+
===Move, Rotate & Scale===
Clicking on the Edit button brings up a new window where you can name the Token, set permissions on who can control the Token, set what bars/auras are visible to/editable by the players and keep storage of GM notes. ''Note: This button is only visible to the GM'' You can also double-click on the token to open the same settings dialog.
+
See [[Manipulating Graphics|Manipulating Tokens]].
  
===5. Status Indicator Overlays===
+
Every token is accompanied by image handles on each of the corners of the token and in the middle of each side. You can use these image handles in order to change the size of the token. Additionally, each token has a rotation handle that juts out from the token itself. The rotation handle represents the "front" of the token and can be used to orient the token to face any desired direction.
[[File:overlayIcons.jpg|left]]This button rolls out a menu that gives you a series of colored dots, a red X and over 40 different status icons that overlays over the Token image. You can use these to show status, ailments, or to differentiate multiples of the same Token type. You can have multiple Overlays displaying simultaneously.
+
  
You can also add a numeral to individual Overlays by mousing over the desired Overlay in the rollout menu and tapping &quot;0&quot; through to &quot;9&quot; on the keyboard or numpad. A red numeral will appear on the Overlay. Tapping &quot;0&quot; will clear the numeral from the Overlay (but the Overlay remains until it is clicked again in the menu).
+
''If you are using a grid for your play area, typically when resizing a token, it will snap to the grid. However, by holding the Alt key while using the image handles to resize you can temporarily disable this functionality. This can be very useful when aligning tokens that do not have identical dimensions.''
  
The default position for the overlays is across the top of the token, but you can choose to have them run along the bottom, right or left side by going to the '''"Token Bar Colors + Display Settings"''' section on the My Settings tab on the Sidebar and selecting the layout from the '''"Marker Position:"''' drop-down menu.
 
  
===6. Token Actions===
+
Tokens can also be moved using [[Manipulating_Graphics#Waypoints|Waypoints]]
Token Actions are specially-designated [[Macros|macros and character abilities]] which appear whenever a token is selected on the screen. They appear in a bar along the top of your screen, and the contents of the bar are context-sensitive. Check out the '''[[Token Actions]]''' page for more info.
+
  
<div style="clear: both;"></div>
+
==Token Features==
 +
===Radial Menu Bubbles (1)===
 +
[[File:TokenSS1.jpg|right|thumb|800px|The token features showed when a token is selected.]]
 +
These three input bubbles can be used by the players or the GM as a counter to keep track of health, turns, money, fuel or whatever else proves useful for your game. Click on a bubble to change the value. You can enter a new value (e.g. &quot;20&quot; or &quot;ABC&quot;), and for numerical values you can also enter relative values (e.g. &quot;+5&quot; will add 5 to the current value, or &quot;-10&quot; will subtract 10.) You can change the colored rims of the bubbles by going to '''"Token Bar Colors + Display Settings"''' section on the [[My_Settings#Game_Settings|'''My Settings''']] tab on the Sidebar and selecting different palette colors.
  
== Token Settings ==
+
===Bar Overlay (2)===
 +
If set to be visible, these are passive bars that fill or empty depending on what's entered in its corresponding colored Value Bubble.
  
Clicking the Edit button or double clicking on a Token brings up the Edit Token window:
+
===Nameplate (3)===
 +
If set to be visible, this will display the name of the Token.
  
[[File:TokenSS2.png|right]]
+
===Edit (4)===
 +
''Full section:'' '''[[Token Features#Token Settings|Token Settings]]'''
  
===1. Basic and Advanced Settings===
+
Clicking on the '''Edit/Settings'' button brings up a new window where you can name the Token, set permissions on who can control the Token, set what bars/auras are visible to/editable by the players and keep storage of GM notes. ''Note: This button is only visible to the GM'' You can also double-click on the token to open the same settings dialog.
Token settings are split into Basic and Advanced Tabs, you can seamlessly switch between tabs while editing your token information. All changes update in real-time.
+
  
===2. Represents Character===
+
===Token Markers (5)===
Here you can select whether the Token represents a [[Journal|'''Character''']] or is a None/Generic Token. If the Token is set to represent a Character then the Token will sync with that Character and the Token will automatically be updated with any changes made to the Character in the [[Journal|'''Journal''']].
+
''Main Article:'' '''[[Token Markers]]'''
  
Once a Token is tied to a Character in the Journal, a Shift+Click on the Settings icon when a token is selected or Shift+Double Clicking on the token directly will open the attached Character; Alt+Double Click opens the character to the Attributes &amp; Abilities tab.
+
[[File:overlayIcons.jpg|right]]This button rolls out a menu that gives you a series of colored dots, a red X and over 40 different markers that overlay over the Token image. You can use these to show status, ailments, or to differentiate multiples of the same Token type. You can have multiple Token Markers displaying simultaneously.
  
{{mbox | text = '''Useful Tip:''' Set up Characters in the Journal to represent each of your PCs. Then choose a Token for each Character. Place the Tokens across all the pages of your campaign, and use the Represents Character setting to link each Token to the appropriate Character. Then when your players update their Tokens or their Character, all the Tokens across every page will always stay up-to-date. See Also: [[Linking_Tokens_to_Journals|Linking Tokens to Journals]]}}
+
You can also add a numeral to individual Token Markers by mousing over the desired Token Marker in the rollout menu and tapping &quot;0&quot; through to &quot;9&quot; on the keyboard or numpad. A red numeral will appear on the Token Marker. Tapping &quot;0&quot; will clear the numeral from the Token Marker (but the Token Marker remains until it is clicked again in the menu).
  
 +
The default position for the Token Markers is across the top of the token, but you can choose to have them run along the bottom, right or left side by going to the '''"Token Bar Colors + Display Settings"''' section on the <span style="font-family:Pictos;">y</span> [[My_Settings#Game_Settings|'''My Settings''']] tab on the [[Sidebar]] and selecting the layout from the '''"Marker Position:"''' drop-down menu.
  
===3. Name===
+
You can also add [[Token Markers|Custom Token Markers]], which will appear in this menu as well.
Here you can set the name of the Token. If you choose to use the [[Turn Tracker|'''Turn Tracker''']] in your game, the Token's name will appear next to its thumbnail picture in the turn list.
+
  
===4. Controlled By===
+
===Animation Pause (6)===
This is where you assign who in your game has permission to control the Token. If the Token represents None/Generic then clicking on the &quot;Controlled By&quot; field will bring up a list of all the players in the current campaign as well as being able to select the option &quot;All Players&quot;. You can assign multiple players to a single Token. If the Token represents a specific Character, then the Token is controlled the player that has control of the Character which is set in the [[Journal|'''Journal''']]. GM always has control over the Tokens in their Campaign.
+
On animated tokens, click the pause/play button to start or stop the animation. Note that animations will not start on the VTT if the "Enable Animated Graphics" checkbox is disabled in the {{My Settings}} tab.
  
''Note: If you are creating a brand new Campaign and your players have yet to join, their names will not yet be available for Token assignment. If you're setting your Pages up in advance of your first gaming session, it's recommended to set your PC Tokens to &quot;All Players&quot; and later fine-tune the permissions when your players have visited your Campaign.''
+
===Token Actions===
 +
''Main Article:'' '''[[Token Actions]]'''
  
===5. Tint Color===
+
Token Actions are specially-designated [[Macros|'''macros''']] and [[Character#Abilities|'''character abilities''']] which appear whenever a token is selected on the screen. They appear in a bar along the top of your screen, and the contents of the bar are context-sensitive.
Here you can add a color filter to the Token.  The default tint color is transparent.
+
{{clear}}
  
===6. Bars and Auras===
+
== Token Settings ==
Bars: This is where you can set whether any of the three bar elements are either visible and/or editable to the players. The green heart, blue bolt and red cardiograph icons for the bars are there for identifying purposes only. They do not have to represent anything in particular in your game.
+
Token settings are split into '''Details''', '''GM Notes''', and '''Dynamic Lighting''' tabs. You can seamlessly switch between tabs while editing your token information. All changes update in real-time.
 +
===Details===
 +
[[File:Token-details-dec2021.png|right|thumb|500px|Details tab of token, viewed by a GM (Dec 2021)]]
 +
See '''{{hc|360039674573-Token-Features#token-settings-0-8 Token Settings - Details}}''' for full details
 +
 
 +
====General====
 +
 
 +
Check the box for "Nameplate" for the name to display on the map.
 +
 
 +
====Player Permissions====
 +
Each of the {{button| {{3dots}}|white}}-buttons adjust the player permissions for the section.
 +
* '''See''' The player(s)
 +
* '''Edit''' The player(s) controlling the token can edit the content.
 +
[[File:Token-settings-player-perms-dec-2021.png|thumb|player permissions for the nameplate]]
 +
 
 +
====Tooltip====
 +
See: [[Token Tooltip]]
 +
 
 +
====Bars====
 +
This is where you can set whether any of the three bar elements are either visible and/or editable to the players. You can also adjust if the exact values are seen by none, only the controlling player,  or everyone.
 +
 
 +
The green heart, blue bolt and red cardiograph icons for the bars are there for identifying purposes only. They do not have to represent anything in particular in your game.
  
 
You can also input numerical values for the Bar Bubbles directly from the Edit Token window. There are two input fields available for each Bar. The first field is for the Bar's current value and is what's featured in the Token's corresponding Bar Value Bubble. The second field is for the Bar's total value. If it's supplied, Roll20 will use the comparison between the two numbers to render how full or empty that corresponding Bar appears on the Tabletop. The fill will reflect whatever the Player plugs into their Bar Value Bubble while in-game.
 
You can also input numerical values for the Bar Bubbles directly from the Edit Token window. There are two input fields available for each Bar. The first field is for the Bar's current value and is what's featured in the Token's corresponding Bar Value Bubble. The second field is for the Bar's total value. If it's supplied, Roll20 will use the comparison between the two numbers to render how full or empty that corresponding Bar appears on the Tabletop. The fill will reflect whatever the Player plugs into their Bar Value Bubble while in-game.
  
Also note that if the Token Represents a Character (as chosen in the field above), you can choose to link each bar to a specific Character Attribute. If you change the value in the bar (via the Token settings, radial bubbles, or in the Character settings) the value will update automatically.
+
If the Token '''Represents a Character''' , you can choose to link each bar to a specific [[Character#Attribute|Attribute]] of the Character. If you change the value of the linked attribute anywhere(from the token bubble, the token settings, the character sheet, or using an API) the value will update automatically update both on the token & the character.
  
'''Auras:''' An Aura is a translucently filled circle or square that radiates from the center of a Token. You can have up to two Auras active at once on any given Token. To turn one on, make sure it's toggled on to See first and then enter a radius value for the Aura. Next to the Aura's radius input field is a palette button where you can choose the color for the Aura. You can set the Aura to a square instead of a circle by checking off the &quot;Square&quot; checkbox next to the color palette button.
+
====Auras====
 +
An Aura is a translucently filled circle or square that radiates from the center of a Token. You can have up to two Auras active at once on any given Token. To turn one on, make sure it's toggled on to See first and then enter a radius value for the Aura. Next to the Aura's radius input field is a palette button where you can choose the color for the Aura. You can set the Aura to a square instead of a circle by checking off the &quot;Square&quot; checkbox next to the color palette button.
  
 
''Note: To completely remove an Aura from view, do not change the radius value to zero. Clear the field instead. At zero, the Aura still draws to encircle the outer edge of the Token.''
 
''Note: To completely remove an Aura from view, do not change the radius value to zero. Clear the field instead. At zero, the Aura still draws to encircle the outer edge of the Token.''
  
===7. GM Notes===
+
===Token Lock===
 +
{{main|Token Lock}}
 +
 
 +
GMs can lock tokens in place & stop player & the GM from moving them.
 +
 
 +
===GM Notes===
 
This is a field where a GM can keep private notes on any given Token.
 
This is a field where a GM can keep private notes on any given Token.
  
[[File:TokenSS3.png|left]]
+
===Dynamic Lighting===
 +
{{plus only|section}}
 +
 
 +
Only the GM can see/edit these token settings.
 +
[[File:Token-dl-tab-dec2021.png|right|thumb|500px|DL tab of token (Dec 2021)]]
 +
* {{hc|360051754954-Token-Settings UDL Token Settings}}
 +
* [[UDL|Dynamic Lighting]]
 +
 
 +
====Advanced & legacy Settings====
 +
{| role="presentation" class="wikitable mw-collapsible mw-collapsed"
 +
| [[LDL|Legacy DL]] Token Settings
 +
|-
 +
| '''Emits Light'''
 +
 
 +
Here you can set how far light emits from the Token and if All Players can see the light emitted when '''[[LDL|Legacy Dynamic Lighting]]''' is enabled. This option allows you to enter a light radius amount and gives you a checkbox for All Players See Light. When the checkbox is left unchecked, the only player(s) who can see that token’s light emission are those who have assigned permission to that token. In addition to emitting light, you can now customize the “angle” of lights and the line of sight of tokens. So you can specify, for example, that a player should only have a 140-degree field of view instead of 360-degrees. The Multiplier feature allows you to adjust how effectively a token sees light. At a value of 1 the token sees light normally but at a value of 2 the token sees twice as far with the same light source.
  
In the Advanced Tab:
+
'''Has Sight'''
  
===8. Player Permissions===
+
Tokens that have sight and are assigned to a player or GM will always be displayed to the player that controls the token, even if [[Fog of War]] or Advanced Fog of War would normally obscure them.  
There are two possible permissions for each setting: See or Edit. You can toggle the flag for each type by checking or unchecking the corresponding box.
+
  
Setting the See flag will allow all players in the game to view the current value of the bar, or see the aura drawn on the tabletop, regardless of whether or not they can control the Token.
+
These tokens will also appear in front of other tokens on the tabletop to the controlling player.
  
Setting the Edit flag will allow all players who can control the Token (based on the &quot;Controlled By&quot; field, above) to see and edit the values of the bar, or change the radius of the aura drawn on the tabletop.
+
'''[[Advanced Fog of War]]'''
  
So if you have a Token that you want all players to see the bars for (like a PC), set the See flag. If you also want to allow some players to keep track of their own health, set the Edit flag. If you only want players who can control the Token to see and edit the bars, set only the Edit flag. And of course if you set none of the flags then only the GM will be able to see or edit the bars and auras.
+
The Advanced Fog of War Reveal Distance sets how far your token will have [[Advanced Fog of War]] revealed to it. If the token does not have a light source, the greyed-out map will be revealed. If it does have a light source, it will see the lit-up map that is illuminated. Note that a token must have sight in order to see anything or have Advanced Fog of War revealed.
{{supporters only|section=true}}
+
  
===9. Emits Light===
+
For performance reasons, tokens that are not owned by anyone do not reveal Advanced Fog of War. GMs can change this option in the Advanced Fog of War for an individual page.
Here you can set how far light emits from the Token and if All Players can see the light emitted when '''[[Dynamic Lighting]]''' is enabled. This option allows you to enter a light radius amount and gives you a checkbox for All Players See Light. When the checkbox is left unchecked, the only player(s) who can see that token’s light emission are those who have assigned permission to that token. In addition to emitting light, you can now customize the “angle” of lights and the line of sight of tokens. So you can specify, for example, that a player should only have a 140-degree field of view instead of 360-degrees. The Multiplier feature allows you to adjust how effectively a token sees light. At a value of 1 the token sees light normally but at a value of 2 the token sees twice as far with the same light source.  
+
|}
 +
{{clear}}
  
 +
=Tips=
 +
* Setup [[Link Token|Default Tokens for characters]].
 +
** This way when your change maps, you & your players can simply [[drag-n-drop]] the characters or NPCs to the map and they have a ready-to-play token.
 +
** For '''Player Characters''' and named/unique NPCs, having token bar values linked to a character attribute is a good idea, so token & sheet stay synced
 +
** For generic characters, '''don't''' link the character attributes to the token. This way you can drag-n-drop several of them to them map, and each token will track their stats individually, while still able to reference the shared stats of the NPC template.
 +
* '''[[Multi-Sided Token]]''' is a great feature with may uses for both players characters, NPCs, and even map objects
 +
** quickly changed the visuals of a player who have Wildshaped/cast illusions on themselves
 +
** A basic NPC template like goblins could have variations on how individual looks, while still linking back to same statblock
 +
** a moving labyrinth, or frequently changing location; could be sped up by having map-segments be switch-able through a multi-sided token
 +
* [[Pro]] users can install [[TokenMod]], making it possible to update & edit tokens with chat commands, along with making it possible for players to adjust their character's vision & light settings themselves, such as with [[TokenMod#Dynamic_Lighting|these]] convenient menus.
  
See Also: [[Linking_Tokens_to_Journals|Linking Tokens to Journals]]
+
=API=
 +
{{pro only|section}}{{apiboxRec}}
 +
There are plenty of API options for tokens. '''[[TokenMod]]''' stands out as making it possible to update & edit tokens with chat commands, along with making it possible for players to adjust DL settings themselves.
 +
{{:Token/API}}
  
 +
=See Also=
 +
* [[Linking_Tokens_to_Journals|Link Token to Character]]
 +
* [[Token Actions]]
 +
* [[Rollable_tables#Rollable_Table_Token|Multi-Sided Tokens]] creating a token with multiple sides, using a [[Roll Table]]
 +
* [[Manipulating Tokens]] - move, rotate, scale, using waypoints
 +
* [[Invisible Tokens]]
 +
* {{My Settings}}-tab
 +
* [[Token Z-Ordering]] — ''How tokens layer on the VTT''
 +
* [[Token Markers]] - How to add custom token markers to your game
 +
<br />
 
[[Category:Docs]]
 
[[Category:Docs]]
[[Category:NeedsUpdates]]
+
[[Category:Dynamic Lighting]]
 +
[[Category:Tokens]]
 +
[[Category:Roll20]]

Latest revision as of 13:18, 19 April 2022

Attention: This page is community-maintained. For the official Roll20 version of this article, see the Help Center for assistance: Here .

The token features showed when a token is selected.


Tokens are the main thing you move around the tabletop, and they can be independent, or linked to a Character.

Only GMs can create & move new token to the tabletop or edit their deeper settings, while players can move around tokens assigned to them, and edit the name & bubbles of the token.

Contents

[edit] Basics

[edit] Creating a New Token

Any image that is placed on the b Objects and Tokens or E GM Info Overlay Layer automatically becomes a Token object. You can always scale the pawn field and its image to scale by right-clicking, advancing, assigning dimensions; if you use a grid that can influence other methods of varying the dimensions of the image and avoid inconvenience. You can rotate the image using the outgrowth that designates the front of the counter from above and the top in portrait use, but several token-specific elements have also been added. Note that generally the image requires a horizontal and then a vertical reversal to respect the direction provided in the programming of Roll20.

Note that all of these instructions also apply to Rollable Table Tokens(aka. Multi-sided tokens).

See Also: Link Token to Character Sheet

[edit] Move, Rotate & Scale

See Manipulating Tokens.

Every token is accompanied by image handles on each of the corners of the token and in the middle of each side. You can use these image handles in order to change the size of the token. Additionally, each token has a rotation handle that juts out from the token itself. The rotation handle represents the "front" of the token and can be used to orient the token to face any desired direction.

If you are using a grid for your play area, typically when resizing a token, it will snap to the grid. However, by holding the Alt key while using the image handles to resize you can temporarily disable this functionality. This can be very useful when aligning tokens that do not have identical dimensions.


Tokens can also be moved using Waypoints

[edit] Token Features

[edit] Radial Menu Bubbles (1)

The token features showed when a token is selected.

These three input bubbles can be used by the players or the GM as a counter to keep track of health, turns, money, fuel or whatever else proves useful for your game. Click on a bubble to change the value. You can enter a new value (e.g. "20" or "ABC"), and for numerical values you can also enter relative values (e.g. "+5" will add 5 to the current value, or "-10" will subtract 10.) You can change the colored rims of the bubbles by going to "Token Bar Colors + Display Settings" section on the My Settings tab on the Sidebar and selecting different palette colors.

[edit] Bar Overlay (2)

If set to be visible, these are passive bars that fill or empty depending on what's entered in its corresponding colored Value Bubble.

[edit] Nameplate (3)

If set to be visible, this will display the name of the Token.

[edit] Edit (4)

Full section: Token Settings

Clicking on the 'Edit/Settings button brings up a new window where you can name the Token, set permissions on who can control the Token, set what bars/auras are visible to/editable by the players and keep storage of GM notes. Note: This button is only visible to the GM You can also double-click on the token to open the same settings dialog.

[edit] Token Markers (5)

Main Article: Token Markers

OverlayIcons.jpg
This button rolls out a menu that gives you a series of colored dots, a red X and over 40 different markers that overlay over the Token image. You can use these to show status, ailments, or to differentiate multiples of the same Token type. You can have multiple Token Markers displaying simultaneously.

You can also add a numeral to individual Token Markers by mousing over the desired Token Marker in the rollout menu and tapping "0" through to "9" on the keyboard or numpad. A red numeral will appear on the Token Marker. Tapping "0" will clear the numeral from the Token Marker (but the Token Marker remains until it is clicked again in the menu).

The default position for the Token Markers is across the top of the token, but you can choose to have them run along the bottom, right or left side by going to the "Token Bar Colors + Display Settings" section on the y My Settings tab on the Sidebar and selecting the layout from the "Marker Position:" drop-down menu.

You can also add Custom Token Markers, which will appear in this menu as well.

[edit] Animation Pause (6)

On animated tokens, click the pause/play button to start or stop the animation. Note that animations will not start on the VTT if the "Enable Animated Graphics" checkbox is disabled in the y My Settings tab.

[edit] Token Actions

Main Article: Token Actions

Token Actions are specially-designated macros and character abilities which appear whenever a token is selected on the screen. They appear in a bar along the top of your screen, and the contents of the bar are context-sensitive.

[edit] Token Settings

Token settings are split into Details, GM Notes, and Dynamic Lighting tabs. You can seamlessly switch between tabs while editing your token information. All changes update in real-time.

[edit] Details

Details tab of token, viewed by a GM (Dec 2021)

See Token Settings - Details for full details

[edit] General

Check the box for "Nameplate" for the name to display on the map.

[edit] Player Permissions

Each of the -buttons adjust the player permissions for the section.

  • See The player(s)
  • Edit The player(s) controlling the token can edit the content.
player permissions for the nameplate

[edit] Tooltip

See: Token Tooltip

[edit] Bars

This is where you can set whether any of the three bar elements are either visible and/or editable to the players. You can also adjust if the exact values are seen by none, only the controlling player, or everyone.

The green heart, blue bolt and red cardiograph icons for the bars are there for identifying purposes only. They do not have to represent anything in particular in your game.

You can also input numerical values for the Bar Bubbles directly from the Edit Token window. There are two input fields available for each Bar. The first field is for the Bar's current value and is what's featured in the Token's corresponding Bar Value Bubble. The second field is for the Bar's total value. If it's supplied, Roll20 will use the comparison between the two numbers to render how full or empty that corresponding Bar appears on the Tabletop. The fill will reflect whatever the Player plugs into their Bar Value Bubble while in-game.

If the Token Represents a Character , you can choose to link each bar to a specific Attribute of the Character. If you change the value of the linked attribute anywhere(from the token bubble, the token settings, the character sheet, or using an API) the value will update automatically update both on the token & the character.

[edit] Auras

An Aura is a translucently filled circle or square that radiates from the center of a Token. You can have up to two Auras active at once on any given Token. To turn one on, make sure it's toggled on to See first and then enter a radius value for the Aura. Next to the Aura's radius input field is a palette button where you can choose the color for the Aura. You can set the Aura to a square instead of a circle by checking off the "Square" checkbox next to the color palette button.

Note: To completely remove an Aura from view, do not change the radius value to zero. Clear the field instead. At zero, the Aura still draws to encircle the outer edge of the Token.

[edit] Token Lock

Main Page: Token Lock

GMs can lock tokens in place & stop player & the GM from moving them.

[edit] GM Notes

This is a field where a GM can keep private notes on any given Token.

[edit] Dynamic Lighting

Only the GM can see/edit these token settings.

DL tab of token (Dec 2021)

[edit] Advanced & legacy Settings

Legacy DL Token Settings
Emits Light

Here you can set how far light emits from the Token and if All Players can see the light emitted when Legacy Dynamic Lighting is enabled. This option allows you to enter a light radius amount and gives you a checkbox for All Players See Light. When the checkbox is left unchecked, the only player(s) who can see that token’s light emission are those who have assigned permission to that token. In addition to emitting light, you can now customize the “angle” of lights and the line of sight of tokens. So you can specify, for example, that a player should only have a 140-degree field of view instead of 360-degrees. The Multiplier feature allows you to adjust how effectively a token sees light. At a value of 1 the token sees light normally but at a value of 2 the token sees twice as far with the same light source.

Has Sight

Tokens that have sight and are assigned to a player or GM will always be displayed to the player that controls the token, even if Fog of War or Advanced Fog of War would normally obscure them.

These tokens will also appear in front of other tokens on the tabletop to the controlling player.

Advanced Fog of War

The Advanced Fog of War Reveal Distance sets how far your token will have Advanced Fog of War revealed to it. If the token does not have a light source, the greyed-out map will be revealed. If it does have a light source, it will see the lit-up map that is illuminated. Note that a token must have sight in order to see anything or have Advanced Fog of War revealed.

For performance reasons, tokens that are not owned by anyone do not reveal Advanced Fog of War. GMs can change this option in the Advanced Fog of War for an individual page.

[edit] Tips

  • Setup Default Tokens for characters.
    • This way when your change maps, you & your players can simply drag-n-drop the characters or NPCs to the map and they have a ready-to-play token.
    • For Player Characters and named/unique NPCs, having token bar values linked to a character attribute is a good idea, so token & sheet stay synced
    • For generic characters, don't link the character attributes to the token. This way you can drag-n-drop several of them to them map, and each token will track their stats individually, while still able to reference the shared stats of the NPC template.
  • Multi-Sided Token is a great feature with may uses for both players characters, NPCs, and even map objects
    • quickly changed the visuals of a player who have Wildshaped/cast illusions on themselves
    • A basic NPC template like goblins could have variations on how individual looks, while still linking back to same statblock
    • a moving labyrinth, or frequently changing location; could be sped up by having map-segments be switch-able through a multi-sided token
  • Pro users can install TokenMod, making it possible to update & edit tokens with chat commands, along with making it possible for players to adjust their character's vision & light settings themselves, such as with these convenient menus.

[edit] API

There are plenty of API options for tokens. TokenMod stands out as making it possible to update & edit tokens with chat commands, along with making it possible for players to adjust DL settings themselves.

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.
  • Reporter(Forum) -- A script to poll the game and return info on Token/Character pairs, along with customized action tools.
  • SelectManager - can patch and extend token selection between APIs
  • Supernotes(Forum) -- script pulls the contents from a token's GM Notes field.
  • GitHubLogo.png -- easy way to manage multi-sided tokens which are being used to represent progress clocks, or any other kind of incrementing timer or countdown.
  • Random Token Tinter -- will randomly assign (or remove) tints on tokens based on either a command-line list, a predefined Rollable Table, or a default rainbow (ROYGBV). See !!randtint --help for more.
  • TokenController(Forum) - Automate Token Movement for Patrols, following, roaming, and more
  • WeaponArcs(Forum) -- provides a means to add weapon arcs to tokens for visualization of range and targetable tokens
  • Faces(Forum) -- This is a short script that is designed to provide a quick visual interface for swapping token images and names. Great for any changeling. by Keith

[edit] Movement, Rotation, and Size

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

  • Bump(Forum) - 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.
  • Carry Tokens(Forum) -- 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.
  • Spawn Default Token(Forum) -- general idea is to automatically spawn the default token for a given "character" with various options for token qty, location/arrangement, and certain token properties such as size, side(for multi-sided tokens), light emission etc.
  • 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.
  • TokenController -- Allows GMs to quickly create patrol path shapes, assign tokens one or more paths, lock tokens in place, set tokens to follow each-other, and more. Uses complete menu system, no chat commands required.

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


[edit] See Also