Token Variant Art
Improve management of Token art in-session and during prep.
This module searches a customizable list of directories and makes found art available through various convenient means such as pop-ups and a new Token HUD button.
Main features include:
- Sourcing images from local folders, rolltables, Imgur galleries, and s3 buckets
- Pop-ups on Actor/Token create to select images found based on Actor/Token name
- Overlaying images/videos on top or bellow the token (examples)
- Sharing specific art with players through the Token HUD allowing them to switch out their token art on the fly
- Displaying different images for the same token for each user
- Image filtering based on identifiers e.g. when selecting a portrait only showing images containing 'PRT': Bob[PRT].png, Tom[PRT].png
- Wildcard images shown in the Token HUD
- Aided and/or automatic mapping of images to actor compendiums
- Assigning art to status effects and Visibility/Combat states, updating tokens once conditions such as 'Dead' and 'Paralysis' have been applied
- Assigning custom token configuration (token scale, vision, name etc.) to images which are applied upon image selection through the Token HUD
For the comprehensive list of settings and features checkout the module's wiki.
Watch a short feature showcase on YouTube:
Watch a video guide to help setup main module features: https://youtu.be/r3bK0UEBAL4
You can support me on Patreon. In addition to helping me to continue working on FoundryVTT modules you will be granted access to a selection of pre-configured animated overlays to be used along with this module:
Image to User mappings
Images displayed in the Token HUD can be Shift-Right clicked to open a window that allows you to map an image to be displayed to a specific user.
Pop-up and Randomizer override
By Shift+Left-clicking the Token HUD button you are able to override certain module features for the specific token/actor.
Global and Actor Mappings
The module allows for application of token configurations, running of scripts, display of overlays, and more based on conditions defined via expressions. The mapping menu is accessed by:
Actor Mappings
- Shift-Left Clicking the
Toggle Visibility State,Assign Status Effects, orToggle Combat Statebuttons on the Token HUD - Right-clicking the newly added TVA button on the Token HUD and selecting
Effect Config
Global Mappings
- Using the
Shift+Gshortcut - Going to module settings and selecting
Global Effect ConfigurationsunderActive Effects - Selecting
Open Globalheader button from theActor Mappingsform
Labelis just a descriptor for your benefitExpressionis the condition that will trigger configurations on the right-side of the entry to be executed:Imageif set will update the token imageConfigwill applyToken ConfigurationorRun a ScriptOverlaywill display and Image, Text, or Shape on the token
Always Onwill make theExpressionalways evaluate as trueDisablewill make theExpressionalways evaluate as falseGroupplaces mappings under the same header allowing them to beDisabled en masse and collapsed.
Expressions
-
Accepted Operators:
&&( logical AND)||(logical OR)\!(escaped logical NOT)\((escaped open bracket to group expressions)\)(escaped closed bracket to group expressions)
-
Accepted hp and Token property Comparators:
=(equal)<(less than)>(greater than)<=(less than or equal)>=(greater than or equal)<>(lesser or greater than)
-
Accepted wildcards
\*\{ \}
Examples of valid expressions:
FlyingDead && BurningFlying && \! \( Prone || Dead \)hp<=50%name="Raging Barbarian"lockRotation="true"flags.token-variants.test="true"Exhaustion \*Exhaustion \{1,2,3\}
Special Effect Names:
token-variants-combat: Actives when Token is in combatcombat-turn: Activates when it's Token's turn in combatcombat-turn-next: Actives when Token is next in the initiative order