Tokens

From Fantasy Grounds Wiki
Jump to: navigation, search

Using Tokens

Tokens are visual representations of a character or objects on the tabletop. Tokens can be found in the token box accessible via the sidebar on the right hand side of the tabletop.

Tokens can be placed on a campaign map or image to denote the position of the character or object. If dragged from a combat tracker entry, the token will be linked to that combat tracker entry and will gain a faction underlay (based on CT Space/Size field) and a reach underlay (based on Reach field, visible when mouse over token).

Also, tokens can be placed on character records (PC or NPC) or encounter records to preset tokens for addition to the combat tracker, or simply to provide a visual representation of that character.

Finally, tokens can be placed on the hot key bar for quick duplication of tokens. This is useful for placing tokens to denote objects that appear commonly in encounters (such as fire tokens for a non-linear wall of fire, etc.). Just drag from the hot key bar onto the map, just like you would drag from the token box

Token Box

Tokenbox.jpg

The token box contains all of the tokens available for the current campaign. Players can only see a small subset of the tokens available to the GM (i.e. Shared tokens). Token bags are used to group tokens from the same module, or from the same directory. Double-click a token bag to view its contents. Token bags that are shared with players have a small head icon on them.

Features

  • Search Box: The search box at the top of the token box can be used to search for any tokens loaded that have the search text within their file name.
  • Zoom Buttons: The brown plus/minus buttons in the upper right of the token box can be used to zoom the display of the tokens in/out.
  • Token Bag Bar: The token bag bar can be used to quickly navigate among token bags. The first slot returns to the topmost view of the token box. The second slot goes up a level in the token box (if you have navigated within any token bags). The remaining slots can be customized by dragging any token bag onto a slot on the token bag bar.
  • Token Load Buttons: The GM, Shared and Modules button allow the GM to add tokens to the existing tokens available from his machine or this campaign.

Loading Locations

  • GM Tokens: GM tokens available for all campaigns. Any tokens stored in the FG data directory under the tokens/host subfolder. Accessible via the GM button in the Token Box window. GM tokens are only displayed in the GM token box.
  • Shared Tokens: Shared tokens available for all campaigns. Any tokens stored in the FG data directory under the tokens/shared subfolder. Accessible via the Shared button in the Token Box window. Shared tokens are displayed in both the GM and player token boxes.
  • Module Tokens: Tokens loaded from a token module. Token modules can be activated via the Modules button in the Token Box window. All tokens loaded from a module will be placed in a token bag with the module's name. Module tokens are only displayed in the GM token box.
  • Ruleset: Tokens available for only this game system. Any tokens stored in the ruleset directory or package directory under the tokens subfolder. Ruleset tokens are only displayed in the GM token box.
  • Campaign: Tokens available for only this campaign. Any tokens stored in the campaign directory under the tokens subfolder. The campaign directory is located in the FG Data directory under the campaigns subfolder. Campaign tokens are only displayed in the GM token box.

Note:The recommended image format is PNG for the best transparency support. Token file sizes should be monitored for practical purposes, as larger files take longer to share, especially so with a larger number of players. Most tokens available online use a 50x50 or 64x64 token size in order to balance clarity with image size. The number of tokens in the campaign can also affect performance. The number of token files should be kept to the minimum necessary to run the game for best performance.

Map Tokens

Once tokens are added to a map, additional token features become available.

Addition

  • Add Single Token: Drag a token from the token box, a token field within a record window or from the hot key bar; and drop on a map. To link a token to the combat tracker, drag the token from the associated token field within the combat tracker entry.
  • Add Faction Tokens: Drag and drop the faction icon from the combat tracker onto a map. The tokens will be linked to the combat tracker.

If tokens were placed when creating an encounter, they will be added automatically when the encounter is added to the combat tracker.

Deletion

  • Delete Single Token: Right click on a token, and select the Delete Token->Delete This Token menu option.
  • Delete All Map Tokens: Right click on a token, and select the Delete Token->Delete All Tokens menu option.

If a token was added from the the combat tracker, it will be removed automatically when the CT entry is deleted. If a token was added during encounter placement, it will be removed automatically when the encounter window is closed.

Movement

Token waypoints.jpg

Map tokens can be moved within and between maps. Just click and drag the token to the desired location on a map. To move a set of tokens as a group, see the next topic.

The GM has the option of locking player movement of tokens on the map. When this option is enabled, any player token movement will create a movement waypoint instead. To add an additional movement waypoint, hover over the last waypoint and drag to the desired additional waypoint. To reset waypoints, click and drag the token again.

The GM has these additional options:

  • Toggle Movement Lock: Right click on a token, and select the Lock/Unlock Tokens menu option.
  • Set Token Waypoint: While movement locking enabled, CTRL-click and drag a map token to set a waypoint as a GM.
  • Accept Move: While a set of waypoints is defined for a token, middle click on the token, or right click on the token and select the Accept Move menu option.

Selection

One or more map tokens can be "selected". When a set of tokens is selected, they can be moved or targets can be assigned as a group. Selected tokens are denoted by a black circle underneath the token.

  • Toggle Single Token Selection: Click on a token to select only that token. If that token was already selected by itself, it will be unselected instead.
  • Add/Remove Selected Tokens: SHIFT-click on a token to add/remove the token from the set of selected tokens.
  • Token Selection Tool: Use the token selection tool to select a group of tokens. The token selection tool can be activated via the Image window toolbar or by right clicking on the image and selecting the Selection Modes->Token Selection Mode. Click and drag the box around the tokens to select. SHIFT-click and drag to drag a freehand region around the tokens to select.

Activation

A token is set to the active state when the combat tracker entry it is linked gets its turn in the CT. The GM can also target the token active state by clicking on the associated token field in the CT. Active tokens are denoted by a white circle underneath the token.

Rotation/Facing

Map tokens can be rotated to different orientations by using the mouse wheel while hovering on a token, or by right-clicking on token and selecting the Rotate Left/Right menu options. When the token facing option is enabled, a small yellow pointer will be rotated around token, instead of the token orientation changing.

Targeting

Token targeting.jpg

Each map token can target any token on the same map. Targets are denoted by arrows between the tokens targeting each other. The targeting arrows are visible when hovering the cursor over a token, or when the token is selected. If not hovering or selecting a token, the active token targets will be shown (i.e. active characters for players, active CT entry for GM). When assigning targets the selected tokens will be used. If no targets are selected, then the active token will be used (i.e. active character for players, active CT entry for GM).

  • Toggle Target: CTRL-click on a token to toggle targeting of that token.
  • Clear Targets: Click the Clear Targets button in the image window toolbar. Clears all targets for the active/selected tokens.
  • Target Friendly Units: Click the Target Friendly Units button in the image window toolbar. For active/selected tokens, sets all tokens with the same faction as targets. Token factions are set when tokens are added from the CT.
  • Target Enemy Units: Click the Target Enemy Units button in the image window toolbar. For active/selected tokens, sets all tokens that don't have the same faction as targets. Token factions are set when tokens are added from the CT.
  • Targeting Mode: Click the Target Mode button in the image window toolbar; or by right clicking on the image and selecting the Selection Modes->Token Target Mode menu option. Click and drag the box around the tokens to target with the active/selected tokens. SHIFT-click and drag to drag a freehand region around the tokens to target.

Scaling

For FG, maps and tokens are just an image file. When placing a token on a map, FG tracks the map-to-token global scale, as well as an individual token scale.

For newer rulesets when a grid is defined on a map, the map-to-token scale is set automatically by adjusting the token to fit within a single grid square (or the number of squares denoted in the CT for CT-linked tokens).

In older rulesets or when a grid is not defined, the map-to-token scale is not set automatically. Use the mouse wheel to zoom the map until the tokens are the right scale relative to the map; then right click on a token, and select the Lock Token Scale menu option. The map-to-token scale can be released using the same method.

To change the individual token scale, hold CTRL while using the mouse wheel to adjust the individual token scale up and down. Hold CTRL and middle click to reset the token scaling back to the default (or right click and select the Reset Individual Token Scale menu option).

Visibility

Tokens can have 3 different visibility states: always visible, always invisible and mask-sensitive visibility. With mask sensitive visibility, the token is only visible if the center of the token is in an unmasked region of the map.

For CT-linked tokens, PC token visibility defaults to always visible, and NPC token visibility can be toggled through the GM combat tracker between always invisible and mask-sensitive visibility. For other tokens, the default visibility is mask-sensitive.

To manually set the visibility of a token, right click on the token and select the Visibility menu option you desire.