token.init: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 23: Line 23:
==Related Pages==
==Related Pages==


* [[introduction to Initiative|Initiative Panel]]
* [[Introduction to Initiative|Initiative Panel]]
* [[token.initHold]]
* [[token.initHold]]
[[Category:Special Variable]]
[[Category:Special Variable]]
[[Category:Macro Function]]

Latest revision as of 23:59, 4 July 2023

The variable token.init holds the value of the token's initiative when the token is present in the Initiative Panel. Note that token.init is only valid for tokens that are added to the Initiative Panel (querying token.init when the token is not in the Initiative Panel will return an error).

Usage

To set a token's token.init value, do the following:

[token.init=value]

where value is a number.

Examples

After adding the token to the Initiative Panel (either by right-clicking on the token and selecting Add to Initiative, or by using the addToInitiative() function), you can set the token's initiative via a macro such as the following:

[h:token.init = 1d20 + initBonus]

where initBonus is assumed to be a variable passed to the initiative macro, or a token property of the token being added. The new initiative value will appear in the initiative panel next to the token name.

Related Pages