Token HUD Wildcard for Foundry VTT

This Foundry VTT module adds a button to the Token HUD if the token has Randomized Wildcard Images activated and more than 1 image.

When this HUD button is pressed, a small panel will be displayed on the right side of the token HUD with a list of buttons for each detected image from the Wildcard Images functionality. Pressing any of these will allow to easily change the image of the Token without opening the token configuration panel.

The token images were done by the amazing Ross McConnell at 2-Minute Tabletop and are part of the Hero Tokens 3 Pack.

This is an updated fork of the original module by javieros105. See Contributors below for everyone who helped out maintaining this module.

Usage

For general Token and Wildcard token information, see the Foundry article: Foundry: Tokens.

Special file names can be used to override some default token settings. It's important that each parameter is preceded by an underscore, so if you want to set up height, there has to be a _height<number>_ somewhere in the file name. <number> can be integer or floating point number. Signs (-/+) aren't supported.

More specific parameters beat less specific ones. For example, if you specify both scaleX and scale, scaleX will be used for the X scale, while Y will use scale.

The parsed parameters currently are:

• height (in grid units, 1 by default)
• width (in grid units, 1 by default)
• alpha (0.0 to 1.0, 1.0 by default)
• scale, scaleX, scaleY (this is a multiplier from 0.2 to 3.0, 1.0 by default)
• anchor, anchorX, anchorY (0.0 to 1.0, 0.5 by default)

If any parameter is missing then the module will use the prototype token parameters as default, so you can use images with no parameter setting at all or just set one or two of the parameters.

Some valid file name examples:

• imagename.extension (e.g. mystery-man.png or dragon.svg)
• imagename_height<number>_width<number>_scale<number>_.extension
• imagename_height-other_height2_scale1.5_.extension

Installation

To install the module, follow the Foundry article on Module Management.

For installation by manifest URL, use this URL:
https://raw.githubusercontent.com/mhilbrunner/token-hud-wildcard/master/module.json

ZIP file downloads and manifest files for specific module versions are listed under releases.

Changelog

See Releases.

Acknowledgements

Thanks to Atropos and the Foundry team, javieros105 for originally creating this module and thanks to all contributors!

Contributors

• @javieros105: Original module
• @arbron: Making the update for compatibility with 0.8.x of Foundry and fixing errors.
• @SirTman: Compatibility issue with apperance tab in prototype token foundry v9
• @cs96and: Fix of default token rendering on preCreateToken hook that created duplicates of image and didn't render the default token.
• @MiniGrief: Foundry v10 compatibility and bug fixes.

License

The source code is licensed under GPL-3.0.