movedOverToken: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Updated with parameters and examples.)
No edit summary
Line 41: Line 41:
'''Returns:'''
'''Returns:'''
A count of the cells of the ''Caltrops'' token the current token moved over.
A count of the cells of the ''Caltrops'' token the current token moved over.
To be clear: this ONLY works if you have ONE token on the maps called ''Caltrops'', if you want to check for multiple tokens you either need to use their ID or give them a unique name and refer to that.
<source lang="mtmacro">
<source lang="mtmacro">
Token moved over 3 caltrops.
Token moved over 3 caltrops.

Revision as of 22:27, 16 June 2022

movedOverToken() Function

Introduced in version 1.3.b74
Is used to check if the location of the target token is in an array of cell coordinates like the one received from getLastPath() or the onTokenMove event's macro.args.  

Usage

movedOverToken(token)
movedOverToken(token, lastPath)

Parameters

  • token - The target token to compare the
  • lastPath - Optional JSON array of coordinate pairs. If not supplied will use the last path of the current token.

Returns

A JSON array of cell coordinates where the moving token crossed the target token.

[{"x":900,"y":400},{"x":900,"y":350},{"x":900,"y":300}]

Example

Check if the current token moved over a token called "Pit Trap".
[r: movedOverToken("Pit Trap")]

Returns: An array of coordinate pairs. In this case, just one.

[{"x":550,"y":250}]

Count how many cells of caltrops the current token moved through.

[h: lastPath = getLastPath(1)]
[h: locations = movedOverToken("Caltrops",lastPath)]
Token moved over [r: json.length(locations)] caltrops.

Returns: A count of the cells of the Caltrops token the current token moved over. To be clear: this ONLY works if you have ONE token on the maps called Caltrops, if you want to check for multiple tokens you either need to use their ID or give them a unique name and refer to that.

Token moved over 3 caltrops.

See Also