Node Set Property
node_set_propertySet a property on a Godot scene node, coercing values to the expected type. Verify the exact property name first to avoid write failures.
Instructions
Set a property on a node.
Overrides on an instance's internal nodes require Editable Children to be explicitly enabled; otherwise the call fails before mutation.
Verify the property name first — call node_get_properties (or read
godot://node/{path}/properties) to confirm the exact name and type
before writing. Guessing common Godot names often fails with
PROPERTY_NOT_ON_CLASS because Godot's actual properties differ from
intuition (e.g. Camera3D uses fov/current, not field_of_view;
Sprite2D uses texture, not image; Node3D uses
position/rotation/scale, not transform.origin).
Coerces value to the property's type:
Vector2/Vector3: dict with x/y/z keys.
Color: dict {r,g,b,a} or hex string ("#ff0000").
NodePath: string ("../Other/Node").
Node-typed export (
@export var target: Node2D): node path string, either a scene path ("/Main/Player") or relative to the node ("../Player"); the node's class is checked against the export's type, and the response reports the scene path. null/"" clears.Typed node array (
@export var targets: Array[Node2D]): JSON list of node path strings, each resolved and class-checked the same way; errors name the element index.Resource: res:// path string (loads + assigns); null/"" clears.
{"__class__": "BoxMesh", ...}creates a built-in resource owned by this property. After scene_save it is serialized in-place as a[sub_resource]inside the .tscn; it is not a reusable .tres. For sharing, first callresource_manage(op="create", params={"type": "BoxMesh", "properties": {...}, "resource_path": "res://meshes/box.tres"}), then pass that res:// path here (or use resource_manage(op="assign")).StringName: plain string. Array/Dictionary: JSON list/object.
PackedByteArray: JSON list of whole numbers 0..255, at most 65,536 bytes per value. [] clears. Strings, booleans, fractions and out-of-range values are rejected before mutation. Also supported inside typed containers and resource constructor properties.
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": {
"path": "<path>",
"property": "<property>",
"value": "<value>"
},
"name": "node_set_property"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Scene path relative to the edited scene root (e.g. "/Main/Camera3D"), NOT runtime "/root/..." paths. | |
| value | Yes | New value. Pass null (or "" for resources) to clear. | |
| property | Yes | Property name (e.g. "fov", "position", "mesh"). Must match Godot's exact identifier — introspect with ``node_get_properties`` if unsure rather than guessing. | |
| scene_file | No | Optional editor-scene guard. | |
| session_id | No | Optional Godot session to target. Empty = active session. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||