getTokenStates: Difference between revisions
Jump to navigation
Jump to search
m (Text replacement - "source>" to "syntaxhighlight>") |
m (Text replacement - "<source" to "<syntaxhighlight") |
||
| Line 6: | Line 6: | ||
|usage= | |usage= | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
getTokenStates() | getTokenStates() | ||
getTokenStates(delim) | getTokenStates(delim) | ||
| Line 21: | Line 21: | ||
|example= | |example= | ||
To get a [[String List]] of the valid [[Token State]]s in the campaign. | To get a [[String List]] of the valid [[Token State]]s in the campaign. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: states = getTokenStates()] | [h: states = getTokenStates()] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
To get a [[JSON Array]] of the valid [[Token State]]s in the campaign. | To get a [[JSON Array]] of the valid [[Token State]]s in the campaign. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: states = getTokenStates("json")] | [h: states = getTokenStates("json")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
To get a [[JSON Array]] of the valid [[Token State]]s in the ''Damage'' group in the campaign in 1.3b55 or later. | To get a [[JSON Array]] of the valid [[Token State]]s in the ''Damage'' group in the campaign in 1.3b55 or later. | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: states = getTokenStates("json", "Damage")] | [h: states = getTokenStates("json", "Damage")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
To get a [[JSON Array]] of the [[Token State]]s set to {{true}} for the "Dragon" token: | To get a [[JSON Array]] of the [[Token State]]s set to {{true}} for the "Dragon" token: | ||
< | <syntaxhighlight lang="mtmacro" line> | ||
[h: states = getTokenStates("json", "*", "Dragon")] | [h: states = getTokenStates("json", "*", "Dragon")] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 20:23, 14 March 2023
getTokenStates() Function
• Introduced in version 1.3b51
Returns the valid states in the campaign settings in either a String List or JSON Array. Alternatively, if a token id is specified, instead returns the list of the states that are set to
true(1) for the token.Usage
getTokenStates()
getTokenStates(delim)
getTokenStates(delim, groupName)
getTokenStates(delim, groupName, id)
getTokenStates(delim, groupName, id, mapname)Parameter
delim- Specifies the delimiter used in the string list that is returned, default is",". If the value is set tojson, the function returns a JSON array instead.groupName- Specifies the name of the group to get the states for. If set to "*", get all states.id- The id of the token to get the states set totrue(1). If the parameter is not used, instead returns all valid states in the campaign settings.Note: This parameter can only be used in a Trusted Macro.
mapname- The name of the map where the token is. Set to the current map by default.
Example
To get a String List of the valid Token States in the campaign.
[h: states = getTokenStates()]To get a JSON Array of the valid Token States in the campaign.
[h: states = getTokenStates("json")]To get a JSON Array of the valid Token States in the Damage group in the campaign in 1.3b55 or later.
[h: states = getTokenStates("json", "Damage")]To get a JSON Array of the Token States set to true(1) for the "Dragon" token:
[h: states = getTokenStates("json", "*", "Dragon")]
Version Changes
- 1.3b55 - Added the
groupNameparameter. - 1.5.7 - Added
idandmapnameparameter options.