From RPTools Wiki
Jump to navigationJump to search

selectTokens() Function

Introduced in version 1.3b68
Selects one or more visible tokens on the map.


selectTokens(id, add)
selectTokens(tokens, add, delim)


  • id - the id string or token name of a specific token to select (the examples below use token names, but IDs are also permitted); if left blank all visible tokens are selected.
  • add - if the value of add is true(1), the selections will be added to the current set of selected tokens; if the value is false(0) currently selected tokens will be deselected before new tokens are selected. Defaults to false.
  • tokens - a String List of tokens to select.
  • delim - Specifies the delimiter used in the string list that is supplied. If the delimiter is "json", then the value for tokens may be a JSON Array instead. Note: if using a JSON Array or String List, both add and delim must be specified.


To select a single token with the name "Adventurer":

To select a list of Tokens using a String List, replacing the current selection

[h:selectTokens("Adventurer, Orc 2, Goblin 1", 0, ",")]

To select a list of Tokens using a JSON Array, adding the specified tokens to the current set of selected Tokens:

[h:selectTokens("['Adventurer', 'Orc 2', 'Goblin 1']", 1, "json")]

See Also

Version Changes

  • 1.3b68 - Function added.