light_add
Adds a directional, omni, or spot light to a Godot 3D scene. Configure energy and color to illuminate your game world.
Instructions
Add a light source to a 3D scene.
Category: Light
Args: project_path: Path to the Godot project directory scene_path: Path to the scene file (relative to project) parent_node_path: Path to the parent node light_name: Name for the new light node light_type: Type of light (DirectionalLight3D, OmniLight3D, SpotLight3D, default: DirectionalLight3D) Note: PointLight3D is deprecated in Godot 4.x, use OmniLight3D instead energy: Light energy/intensity (default: 1.0) color: Light color as JSON array [r, g, b] with values 0-1 (default: [1, 1, 1] white)
Returns: Success message or error description
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": {
"project_path": "<project_path>",
"scene_path": "<scene_path>",
"parent_node_path": "<parent_node_path>",
"light_name": "<light_name>"
},
"name": "light_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_path | Yes | ||
| scene_path | Yes | ||
| parent_node_path | Yes | ||
| light_name | Yes | ||
| light_type | No | DirectionalLight3D | |
| energy | No | ||
| color | No | [1, 1, 1] |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |