Register

Arga's Token Link Indicator

An Add-on Module for Foundry Virtual Tabletop

Author: Arga Project: Source Foundry Versions 13+ (Verified 14) Last Updated 1 day, 16 hours ago

A small, system-agnostic module whose chain icon shows whether a token is linked to its Actor — and whether an open sheet belongs to a token in the scene or to the prototype token.

The chain icon sits in three places, each of them optional and switchable in the Game Settings:

 

Chain icon in an Actor sheet header
Actor sheet header — this token is not linked

 

Chain icon in the Token HUD
Token HUD — linked (Gamemasters only)

 

Chain icons in the Actors sidebar
Actors sidebar — prototype tokens, linked and unlinked

 

green chain icon means that token and Actor are linked. Change the items or the values of one, and they change on the other as well. This is the usual setting for player characters.

red broken chain icon means that token and Actor are not linked. The token can therefore carry values of its own. This is the usual setting for NPCs, and it allows all five orcs in a scene to have different amounts of health, for example.

If there is a small P next to the chain icon, the icon does not mean a token in the scene but the Actor's prototype token — the template new tokens are created from. Tokens dragged into a scene from a 'green' prototype token are linked to the Actor automatically; tokens from a 'red' one are not.

Every chain icon can be clicked in three ways:

Option: Clearer Button Labels

Foundry gives the save button of the Token configuration the very same label as the one of the Prototype Token configuration — which makes the two windows easy to confuse. And the 'Assign Token' button replaces all values of the prototype with those of a selected token immediately, without asking. An optional setting adds short explanations to these buttons:

 

Configuration buttons with an explanatory second line

 

and asks before the prototype is overwritten:

Confirmation dialog before the prototype is overwritten

 

A Few Words on "Linking" — What Foundry Actually Does

The behaviour of linked and unlinked tokens described above is plain Foundry standard — Arga's Token Link Indicator merely makes the link visible.

Since linking can be confusing at times, here is a short summary:

linked token has no values of its own: its sheet is the sheet of the base Actor, that is, of the entry in the sidebar. Every change to the Actor affects all of its linked tokens. The configuration settings however (vision range, for example) belong to each token alone.

An unlinked token stays connected to its base Actor as well! Change something on the Actor and you change the unlinked (!) token along with it. The only exception are values you have already changed on the token itself — those the token keeps.

Example: Your prototype token "Orc" is unlinked. The orc carries a scimitar that deals a certain amount of damage. Now you drag three orcs into the scene. Since they are unlinked, you can change every one of them individually. On one of the orcs you set the damage of its scimitar higher. Only that one orc token then has the increased damage.
On the Actor in the sidebar, however, you now lower the damage of the scimitar, and you add a shortbow to the inventory. Even though Actor and tokens are unlinked, as we said, all three orcs in the scene now carry a shortbow, and two of the three have a scimitar with reduced damage. Only the one orc whose damage you raised keeps its own increased value.

Languages

The module is available in English and German.

 

Supported Game Systems

  1. Savage Worlds Adventure Edition

    Latest Version: Version 6.0.4 Last Updated 1 month, 2 weeks ago

Categories

Available Versions

  1. Version 14.0.1

    1 day, 16 hours ago
    Foundry Version 13+ (Verified 14) Manifest URL Read Notes