Tokens in range
find-tokens-in-rangeFind tokens near a token or point in a scene, sorted by distance, with optional line-of-sight filtering to exclude those behind walls.
Instructions
List the tokens within a distance (scene units) of a token or point, nearest first, optionally only those not hidden behind walls for sight. Works without a drawn canvas.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"from": "<from>",
"distance": "<distance>"
},
"name": "find-tokens-in-range"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | Yes | Center: { tokenId } (id or name of a token), or { x, y } in pixels | |
| distance | Yes | Range in the units of the scene, e.g. 30 for 30 ft | |
| includeHidden | No | Include hidden tokens; default true | |
| sceneIdentifier | No | Scene id or name; default the scene that is active for everyone | |
| requireLineOfSight | No | Leave out tokens behind walls that block sight |