Tokens

An important concept to understand when working with Tokens is the difference between a Prototype Token and a Placed Token.

Prototype Tokens

Prototype Tokens allow you to configure a 'preset' for that Actor's tokens which will be used whenever a new token is placed.

A Prototype Token stores the configuration of a Token for a particular Actor before that Token has been placed onto the game canvas. The prototype defines the default setup that a newly created Token starts with. To configure the Prototype Token for an Actor, open the Actor Sheet and click the Prototype Token button in the top bar.

Placed Tokens

Once a Token is placed, it becomes its own independent copy of the prototype. For example - a Prototype Token for a player character could be configured to have a certain vision distance - but when that Token is placed into a Scene that has different lighting conditions, the placed copy of the Token could be changed to increase or decrease visibility for that scene. To configure a placed Token, right click on the Token to display the Token HUD and click the gear icon to open that Token's configuration sheet, or double right-click the token.

The Identity tab controls what actor data is associated with the token and what others can see of that identifying information. This includes the actor's name, image, and more.

Token Name

This determines the name which is shown for the token. When a new actor is created this defaults to whatever name that actor was given, but it can be changed to be different from the name.

Display Name

Configure the level of visibility for the token's nameplate.

• Never Displayed - The nameplate is not displayed at all.
• When Controlled - The nameplate is displayed when the Token is currently controlled
• Hovered by Owner - The nameplate is displayed when the token is hovered over by a User who owns the token's Actor
• Hovered by Anyone - The nameplate is displayed when the token is hovered over by any User
• Always for Owner - The nameplate is displayed at all times to any User who owns the token's Actor
• Always for Everyone - The nameplate is displayed at all times to every User

Represented Actor

Specify which Actor from the Actors Sidebar tab defines the data which should be used by the Token. The dropdown list of options is drawn from the available actors in the game world.

Link Actor Data

When enabled, changes to the resource pools either on the base Actor or on the Token itself will reflect in the other location. These changes apply to all linked tokens in all scenes, and is best used for unique or named characters. It's not recommended to link actor data for generic creatures or types of character (such as bandits). When data is not linked, each Token will have independent resources pools and turn order tracking.

Coordinates (Pixels)

(Placed Tokens Only) The current horizontal X position and vertical Y position of the Token in a Scene. Directly editing these fields on a token placed in a scene will change the token's position, these fields are automatically set when the token is placed into a scene or moved during play.

Elevation (Distance)

The Token's current elevation in grid units distance which is displayed visually above the Token. This is used to indicate whether certain Tokens are flying or burrowing at an altitude that differs from what is standard for the Scene. Editing this on a prototype token has no effect, as the token starts at 0 elevation when placed into a scene. An elevation below 0 will place the token below the background of the scene, useful for indicating that a token is burrowed.

Rotation (Degrees)

The Token's current direction of facing in degrees. Rotation of zero (the default) corresponds to a southward facing as this is the most commonly used convention for Token artwork. Editing this field on a prototype token determines the default rotation in degrees when it's placed into a scene. Tokens in a scene can also be rotated by holding down Shift and using the W-A-S-D keys, the arrow keys, or the mouse wheel. You can also hold down Control when using the mouse wheel to get smaller increments of rotation to more finely control a token's orientation.

Lock Rotation

If this setting is enabled the token cannot be rotated. This setting is ideal for portrait style tokens where the artwork orientation is fixed and not expected to change.

Token Disposition

Sets the color of the border shown around a Token when it's selected or hovered over with a mouse cursor. Disposition is used to differentiate enemies from allies during combat encounters. Neutral tokens have yellow borders, friendly tokens have teal borders, and hostile tokens have red borders.

The Appearance tab controls both the art a token uses to represent its actor, as well as how that art is displayed for users, such as dimensions, scale, and tint..

Image Path

The file path to the artwork that is used for the Token. This file must be in the $UserData/Data/ directory or a publicly accessible web location.

Randomize Wildcard Images (Prototype Tokens Only)

If checked, the provided Token Image Path is treated as a wildcard pattern that is matched against multiple existing files. When a wildcard Token is configured, each time that Token is placed an image is randomly chosen from the matching set. Note that this can only be configured on prototype tokens. Once a token is placed in a scene the image used is set, it must then be changed manually by editing the in-scene token. For a more detailed explanation of this feature, see the dedicated section later in this article. Please see below for more information on using image wildcards.

Alternate Actor Tokens (Placed Wildcard Tokens Only)

If Randomize Wildcard Images is checked on a prototype token, this dropdown list appears in the token config window for the placed actor. This list provides all available images which matched the wildcard you entered and allows you to quickly select a specific image you want to use for that actor.

Dimensions (Grid Units)

The number of grid units this token occupies. A token which uses a single grid square would have a width and height of 1.

Scale (Ratio)

A scaling ratio for the size of the Token's artwork. The token base size in grid units is unaffected by this value, but the visual size of the artwork is relative to that size and will change with scale. Numbers greater than 1 result in larger token artwork while numbers less than 1 result in smaller token artwork.

Mirror Image

This option provides two check boxes which determine if the token artwork is flipped horizontally or vertically, based on which boxes are checked.

Tint Color

This applies a hex color tint to the token's artwork as an overlay, and can either be entered directly or chosen using a color picker.

Token Opacity

This sets the opacity of the token's artwork. This can be used to make a token semi-transparent, or to make it completely invisible. This is useful for tokens which might be sneaking, but which you still wish the players to be able to see.

Display Bars

Configure the level of visibility for the token's resource bars. The following options are supported:

• Never Displayed - Resource bars will not be shown

• When Controlled - Resource bars are displayed when the Token is currently controlled.

• Hovered by Owner - Resource bars are displayed to any User that owns the token's Actor when they hover their cursor over the token.

• Hovered by Anyone - Resource bars are displayed to any User that overs their cursor over the token.

• Always for Owner - Resource bars are displayed at all times, and visible to the Actor's owner.

• Always for Everyone - Resource bars are displayed at all times, and visible to all Users.

Bar 1 Attribute

Select the attribute from the Actor's available data fields which should be displayed using the Token's primary resource bar.

Bar 1 Data

These fields are displayed for reference purposes only - you cannot configure the value of resource bars within the Token configuration as those are controlled by the Actor which the Token represents.

Bar 2 Attribute

Select the attribute from the Actor's available data fields which should be displayed using the Token's secondary resource bar.

Bar 2 Data

These fields are displayed for reference purposes only - you cannot configure the value of resource bars within the Token configuration as those are controlled by the Actor which the Token represents.

The Basic Configuration tab can be used to configure facets of how a Token views the canvas and its surroundings.

Vision EnabledThis toggle determines whether or not a Token has ability to see in scenes which have the Token Vision requirement enabled. When enabled, This Token renders a vision polygon when placed on the canvas and has limitations placed upon what it can see based on its Vision and Detection Modes. It is recommended to leave this unchecked for characters such as NPCS which are only used by the Gamemaster to more easily see the rest of the scene when a Token is selected.Vision RangeThis value is used to determine the distance a Token can see without the aid of any additional light. To use an analogy: the average human being would have this set to 0, as in a cave completely devoid of any light sources we would be unable to see anything.Vision AngleThis controls the angle of a token's vision, by default tokens see in 360 degrees, but in some games it may be necessary to reduce this angle for tactical reasons.Vision ModeIn some cases, users may wish to apply a visual effect to a token's vision polygon. This dropdown provides a list of system-agnostic visual effects to modify how the vision of a particular token may appear. For example, if you have a token representing an animal which can only see in black and white, but can see the same distance in darkness as not. You would configure a Vision Range and provide the token with the Vision Mode "Monochromatic". There are several default vision modes available:

• Basic Vision - The standard, default vision mode appearance which does not alter a token's vision.
• Darkvision - In areas where no light source exists, the token's vision is desaturated and does not display color. Areas which contain light sources show colors as expected.
• Monochromatic - Regardless of light source, this token will not be able to see colors.
• Tremorsense - A visual effect similar to a radar sweep, which pulses and visually obscures the scene's background but preserves details such as fog exploration and wall placement.
• Light Amplification - A visual effect similar to night-vision goggles. Light sources within range are amplified in their brightness, and areas within darkness are visibly raised. By default, this vision mode is colored green but its color can be changed via the Advanced Options subtab.

The detection modes tab controls what a Token should be able to detect in a Scene. Each Token can have have multiple Detection Modes like Basic Sight, Feel Tremor, See Invisibility and more. A Detection Mode can be added by pressing the + in the top-right of the tab.

Detection Mode

The Detection Mode that you want to configure. The Basic Sight detection mode defaults to match your token's configured vision range, and if not reconfigured will always show other tokens whenever they are illuminated in some way, whether that be from light sources or as a result of the configured token's vision range. Detection modes which "See" require line of sight and will not detect tokens through walls, while detection modes which "sense" ignore the presence of walls.

Range

The distance a Token should be able to Detect other tokens within the Scene.

Enabled

Whether this Detection Mode should currently be active and applied to the token's vision polygon.

There are a few different types of detection mode supported by default:

• Basic Sight - Used to override the default basic sight settings.
• See Invisibility - Depends upon line of sight and will not reveal tokens through walls. Allows a token to see other tokens that have been set with the "Invisible" condition.
• Sense Invisibility - Does not depend on line of sight and will reveal tokens through walls. Allows the token to see other tokens that have been set with the "Invisible" condition.
• Feel Tremor - allows the token to sense all other tokens at their elevation. Tokens which have an elevation greater than the scene's height are presumed to be floating or flying and will not appear on this token's vision.
• See All - Depends upon line of sight and will not reveal tokens through walls. Allows the token can see all other tokens regardless of available light.
• Sense All - Does not depend on line of sight and will reveal tokens through walls. Allows the token to see all other tokens regardless of available light.

The Advanced Options subtab provide a few options which allow you to tweak how a token's vision should appear for users of that token. Note that changing a Vision Mode will overwrite these settings with preset configurations for their values. For example: changing the Sight Mode to Darkvision will always overwrite the attenuation and saturation values to 0.

Vision Color

A color that should be applied as a tint to this token's vision.

Attenuation

How gradually the Vision Mode's visual effect should fade. A higher value fades the edges of the token's vision more drastically.

Vision Brightness

Controls the level of brightness a sight mode applies to a token's vision, good for situations where a token represents a character who might be used to living underground experiencing the daylight for the first time, or a character who has experienced some damage to their ability to see.

Saturation

How much color is present in a token's vision, lower values become monochrome, while higher values become more vivid and provide more vibrant colors.

Contrast

How sharply colors contrast against one another. Low contrast values add a somewhat foggy appearance to all colors and their blending, while higher values make colors stand out more sharply compared to one another.

The Token Action Hud provides quick access to the following options:

Resource Bars

If configured via the resource table, these bars provide a visual representation of resource attributes. The system will govern what resources can be tracked and modified.

Resource Bar Inputs

Are used to change the value of the displayed resource bars. Clicking on the input and then adding a positive or negative number allows you to quickly increase or decrease the number presented.

Status Effects

This allows you to assign status effects to the token, which appear as small icons overlaid on the token art in the upper left corner. The specific art of the status effects are defined by whichever Game System is currently in use. Right clicking an icon creates a large overlay that covers the majority of the token. Tokens can only have one large overlay at a time.

Elevation

This provides a simple height indicator label that will appear above a token to indicate their current elevation in the measurement that the map is configured to use. This does not affect token vision at this time. Using positive and negative numbers in this field allows a user to quickly adjust the number instead of directly editing the elevation number.

Target

This allows a user to toggle a targeting indicator on the token.

Toggle Combat

If there is an active combat, clicking this button will place the token in the combat tracker. Clicking it a second time will remove the token from combat. When this is done, the token's initiative score (if it had one) is not retained.