print_plate_object
Destructive
Extract and print one object from a multi-object .gcode.3mf file: pulls the object's G-code, uploads it to the printer, and starts the print with a preflight safety check.
Instructions
Extract a single object from a multi-object .gcode.3mf and print it.
This is a compound workflow tool that performs the complete pipeline
in one call:
1. **Extract** the requested object's G-code (``extract_plate_object``)
2. **Upload** the extracted G-code to the printer (``upload_file``)
3. **Preflight + Start** the print (``start_print``, which runs its
own preflight safety check)
Bambu Studio supports multiple plates (plate_1, plate_2, etc.).
Use ``plate_number`` to select which plate to extract and print from.
Object matching is case-insensitive and supports partial names:
``"cap"`` matches ``"TreatHolder - cap.stl"``.
Use ``list_plate_objects`` first if you want to preview what's
available before committing to a print.
:param file_path: Path to the .gcode.3mf file.
:param object_name: Name (or partial name) of the object to print.
:param use_ams: AMS mode — ``"auto"``, ``"true"``, or ``"false"``.
:param ams_mapping: The tray per extruder by the printer's tray id
(e.g. ``[0]`` for slot A1, ``[5]`` for B2; see ``ams_status``).
:param bed_leveling: Run bed leveling before print.
:param flow_cali: Run flow calibration before print.
:param vibration_cali: Run vibration calibration before print.
:param bed_type: Bed surface type (Bambu only): ``"auto"``,
``"textured_plate"``, ``"hot_plate"`` (smooth PEI), ``"cool_plate"``,
``"eng_plate"`` or ``"supertack_plate"``.
:param plate_number: Which plate to extract from (1-based, default 1).
:param printer_name: Which printer to print on. Omit for the default
printer. Both steps are aimed at it, so the object is uploaded to
and started on the same machine.
:returns: Dict with extraction info and print start status.
:param preview_token: Token from ``issue_preview_token`` proving the
object was shown to the person before printing. Required beside their
go-ahead: a print is shown to its owner before it starts.
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": {
"file_path": "<file_path>",
"object_name": "<object_name>"
},
"name": "print_plate_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| use_ams | No | AMS mode — ``"auto"``, ``"true"``, or ``"false"``. Default: "auto". | |
| bed_type | No | Bed surface type (Bambu only): ``"auto"``, ``"textured_plate"``, ``"hot_plate"`` (smooth PEI), ``"cool_plate"``, ``"eng_plate"`` or ``"supertack_plate"``. Default: "auto". | |
| file_path | Yes | Path to the .gcode.3mf file. | |
| flow_cali | No | Run flow calibration before print. Default: true. | |
| ams_mapping | No | The tray per extruder by the printer's tray id (e.g. ``[0]`` for slot A1, ``[5]`` for B2; see ``ams_status``). | |
| object_name | Yes | Name (or partial name) of the object to print. | |
| bed_leveling | No | Run bed leveling before print. Default: true. | |
| plate_number | No | Which plate to extract from (1-based, default 1). Default: 1. | |
| printer_name | No | Which printer to print on. Omit for the default printer. Both steps are aimed at it, so the object is uploaded to and started on the same machine. | |
| preview_token | No | Token from ``issue_preview_token`` proving the object was shown to the person before printing. Required beside their go-ahead: a print is shown to its owner before it starts. | |
| vibration_cali | No | Run vibration calibration before print. Default: true. |