Delete an actor
delete_actorRemove an actor from a scene, blocking deletion if any scripts reference the actor. Use force to bypass the safety check.
Instructions
Delete one actor file from a scene's actors/ directory. Refuses if any script references this actorId (including via property paths like <actorId>:x_pos); pass force: true to override. The actor's own scripts are not counted as external references — they are deleted with the file.
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": {
"sceneId": "<sceneId>",
"actorId": "<actorId>"
},
"name": "delete_actor"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Skip the cross-reference check. | |
| actorId | Yes | Actor id (UUID) to delete. | |
| sceneId | Yes | Scene id (UUID) the actor lives in. |