print_plate_object
Extract a specific object from a multi-plate .gcode.3mf file and start printing it. Specify the plate number and object name; the tool uploads the G-code and runs preflight checks before starting the print.
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: AMS slot mapping (e.g. ``[0]`` for slot 1).
: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 — ``"auto"``, ``"textured_plate"``,
``"cool_plate"``, or ``"engineering_plate"`` (Bambu only).
: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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| use_ams | No | auto | |
| bed_type | No | auto | |
| file_path | Yes | ||
| flow_cali | No | ||
| ams_mapping | No | ||
| object_name | Yes | ||
| bed_leveling | No | ||
| plate_number | No | ||
| printer_name | No | ||
| vibration_cali | No |