nextInitiative: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page nextInitiative to NextInitiative without leaving a redirect: Converting page title to first-letter uppercase)
m (Conversion script moved page NextInitiative to nextInitiative: Converting page titles to lowercase)
(No difference)

Revision as of 22:57, 9 February 2023

nextInitiative() Function

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

Introduced in version 1.3b41
Advances the initiative to the next Token in the Initiative Panel. Only the GM or a trusted macro can call this function. This function returns the offset into the Initiative Panel (starting at 0) of the Token that will get the Initiative. * Since 1.8: This function triggers the onInitiativeChangeRequest (and onInitiativeChange) events, so it is possible that the change will be blocked. See the Guide to Initiative Events for more details. This function will return the offset of the token that has initiative after this function completes, whether the change proceeded as requested or not.

Usage

    nextInitiative()


See Also

Version Changes

  • 1.8 - function now triggers the new onInitiativeChangeRequest and onInitiativeChange events
   * 1.3b41 - Added function