setCurrentInitiative: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(New page: ==Function setCurrentInitiative== {{GMOnlyFunction}} Gives the Initiative:Initiative to the Token:Token at the specified offset in the Iniatiative:Initiative Panel. Offsets ...)
 
No edit summary
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Function setCurrentInitiative==
{{MacroFunction
{{GMOnlyFunction}}
|name=setCurrentInitiative
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.
|trsuted=true
|description=
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 current initiative  (any number that is not a valid token offset will work).
<syntaxhighlight lang="mtmacro" line>
[h: setCurrentInitiative(-1)]
[h: setCurrentInitiative(999)]
</syntaxhighlight>
 
}}
[[Category:Initiative Function]]

Latest revision as of 21:07, 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)]