herolab.isMinion: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 9: Line 9:
<syntaxhighlight lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
herolab.isMinion()
herolab.isMinion()
herolab.isMinion(id)
herolab.isMinion(tokenRef)
</syntaxhighlight>
</syntaxhighlight>


'''Parameters'''
'''Parameters'''
{{param|id|The id of the token. Defaults to the Current Token.}}
{{param|tokenRef|Either the token [[getSelected|{{code|id}}]] or [[getTokenName|Token Name]] of the token. Defaults to the Current Token.}}
{{Note|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.}}


|example=
|example=

Latest revision as of 23:59, 17 May 2024

herolab.isMinion() Function

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

Introduced in version 1.5
Returns true if token is a Hero Lab minion character, such as an Eidolon or Familiar. Otherwise it returns false.

Usage

herolab.isMinion()
herolab.isMinion(tokenRef)

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.

Example

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

Returns:

0 or 1

This is the same as using the getInfo() function and reading the isMinion field.

[h: info = herolab.getInfo()]
[r: isMinion = json.get(info,"isMinion")]

Returns:

0 or 1

See Also

Version Changes

  • 1.5 - Added to main MapTool build.