wait_for_node
Blocks until a node appears in the scene tree with a configurable timeout, returning true if found or false on timeout. Useful for waiting on dynamically spawned nodes.
Instructions
Block until a node appears in the scene tree. Useful for waiting on dynamically spawned nodes (e.g., wait for "Player/Sword" to appear after equip). Returns whether the node was found or the wait timed out. The project must be running via run_interactive.
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": {
"nodePath": "<nodePath>"
},
"name": "wait_for_node"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| timeout | No | Maximum seconds to wait before timing out (default: 5). | |
| nodePath | Yes | Path to the node to wait for (e.g., "Player/Sword", "Enemies/Boss"). |