multi_color_copies
Destructive
Print multiple copies of one model, each in a different AMS filament slot, to produce multi-color plates from a single STL or OBJ file.
Instructions
Print multiple copies of the same model, each in a different AMS color.
**Only a printer Kiln drives can make this print** — today a Bambu with
an AMS. At any other printer the copies are REFUSED before slicing
with code ``MULTI_MATERIAL_NOT_DRIVEN`` (every copy would print in one
colour; the slot map below is a Bambu instruction). The refusal
carries what Kiln saw on the printer (``multi_material``) and the
composed plate (``multi_material_3mf``) for slicing elsewhere.
Takes a single model file and produces a multi-color print where each
copy uses a different AMS filament slot. Perfect for "print 4 lids
in 4 different colors" workflows.
**Auto-detect mode** (default): omit *copies*, *ams_slots*, and
*colors* — the tool queries the AMS, finds all loaded trays matching
*material*, and prints one copy per loaded tray.
**Manual mode**: specify *ams_slots* (and optionally *colors*) to
choose exactly which AMS trays to use and how many copies.
Requires PrusaSlicer or OrcaSlicer installed locally. The printer
must be idle and have an AMS with loaded filament.
The emitted 3MF (``multi_color_3mf`` in the result) also opens in
Bambu Studio, which keeps the per-copy colors but re-derives print
settings itself — the result's ``slicer_note`` explains this; relay
it to the user when handing over the file.
:param model_path: Path to the model file (STL or OBJ).
:param copies: Number of copies. Auto-detected from AMS if omitted.
:param ams_slots: The tray each copy prints from, by the printer's own
tray id (``unit * 4 + slot`` on a chained unit, the unit id on an
AMS HT; ``ams_status`` lists each tray's ``tray_id``). E.g.
``[0, 1, 2, 3]`` for all 4 AMS Lite trays, ``[0, 5]`` for A1 and B2.
:param colors: Hex color strings per copy for slicer preview.
E.g. ``["#FF0000", "#00FF00", "#0000FF", "#FFFF00"]``.
Auto-read from AMS if omitted.
:param material: Material type filter for AMS auto-detect
(default ``"PLA"``). Only trays matching this type are used.
:param spacing_mm: Gap between copies on the plate (default 10 mm).
Copies are arranged side by side, centered on the plate.
:param printer_id: Printer model ID for slicer profile selection and
plate-size lookup when arranging the copies.
:param slicer_path: Explicit path to slicer binary.
:returns: Dict with print result, object details, and AMS mapping.
:param preview_token: Token from ``issue_preview_token`` proving this
model 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": {
"model_path": "<model_path>"
},
"name": "multi_color_copies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| colors | No | Hex color strings per copy for slicer preview. E.g. ``["#FF0000", "#00FF00", "#0000FF", "#FFFF00"]``. Auto-read from AMS if omitted. | |
| copies | No | Number of copies. Auto-detected from AMS if omitted. | |
| material | No | Material type filter for AMS auto-detect (default ``"PLA"``). Only trays matching this type are used. Default: "PLA". | |
| ams_slots | No | The tray each copy prints from, by the printer's own tray id (``unit * 4 + slot`` on a chained unit, the unit id on an AMS HT; ``ams_status`` lists each tray's ``tray_id``). E.g. ``[0, 1, 2, 3]`` for all 4 AMS Lite trays, ``[0, 5]`` for A1 and B2. | |
| model_path | Yes | Path to the model file (STL or OBJ). | |
| printer_id | No | Printer model ID for slicer profile selection and plate-size lookup when arranging the copies. | |
| spacing_mm | No | Gap between copies on the plate (default 10 mm). Copies are arranged side by side, centered on the plate. Default: 10.0. | |
| slicer_path | No | Explicit path to slicer binary. | |
| preview_token | No | Token from ``issue_preview_token`` proving this model was shown to the person before printing. Required beside their go-ahead: a print is shown to its owner before it starts. |