Feature: Character Token Editor

From 5etools Community Wiki
Jump to: navigation, search

PLEASE NOTE: Roll20 Enhancement Suite (aka VTT es/ R20es), is not part of BetteR20 or 5eTools. However; as BetteR20 installation is enhanced/simplified by already having VTT es/R20es installed, this Wiki covers its content to (HOPEFULLY) prevent BetteR20 users from requesting help on BetteR20 issues on the VTTes/R20es Discord server or other platforms (Reddit/Roll20.net Forum, etc).


R20esLOGO.png
VTTes/R20es v1.15.26

R20CharacterTokenEditor.png

Character Token Editor

EitherDMnPC.png
Adds an additional tab to character sheets that provides a way to create and modify character tokens from the character sheet.


Instructions(What it does)

Click Expand for Specific Feature
Token editorLabeled.png

1️⃣ Token Image
This is where the image that represents the token is shown.
Below the image you can
  • set the Width and Height (in pixles (px))
  • The ability Rotate the Token's image
  • Flip Horizontal
  • Flip Vertical


When you mouse of the image the follow options will occur.
R20CharacterTokenEditorTOKENS.png
Remove Image - Clicking upon this will remove the image f
Set from URL - Paste the URL
Drag an image on me! - Click and drag an image from a website, or local drive to set the


2️⃣ Nameplate
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.
Name - Set the Name of the Token (this can be different than the Character Sheet's name)
Show Nameplate? - Sets if the Nameplate if viewable
Tint Color - Sets the tint color of the Background for the nameplate.


3️⃣ 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.


4️⃣ Vision and Light
Light Emitter
a feature normally exclusive to Plus and Pro subscribers, and their players. BetteR20 however grants Dynamic Lighting to the GM and they players that use them.
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


Is emitting light


Light Observer


Can See?
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
This section is about a feature normally exclusive to Pro subscribers, or to players in a Game created by a subscriber. With BetteR20, if the players and GM use it, Dynamic Lighting If you'd like to use this feature, consider upgrading your account.
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.


5️⃣ Permissions
There are 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.


6️⃣ 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.
Auras1 - Size (in feet); Color; and shape (either Square or circle).
Auras2 - Size (in feet); Color; and shape (either Square or circle.


7️⃣ Permissions
There are 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 assigned by the GM) 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.
Bar Location

TokenBarLocation.png
The token bar placement is configurable on a token-by-token basis. In the Bar Position, you can select Above, Top Overlapping, Bottom Overlapping, and Below for the token bar position.
You can change the location of the status icons for your game if they're in the way of the token bars in the My Settings tab.


Bar Style

TokenBarsCompact.png
Token bars have two options: standard and compact.
The Standard option displays the bars stacked on top of each other, with the text overlay, if any, and the +/- overflow icons.
The Compact option displays the bars stacked on top of each other, but very narrow, with no overlay or overflow icons. When this option is selected, the text overlay will always be set to "Hidden" and cannot be changed.


Feature Support


R20es Configuration
In Roll20, click the sidetoolbar's R20Settings.PNG, and if VTTes/R20es is loaded properly (see Installation Guide) you will see the buttons for R20es Tools and R20es Settings.
  • Click upon R20es Settings and then select the feature's name.
  • The right hand pane will then show the following...
noframes


Known Issues/Limitations

Players can define sight

Players are able to modify their token's light/vision settings, giving themselves darkvision or better vision than they should have potentially.
Work Around:
This is as designed. If your players modify their visual settings/light-emitting, their field of vision will change on the map. Monitor such and make sure they are not cheating and address such directly.



FAQ

Nothing's here (Do you have any suggestions?)
Best Practices

None as yet (Do you have any suggestions?)



Related Features



Did that answer your question(s)?

If not please check the under Support; Troubleshooting or the Known Issues page for further guidance, or go to the Discord community and leave a comment in the issues channel.

If you enjoy the project, please follow this link to see how you can contribute and help make it even better.



PLEASE NOTE: Roll20 Enhancement Suite (aka VTT es/ R20es), is not part of BetteR20 or 5eTools. However; as BetteR20 installation is enhanced/simplified by already having VTT es/R20es installed, this Wiki covers its content to (HOPEFULLY) prevent BetteR20 users from requesting help on BetteR20 issues on the VTTes/R20es Discord server or other platforms (Reddit/Roll20.net Forum, etc).