Save project (.3mf, can replace a file)
save_projectSave the open OrcaSlicer project as a .3mf with its plates, object placement, and settings to preserve session work; specify a path for Save As or overwrite an existing file.
Instructions
Save the open project as a .3mf with its plates and settings (File > Save or Save As); save_gcode saves the sliced G-code instead.
It writes exactly what File > Save / Save Project As writes: plates, object placement, per-object and per-plate settings, height-range modifiers, slot presets and colours, and unsaved config overrides. No dialog opens; OrcaSlicer's own prompts are answered from the arguments. To create a new project file, call new_project and then save_project with a path.
Afterwards get_status reports the new path and dirty false, and the file joins File > Recent. Save early: everything set up through these tools lives only in the open session until it is saved, and is lost if OrcaSlicer closes. A save is refused while a slice runs (slicing). Replacing an existing file also needs Preferences > Remote API > 'Allow deleting and replacing project files' in OrcaSlicer (blocked_by_remote_api_policy otherwise). Needs fork v2.4.2-mcp.15 or later.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "save_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Where to save, a .3mf path on the OrcaSlicer host (Save As). None saves to the project's own path (Save); that fails with no_project_path when the project has never been saved. | |
| overwrite | No | Replace an existing file at `path`. Off by default: a collision is an error, never a silent clobber. Saving the project back onto its own path is a plain Save and needs no overwrite. |