addAllNPCsToInitiative: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(14 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Languages|addAllNPCsToInitiative}}
{{MacroFunction
{{MacroFunction
|name=Function addAllNPCsToInitiative
|name=addAllNPCsToInitiative
|proposed=false
|trusted=true
|trusted=true
|description=Adds all the [[Token:NPC token|NPC token]]s on the current [[Map:map|map]] to the [[Initiative:initiative panel|initiative panel]]. This function returns the number of [[Token:token|token]]s that were added to the [[Initiative:initiative panel|initiative panel]].  
|description=Adds all [[Introduction_to_Tokens#Token_Type|NPC tokens]] on the Token layer of the current [[Introduction to Mapping|map]] to the [[Introduction to Initiative|initiative panel]]. This function returns the number of [[Token:token|tokens]] that were added to the initiative panel. Tokens already on the initiative panel are not counted.


This function will not assign any initiative value to the [[Token:token|token]]s, you can use the [[setInitiative | setInitiative()]] function
 
to set the initiative value of tokens.
This function will not assign any initiative value to the tokens. You can use {{func|setInitiative}} to set the initiative value of a token.


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
addAllNPCsToInitiative()
addAllNPCsToInitiative()
</source>
</syntaxhighlight>


|example=
|example=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[h: noTokens = addAllNPCsToInitiative()]
[h: numTokens = addAllNPCsToInitiative()]
</source>
</syntaxhighlight>
 


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
Added [r: addAllNPCsToInitiative()] NPCs to the initiative panel.
Added [r: addAllNPCsToInitiative()] NPCs to the initiative panel.
</source>
</syntaxhighlight>


|also=
{{func|setInitiative}}, {{func|addAllPCsToInitiative}}, {{func|addAllToInitiative}}
}}
}}
[[Category:Initiative Function]]
[[Category:Initiative Function]]
{{Languages|addAllNPCsToInitiative}}

Latest revision as of 21:32, 11 May 2024

Languages:  English  • 日本語


addAllNPCsToInitiative() Function

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

Adds all NPC tokens on the Token layer of the current map to the initiative panel. This function returns the number of tokens that were added to the initiative panel. Tokens already on the initiative panel are not counted.


This function will not assign any initiative value to the tokens. You can use setInitiative() to set the initiative value of a token.

Usage

addAllNPCsToInitiative()

Example

[h: numTokens = addAllNPCsToInitiative()]
Added [r: addAllNPCsToInitiative()] NPCs to the initiative panel.

See Also

Languages:  English  • 日本語