# scene.patch

> Talos next · Since next

[editor or disk] An RFC 6902 JSON Patch on the scene, ONE undo step, all or nothing; an invalid result is refused with its contract violations.

/entities/- appends; /entities/@<id> is that entity anywhere. Reusable entities: prefabs toolset.

| | |
|---|---|
| Title | Patch the scene |
| Mode |  |
| Token cost | about 359 tokens (in the default list, paid on every call) |
| Toolset | core |

## Arguments

| Argument | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `agent` | `string` | no |  |  | The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent. |
| `dryRun` | `boolean` | no |  |  | With instance: report, write nothing |
| `instance` | `boolean` | no |  |  | Turn each group of min+ identical static mesh entities into one instancedMesh (no ops) |
| `label` | `string` | no |  |  | What undo will call this step |
| `min` | `integer` | no |  |  | With instance: smallest group converted (16) |
| `ops` | `object[]` | no |  |  |  |
| `organize` | `boolean` | no |  |  | File roots into folders (no ops) |
| `resolved` | `boolean` | no |  |  | Address the resolved view; prefab values become overrides |
| `save` | `boolean` | no |  |  | `true` saves the scene afterwards. |
| `scene` | `string` | no |  |  | The scene file to act on. The open scene when absent. |
| `select` | `string` | no |  |  | An entity id to select afterwards |

## Example

An MCP `tools/call` with the required arguments (placeholders in angle brackets).

```json
{
  "name": "scene.patch",
  "arguments": {}
}
```