herolab.refresh

From RPTools Wiki
Revision as of 01:37, 17 May 2024 by Taustin (talk | contribs)
Jump to navigation Jump to search

herolab.refresh() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.5
Refresh the Hero Lab data associated with this token. This will update the statblock and stored images.

Usage

herolab.refresh()
herolab.refresh(tokenRef)

This function will also refresh the token's images (just like when the token is created). The token's base Image from the first image in Hero Lab, the token's Portrait from the second image in Hero Lab, and the tokens' Handout image from the 3rd image in Hero Lab.

Parameters

  • tokenRef - Either the token id or Token Name of the token. Defaults to the Current Token.
Token IDs are unique, but Token Names can be duplicated. Using Token Name when more than one token has the same name can produce unexpected results.


It will return a 1 if successful, otherwise it will return a 0.

Example

Get the boolean value of the refresh flag in the Hero Lab data.
[r: success = herolab.refresh()]

Returns:

0 or 1

See Also

Version Changes

  • 1.5 - Added to main MapTool build.