token-move
Move a token to pixel coordinates (top-left corner; pixel = gridCoord * gridSize); token-list gives tokenId. Pathfinding routes around walls and closed doors; pathCost (cells) reports a detour — pathCost * gridDistance > speed means more than one turn; Large+ tokens need wide corridors. Closed doors count as walls unless the user asks to open them (canOpenDoors=true; doorsOpened[] lists the walls). Locked (ds=2) and secret (door=2) doors are impassable: scene-set-door-state first.
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": {
"tokenId": "<tokenId>",
"x": "<x>",
"y": "<y>"
},
"name": "token-move"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | New X position in pixels | |
| y | Yes | New Y position in pixels | |
| animate | No | Animate movement (default: true) | |
| tokenId | Yes | Token ID (use token-list to find) | |
| canOpenDoors | No | Open closed doors along the path. Only when the user explicitly asks; default false. |