setCurrentInitiative: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(15 intermediate revisions by 4 users not shown)
Line 3: Line 3:
|trsuted=true
|trsuted=true
|description=
|description=
Gives the [[Initiative:Initiative|Initiative]] to the [[Token:Token|Token]] at the specified offset in the [[Iniatiative:Initiative Panel|Initiative Panel]]. Offsets start at 0.  Specifying a number of -1 or a number equalto or greater than the number of tokens in initiative list will clear current initiative.
Gives the [[Introduction to Initiative|Initiative]] to the [[Token]] at the specified offset in the [[MapTool User Interface#Initiative|Initiative Panel]]. Offsets start at 0.   
 
To clear, specify a number that is not a valid token offset, like -1.


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: setCurrentInitiative(offset)]
[h: setCurrentInitiative(offset)]
</source>
</syntaxhighlight>


|examples=
|examples=
Give Initiative to the 4th [[Token:Token|Token]].
Give Initiative to the 4th [[Token]].
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: setCurrentInitiative(3)]
[h: setCurrentInitiative(3)]
</source>
</syntaxhighlight>
Clear initiative.
Clear current initiative (any number that is not a valid token offset will work).
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: setCurrentInitiative(-1)]
[h: setCurrentInitiative(-1)]
[h: setCurrentInitiative(999)]   // Any number greater or equal to the number of tokens in list.
[h: setCurrentInitiative(999)]
</source>
</syntaxhighlight>


}}
}}
[[Category:Initiative Function]]
[[Category:Initiative Function]]

Latest revision as of 23:59, 14 March 2023

setCurrentInitiative() Function

Gives the Initiative to the Token at the specified offset in the Initiative Panel. Offsets start at 0. To clear, specify a number that is not a valid token offset, like -1.

Usage

[h: setCurrentInitiative(offset)]

Examples

Give Initiative to the 4th Token.
[h: setCurrentInitiative(3)]

Clear current initiative (any number that is not a valid token offset will work).

[h: setCurrentInitiative(-1)]
[h: setCurrentInitiative(999)]