getTerrainModifier: Difference between revisions
Jump to navigation
Jump to search
m (Conversion script moved page GetTerrainModifier to getTerrainModifier: Converting page titles to lowercase) |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| (One intermediate revision by the same user not shown) | |||
| Line 7: | Line 7: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTerrainModifier() | getTerrainModifier() | ||
getTerrainModifier(token) | getTerrainModifier(token) | ||
| Line 14: | Line 14: | ||
getTerrainModifier(type, token) | getTerrainModifier(type, token) | ||
getTerrainModifier(type, token, map) | getTerrainModifier(type, token, map) | ||
</ | </syntaxhighlight> | ||
'''Parameters''' | '''Parameters''' | ||
{{param|token|Optional token name or return type.}} | {{param|token|Optional token name or return type.}} | ||
| Line 23: | Line 23: | ||
Get the Terrain Modifier for the named token: | Get the Terrain Modifier for the named token: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: tmod = getTerrainModifier("Sticky Floor Tile")] | [r: tmod = getTerrainModifier("Sticky Floor Tile")] | ||
</ | </syntaxhighlight> | ||
'''Output:''' | '''Output:''' | ||
< | <syntaxhighlight lang="mtmacro"> | ||
2.0 | 2.0 | ||
</ | </syntaxhighlight> | ||
Get terrain modifiers as a JSON Object on the Wizard's Keep map. | Get terrain modifiers as a JSON Object on the Wizard's Keep map. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: tmod = getTerrainModifier("JSON", "Sticky Floor Tile", "Wizard's Keep")] | [r: tmod = getTerrainModifier("JSON", "Sticky Floor Tile", "Wizard's Keep")] | ||
</ | </syntaxhighlight> | ||
'''Output:''' | '''Output:''' | ||
< | <syntaxhighlight lang="javascript"> | ||
{ | { | ||
"terrainModifier": 2.0, | "terrainModifier": 2.0, | ||
| Line 44: | Line 44: | ||
"terrainModifiersIgnored": ["NONE"] | "terrainModifiersIgnored": ["NONE"] | ||
} | } | ||
</ | </syntaxhighlight> | ||
Get terrain modifiers for the named token that ignores ADD & MULTIPLY mod types. | Get terrain modifiers for the named token that ignores ADD & MULTIPLY mod types. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[r: tmod = getTerrainModifier("Elf with Fancy Feet")] | [r: tmod = getTerrainModifier("Elf with Fancy Feet")] | ||
</ | </syntaxhighlight> | ||
'''Output:''' | '''Output:''' | ||
< | <syntaxhighlight lang="javascript"> | ||
{ | { | ||
"terrainModifier": 0.0, | "terrainModifier": 0.0, | ||
| Line 58: | Line 58: | ||
"terrainModifiersIgnored": ["ADD","MULTIPLY"] | "terrainModifiersIgnored": ["ADD","MULTIPLY"] | ||
} | } | ||
</ | </syntaxhighlight> | ||
Latest revision as of 20:29, 14 March 2023
getTerrainModifier() Function
Note: This function can only be used in a Trusted Macro
• Introduced in version 1.5.2
Gets the Terrain Modifier for the named Token or for the Current Token if no name is given. If the first parameter is
"JSON" then a JSON Object is returned with the Terrain Modifier, Terrain Modifier Type and an array of Ignored Terrain Modifier Types.Usage
getTerrainModifier()
getTerrainModifier(token)
getTerrainModifier(token, map)
getTerrainModifier(type)
getTerrainModifier(type, token)
getTerrainModifier(type, token, map)Parameters
token- Optional token name or return type.type- First parameter can be the string "JSON" to get a JSON Object back.map- Optional map name to find the token on. Current map is used if not supplied.
Example
Get the Terrain Modifier for the named token:
[r: tmod = getTerrainModifier("Sticky Floor Tile")]Output:
2.0Get terrain modifiers as a JSON Object on the Wizard's Keep map.
[r: tmod = getTerrainModifier("JSON", "Sticky Floor Tile", "Wizard's Keep")]Output:
{
"terrainModifier": 2.0,
"terrainModifierOperation": "ADD",
"terrainModifiersIgnored": ["NONE"]
}
Get terrain modifiers for the named token that ignores ADD & MULTIPLY mod types.
[r: tmod = getTerrainModifier("Elf with Fancy Feet")]Output:
{
"terrainModifier": 0.0,
"terrainModifierOperation": "NONE",
"terrainModifiersIgnored": ["ADD","MULTIPLY"]
}
See Also
Version Changes
- 1.5.11 - Added support for new terrain modifier types.