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
m (2. Bar Overla:: typo)
m (Moved number to the end of the subheadings, slight reordering of titles and images)
Line 7: Line 7:
 
[[File:TokenSS1.jpg|right]]
 
[[File:TokenSS1.jpg|right]]
  
===1. Radial Menu Bubbles===  
+
===Radial Menu Bubbles (1)===  
 
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.
 
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.
  
===2. Bar Overlay:===
+
===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.
 
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===
+
===Nameplate (3)===
 
If set to be visible, this will display the name of the Token.
 
If set to be visible, this will display the name of the Token.
  
===4. Edit===
+
===Edit (4)===
 
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.
 
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.
  
===5. Status Indicator Overlays===
+
===Status Indicator Overlays (5)===
 
[[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.
 
[[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.
  
Line 26: Line 26:
 
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.
 
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===
+
===Token Actions===
 
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.  
 
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.  
  
Line 37: Line 37:
 
[[File:TokenSS2.png|right]]
 
[[File:TokenSS2.png|right]]
  
===1. Basic and Advanced Settings===
+
===Basic and Advanced Settings (1)===
 
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.   
 
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===
+
===Represents Character (2)===
 
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''']].
 
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''']].
  
Line 48: Line 48:
  
  
===3. Name===
+
===Name (3)===
 
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.
 
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===
+
===Controlled By (4)===
 
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 "Controlled By" field will bring up a list of all the players in the current campaign as well as being able to select the option "All Players". 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.
 
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 "Controlled By" field will bring up a list of all the players in the current campaign as well as being able to select the option "All Players". 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.
  
 
''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 "All Players" and later fine-tune the permissions when your players have visited your Campaign.''
 
''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 "All Players" and later fine-tune the permissions when your players have visited your Campaign.''
  
===5. Tint Color===
+
===Tint Color (5)===
 
Here you can add a color filter to the Token.  The default tint color is transparent.
 
Here you can add a color filter to the Token.  The default tint color is transparent.
  
===6. Bars and Auras===
+
===Bars and Auras (6)===
 
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.
 
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.
  
Line 70: Line 70:
 
''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===
+
===GM Notes (7)===
 
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]]
+
==In the Advanced Tab==
 +
[[File:TokenSS3.png]]
  
In the Advanced Tab:
+
===Player Permissions (8)===
 
+
===8. Player Permissions===
+
 
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.
 
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.
  
Line 87: Line 86:
 
{{supporters only|section=true}}
 
{{supporters only|section=true}}
  
===9. Emits Light===
+
===Emits Light (9)===
 
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.  
 
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.  
  

Revision as of 15:22, 26 June 2015

Contents

Creating a New Token

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 Rollable Table Tokens.

Here is an example of a Token:

Token Interface.jpg

Radial Menu Bubbles (1)

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.

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.

Nameplate (3)

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

Edit (4)

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.

Status Indicator Overlays (5)

OverlayIcons.jpg
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 "0" through to "9" on the keyboard or numpad. A red numeral will appear on the Overlay. Tapping "0" will clear the numeral from the Overlay (but the Overlay remains until it is clicked again in the menu).

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.

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. Check out the Token Actions page for more info.

Token Settings

Clicking the Edit button or double clicking on a Token brings up the Edit Token window:

Token Settings Dialog.png

Basic and Advanced Settings (1)

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.

Represents Character (2)

Here you can select whether the Token represents a 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.

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 & Abilities tab.


Name (3)

Here you can set the name of the Token. If you choose to use the Turn Tracker in your game, the Token's name will appear next to its thumbnail picture in the turn list.

Controlled By (4)

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 "Controlled By" field will bring up a list of all the players in the current campaign as well as being able to select the option "All Players". 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. GM always has control over the Tokens in their Campaign.

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 "All Players" and later fine-tune the permissions when your players have visited your Campaign.

Tint Color (5)

Here you can add a color filter to the Token. The default tint color is transparent.

Bars and Auras (6)

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.

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.

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.

GM Notes (7)

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

In the Advanced Tab

Advanced Token Setting Dialog.png

Player Permissions (8)

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.

Setting the Edit flag will allow all players who can control the Token (based on the "Controlled By" field, above) to see and edit the values of the bar, or change the radius of the aura drawn on the tabletop.

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. Template:Supporters only

Emits Light (9)

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.


See Also: Linking Tokens to Journals