Scene Rollback
scene_rollbackRestore a Maya scene from a checkpoint and rebind it to its original path, while saving current state to a safety snapshot first; abort if that snapshot fails unless discarded.
Instructions
Open a checkpoint and rebind the scene to its original path (S2).
Boundary: Disambiguated from scene_checkpoint (write a checkpoint from the current state) and scene_checkpoint_list (enumerate the ones already written) — scene_rollback is the restore half.
Before opening, the current in-memory state is exported to an auto_before_rollback safety snapshot; if that fails, the rollback aborts — pass discard_current_state=True to escape (the result reports safety_snapshot="skipped_by_user"). Untitled scenes and ad-hoc snapshots have no original path, so the scene stays on the checkpoint path (S1) and scene_rebound_to is null.
The snapshot carries no undo history — call scene_snapshot afterwards to rebuild context.
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": {
"filename": "<filename>"
},
"name": "scene_rollback"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | Checkpoint filename from scene_checkpoint_list (cp_*.ma or prev_*.ma). | |
| session_key | No | Maya session key. | |
| discard_current_state | No | Escape hatch — proceed even if the safety snapshot fails. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |