Skip to content

cschlosser/TokenVariants

 
 

Repository files navigation

GitHub Latest Version GitHub Latest Release GitHub v9 Release GitHub All Releases Forge Installs

Token Variant Art

Improve management of Token art in-session and during prep.

This module searches a customisable list of directories and makes found art available through vairous 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
  • 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 the video

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:

"Animated Overlays"

Higher tiers will also grant you condition rings (v10 exclusive):

"Condition Ring Overlays"

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.

"User Image Mapping"

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.

"Setting Override"

Status Config

Allows to map images to Visibility/Combat status and Active Effects.

"Status Configuration"

The window is accessed by Shift+Left-Clicking on the status buttons or the Active Effects in the Token HUD.

HP/Rotation/Elevation Based Effects

Instead of effect names the module also allows to enter hp, rotation, and elevation comparisons into these fields allowing you to apply images and configuration based on the current health of the token:

HP Effects

  • Accepts both percentages and exact values (e.g. hp<=15, hp=100%)
  • Accepted signs: <, >, =, <=, >=

Logical Expression Based Effects

On top of comparators effect configs also support logical expressions.

Accepted Operators:

  • && ( logical AND)
  • || (logical OR)
  • \! (escaped logical NOT)
  • \( (escaped open bracket to group expressions)
  • \) (escaped closed bracket to group expressions)

Examples:

  • Flying && \! Prone
    • Config will be applied if the token has the effect Flying and does not have Prone
  • Raging || Burning
    • Config will be applied of the token has either the effect Raging or Burning or both.

Installation

To install, import this manifest into the module browser or search for 'Token Variant Art'.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 79.5%
  • HTML 16.8%
  • CSS 3.7%