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 "Linking Tokens to Journals"

From Roll20 Wiki

Jump to: navigation, search
m (Linking)
(28 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<div style="background:#f0e2a1; border: 3px solid #dbc870; padding: 10px;">
+
{{revdate}}{{HCbox| {{hc|articles/360039715593-Linking-Tokens-to-Journals Here}} }}
<big>'''''Attention:'''''
+
 
''Roll20 is no longer maintaining this document on the community wiki. For the most up-to-date information please visit this page on our help center for assistance: [https://roll20.zendesk.com/hc/en-us/articles/360039715593-Linking-Tokens-to-Journals Here].''</big>
+
When a [[GM]] create a new character in Roll20, the [[Character Sheets]] are not automatically linked to any [[Token]], and the process isn't the most intuitive doing it the first time.
</div>
+
{{#evp:youtube|c-JmxkjLnDU|Connecting Tokens to Character Sheets, 6min(Sep 2021)|right|630}}
==General==
+
This is a guide on how to set up so your '''character sheet with a [[Journal#Default_Token|Default Token]]''' which persists, so you can later [[drag-n-drop]] the character/token from the {{Journal}} to whichever map/page you're looking at any time.
When you create a new character in Roll20, the [[Character Sheets]] are not automatically linked to any [[Token]], and this is a guide on how to do this.
+
 
 +
 
 
__TOC__
 
__TOC__
===Tips===
+
{{clear}}
Some people are  having trouble dragging the [[Token Features|token]] (once set up) to the map from the {{Journal}}. Make sure you are dragging it appropriately. If you select only the icon (or three horizontal bars) to the left of the name and drag that to the map, it ''will not'' place the token on the map.  You must select the name itself and drag it to the map. Then, the token will be placed on the map with everything set properly as described below.
+
==Character vs. Generic NPC==
 +
First, decide if your token represents '''A)''' a (unique) '''Character''' or '''B)''' a '''Generic NPC'''.
 +
 
 +
'''A) (individual) Character:''' A unique character or being. This token represents one, and only one, {{Journal}} Entry, and this Journal Entry represents one, and only one, token. Player Characters are Characters. Most NPCs with individual names as well. Some 'monsters' can be Characters as well; if there's only one instance of this being, ever, it's a Character. With a "Character" you'd likely want to link their health between the token and the character sheet, so that if you update on either, the change happens on the other as well.
 +
 
 +
'''B) Generic NPC:''' is not a unique being; this token represents one of many similar or identical creatures. Goblins, Kobold, common bandits are examples of generic NPCs. The "Goblin King"'s token is likely better saved as Character than a generic NPC, as there is only one Goblin King. With a "Generic NPC" you'd likely want to be able to drag-n-drop multiple ones to the map, and let them have '''individual health pools''', without having to create separate character sheets for each.
 +
 
 +
If your token is neither an "(individual) Character" nor a "Generic NPC", there might not be any reason to link it to a Character Sheet!
 +
 
 +
In some cases it can still be useful to create an "Item Character Sheet", for saving an '''item token''' that is commonly drag-n-dropped to games and require pre-saved settings, such as a Torch. If you have [[Dynamic Lighting]] in your game, creating a "Torch"-token that emits bright light for 30ft & dim light for 30 ft, and saving it to a character as default token, means it's easy& quick for GM and/or players to place them on the map when needed.
  
 
==Linking==
 
==Linking==
 +
{{cleanup-msg|The {{forum|/post/9487966/updated-page-and-token-settings-bugs-and-feedback-thread Token Menu}} have been updated since writing this section, so  the new layout haven't been accounted for in the guide's text or visuals yet.|November 2020}}
  
First, decide if your token represents a '''Character''' or a '''Generic NPC'''.
+
'''Warning:''' If using a [[BCS|custom character sheet]], input fields that are disabled, readonly or [[Auto-Calc|autocalculated]] will not work when trying to in to token bars. Using a hidden input field, updated with a sheet worker is the proper way.
  
A '''Character''' is a unique being. This token represents one, and only one, Journal Entry, and this Journal Entry represents one, and only one, token. Player characters are Characters. So are most NPCs (those with names). Some 'monsters' can be Characters as well; if there's only one instance of this being, ever, it's a Character.
+
The following thing need to be done in the right order to work properly:
  
A '''Generic NPC''' (or Mook)  is not a unique being; this token represents one of many similar or identical creatures. A horde of goblins is made up of generic NPCs, for example. A leader goblin may or may not be a character, depending on the situation. The Goblin King is a Character, not a generic NPC, as there is only one Goblin King. Some NPCs may be mooks: generic townspeople, for example, are mooks until and unless they are given a specific personality, name, or other reason to identify them differently than others; in this rare case, create them anew as Character tokens.
+
'''1.''' Set up a Character in your {{Journal}} with at least the name & stats you might want to be seen on the token.
[[File:Linking-token-1.png|thumb|right|400px|Step 2-4]]
+
If your token is neither a Character nor a Generic NPC, do none of these; it's just an item!
+
  
===Steps===
+
'''2.''' From your {{Art Library}}, upload or select a token to represent the creature ​and drag it to the map.[[File:Token-linking-step-3.gif|right|thumb|450px|Steps 3.]]
Now the tricky part; this needs to be done exactly in this order to work properly:
+
<br>
 +
'''3.''' On the tabletop: In the token's tools, select the '''Represents Character'''-dropdown and pick the character, and then save. Now the token is linked to the character, but we're not ready yet.
  
'''1.''' Set up {{Journal}} entry with HP and other vital stats (Such as Hit Points, Armor Class, Movement, etc.)
+
'''4. A)''' In the Token Tools: For a '''Character''', go to the Bar 1,2,3 and use the dropdowns to select what stats to link to each bar, if you want any (Bar 1 usually represents Hit Points. 2 and 3 often indicate Armor Class and other resources. For D&D 5E, <code>hp</code> is the stat for your current/max hit points)
  
'''2.''' On that tabletop: Create token to represent creature ​(Find one that looks like what you want, and place it on the board.)
+
'''4. B)''' In the Token Tools: For a '''Generic NPC''', you can either manually set the stats for the Bar 1,2,3; or you can perform the step '''4.A)''', and then unlink the bars you don't want to be shared between "Generic NPCs" "dropdown from stats. (numbers will stay but will no longer be linked. In marketplace compendiums, NPC HP are usually unlinked, but the AC is linked).
  
'''3.''' On the tabletop: In the token's tools, link token to journal entry (Represents Character dropdown menu)
+
'''5.''' The [[Token_Features#Advanced_Tab|Advanced]] and [[Token_Features#Updated_Dynamic_Lighting|Dynamic Lighting]]-tabs on the Token contains more settings you might want to change before finishing. On the Advanced-tab you can set which Bars are displayed, who can see them, and if the numbers are also visible. On the [[Token_Features#Basic_tab|Basic]]-tab also have other settings like showing the nameplate or having an aura for a token.
 +
<br>
 +
[[File:Token-linking-step-6-8.gif|right|thumb|450px|Steps 6 - 8.]]
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
'''6.''' Open the Character Sheet, and open it's '''Edit'''-section
  
'''4.''' In the Token Tools: Link token's bars to journal's Attributes (Bar 1,2,3 dropdown menu) (By general consensus, Bar 1 usually represents Hit Points. 2 and 3 often indicate Armor Class and Movement.)
+
'''7.''' Select the Token on map
  
'''5.''' If "Generic NPC", UNLINK token's Bar 1,2,3 dropdown from stats by selecting None/GenericToken in Represents Character bar (numbers will stay but will no longer be linked)
+
'''8.''' On the Character Sheet, go to the '''Default Token''' section, and press '''Use Selected Token'''. Then press '''Save Changes'''.
 +
<br>
 +
<br>
 +
​<br>
 +
<br>
 +
 +
Now token is now linked to the character sheet, have a few linked stats, and can be drag-n-dropped from the Journal to the map quickly.
  
'''6.''' Make 100% sure token is set up the way you want it (Character bars are linked; Generic NPC bars are NOT linked)
+
Test by dragging multiple copies from the {{Journal}} onto the map. Change Hit Points on one copy; if the others change, it's done right! (Unless it's a Generic NPC... if the others do not change, it's done right!)
[[File:Linking-token-2.png|thumb|right|400px|Step 7-9]]
+
  
'''7.''' Open {{Journal}} entry for that Token
+
'''Character''' tokens will always carry over changes to new maps. '''Generic NPC''' tokens will never carry over changes; each new token is separate.
  
'''8.''' Select Token on map (token must be highlighted)
+
Remember that when you set the token, it is saved EXACTLY as it is. So, be sure to have all the properties exactly the way you want them before you invoke the last step.
  
'''9.''' In Journal Entry, change the default token to the one highlighted on the map (this is in the Edit submenu of the journal entry)
+
'''Open character sheet from token:''' By selecting the token an doing '''Alt + Double-Click''', you can open a linked character sheet from a token.
  
'''10.''' Save your work
+
===Editing Linked Tokens===
+
 
​Test by dragging multiple copies from the {{Journal}} onto the map. Change Hit Points on one copy; if the others change, it's done right! (Unless it's a Generic NPC... if the others do not change, it's done right!)
+
If you want to edit settings in a linked token and want to save those things for the Default Token as well, you need to:
 +
 
 +
* first edit a existing token as you want it to be
 +
* then open the character sheet and remove the current '''Default Token'''
 +
* finally repeating '''Steps 6-8''' from the previous section.
 +
 
 +
===D&D 5E===
 +
If you play with the [[D&D 5E by Roll20]] Character sheet, common stats you might want to link to the Bars/circles:
 +
 
 +
* <code>hp</code>, your current & max Hit Points. NPCs from the compendium or Modules shows HP in Bar 1, but the stat is un-linked.
 +
* <code>hp_temp</code>, your temporary Hit Points. If regularly used, you can set up a default max value on the token
 +
* <code>ac</code>, a Player Character's Armor Class
 +
* <code>ac_npc</code>, a NPC's Armor Class. NPCs from the compendium or Modules usually have it linked to Bar 2.
 +
* <code>class_resource</code>/<code>other_resource</code>, the two first [[D%26D_5E_by_Roll20#.2813.29_Class_.26_Other_Resources|resource slots]] on a character, can be used to track Spell Points, Sorcery Points, Ki points.
 +
 
 +
==API==
 +
{{pro only|section}}
 +
Using [[TokenMod]], it's much quicker to update the default token of a character.
  
​PC tokens will always carry over changes to new maps. ​Mook tokens will never carry over changes; each new token is unique.
+
# Make the setting changes to the token you want
 +
# make sure the token is already set to represent the character
 +
# Selected token, and do this command:
 +
<pre>!token-mod --set defaulttoken</pre>
  
'''Remember that when you set the token, it is saved EXACTLY as it is. So, be sure to have all the properties exactly the way you want them before you invoke step #9!'''
+
If the token isn't set to represent a character, you can do this command:
 +
<pre style="overflow:auto;white-space:pre-wrap;">
 +
!token-mod --set represents|@{Bob|character_id} defaulttoken
 +
</pre>
  
A real time saver now is that you can '''alt and double click''' on the token to '''open character sheet''' that is linked through the token.
+
Replace <code>Bob</code> with the name of the character(in the {{Journal}}-tab) you want to update the default token for.
  
==Youtube Tutorial==
+
==Drag-n-Drop==
{{#evp:youtube|84OcOCixuXM|Learning Roll20 - Linking & Registering your PC Tokens (15min) by CrashGem (March 2020)|center|500}}
+
[[File:Drag-n-drop-token.gif|thumb|right|500px]]
 +
To drag-n-drop a character/token from the {{Journal}}, you need to select its name, not the character icon/three bar. If you select the icon (or three horizontal bars) to the left of the name, it will move the character's position in the Journal.
  
 
= See Also =
 
= See Also =
* [https://www.youtube.com/watch?v=UTq3_e6MiRI&t=216s Roll20 - Linking Tokens] (15min) by Keith Curtis (2018)
+
* {{yt|watch?v=UTq3_e6MiRI&t=216s | Roll20 - Linking Tokens}} (15min) by Keith Curtis (2018)
 
* {{Journal}}
 
* {{Journal}}
 
* [[Token Features]]
 
* [[Token Features]]
 
** [[Token Actions]]
 
** [[Token Actions]]
 
* [[Adding Character Sheet]] - How to add [[Character Sheets]] to your game/players
 
* [[Adding Character Sheet]] - How to add [[Character Sheets]] to your game/players
 +
* [[Token Z-Ordering]] — ''How tokens layer on the VTT''
 +
* [[Rollable_tables#Rollable_Table_Token | Multi-Sided Tokens]] creating a token with multiple sides, using a [[Roll Table]]
 +
* [[Gamemaster]]
 +
* [[Player]]
 
<br>
 
<br>
 
<br>
 
<br>
Line 65: Line 116:
 
[[Category:Guides]]
 
[[Category:Guides]]
 
[[Category:Tips]]
 
[[Category:Tips]]
 +
[[Category:Tokens]]
 +
[[Category:Character Sheets]]

Revision as of 13:42, 22 December 2021

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

When a GM create a new character in Roll20, the Character Sheets are not automatically linked to any Token, and the process isn't the most intuitive doing it the first time.

Connecting Tokens to Character Sheets, 6min(Sep 2021)

This is a guide on how to set up so your character sheet with a Default Token which persists, so you can later drag-n-drop the character/token from the N Journal to whichever map/page you're looking at any time.


Contents

Character vs. Generic NPC

First, decide if your token represents A) a (unique) Character or B) a Generic NPC.

A) (individual) Character: A unique character or being. This token represents one, and only one, N Journal Entry, and this Journal Entry represents one, and only one, token. Player Characters are Characters. Most NPCs with individual names as well. Some 'monsters' can be Characters as well; if there's only one instance of this being, ever, it's a Character. With a "Character" you'd likely want to link their health between the token and the character sheet, so that if you update on either, the change happens on the other as well.

B) Generic NPC: is not a unique being; this token represents one of many similar or identical creatures. Goblins, Kobold, common bandits are examples of generic NPCs. The "Goblin King"'s token is likely better saved as Character than a generic NPC, as there is only one Goblin King. With a "Generic NPC" you'd likely want to be able to drag-n-drop multiple ones to the map, and let them have individual health pools, without having to create separate character sheets for each.

If your token is neither an "(individual) Character" nor a "Generic NPC", there might not be any reason to link it to a Character Sheet!

In some cases it can still be useful to create an "Item Character Sheet", for saving an item token that is commonly drag-n-dropped to games and require pre-saved settings, such as a Torch. If you have Dynamic Lighting in your game, creating a "Torch"-token that emits bright light for 30ft & dim light for 30 ft, and saving it to a character as default token, means it's easy& quick for GM and/or players to place them on the map when needed.

Linking


Warning: If using a custom character sheet, input fields that are disabled, readonly or autocalculated will not work when trying to in to token bars. Using a hidden input field, updated with a sheet worker is the proper way.

The following thing need to be done in the right order to work properly:

1. Set up a Character in your N Journal with at least the name & stats you might want to be seen on the token.

2. From your P Art Library, upload or select a token to represent the creature ​and drag it to the map.
Steps 3.


3. On the tabletop: In the token's tools, select the Represents Character-dropdown and pick the character, and then save. Now the token is linked to the character, but we're not ready yet.

4. A) In the Token Tools: For a Character, go to the Bar 1,2,3 and use the dropdowns to select what stats to link to each bar, if you want any (Bar 1 usually represents Hit Points. 2 and 3 often indicate Armor Class and other resources. For D&D 5E, hp is the stat for your current/max hit points)

4. B) In the Token Tools: For a Generic NPC, you can either manually set the stats for the Bar 1,2,3; or you can perform the step 4.A), and then unlink the bars you don't want to be shared between "Generic NPCs" "dropdown from stats. (numbers will stay but will no longer be linked. In marketplace compendiums, NPC HP are usually unlinked, but the AC is linked).

5. The Advanced and Dynamic Lighting-tabs on the Token contains more settings you might want to change before finishing. On the Advanced-tab you can set which Bars are displayed, who can see them, and if the numbers are also visible. On the Basic-tab also have other settings like showing the nameplate or having an aura for a token.

Steps 6 - 8.






6. Open the Character Sheet, and open it's Edit-section

7. Select the Token on map

8. On the Character Sheet, go to the Default Token section, and press Use Selected Token. Then press Save Changes.



​ Now token is now linked to the character sheet, have a few linked stats, and can be drag-n-dropped from the Journal to the map quickly.

Test by dragging multiple copies from the N Journal onto the map. Change Hit Points on one copy; if the others change, it's done right! (Unless it's a Generic NPC... if the others do not change, it's done right!)

Character tokens will always carry over changes to new maps. ​Generic NPC tokens will never carry over changes; each new token is separate.

Remember that when you set the token, it is saved EXACTLY as it is. So, be sure to have all the properties exactly the way you want them before you invoke the last step.

Open character sheet from token: By selecting the token an doing Alt + Double-Click, you can open a linked character sheet from a token.

Editing Linked Tokens

If you want to edit settings in a linked token and want to save those things for the Default Token as well, you need to:

  • first edit a existing token as you want it to be
  • then open the character sheet and remove the current Default Token
  • finally repeating Steps 6-8 from the previous section.

D&D 5E

If you play with the D&D 5E by Roll20 Character sheet, common stats you might want to link to the Bars/circles:

  • hp, your current & max Hit Points. NPCs from the compendium or Modules shows HP in Bar 1, but the stat is un-linked.
  • hp_temp, your temporary Hit Points. If regularly used, you can set up a default max value on the token
  • ac, a Player Character's Armor Class
  • ac_npc, a NPC's Armor Class. NPCs from the compendium or Modules usually have it linked to Bar 2.
  • class_resource/other_resource, the two first resource slots on a character, can be used to track Spell Points, Sorcery Points, Ki points.

API

Using TokenMod, it's much quicker to update the default token of a character.

  1. Make the setting changes to the token you want
  2. make sure the token is already set to represent the character
  3. Selected token, and do this command:
!token-mod --set defaulttoken

If the token isn't set to represent a character, you can do this command:

!token-mod --set represents|@{Bob|character_id} defaulttoken 

Replace Bob with the name of the character(in the N Journal-tab) you want to update the default token for.

Drag-n-Drop

Drag-n-drop-token.gif

To drag-n-drop a character/token from the N Journal, you need to select its name, not the character icon/three bar. If you select the icon (or three horizontal bars) to the left of the name, it will move the character's position in the Journal.

See Also