multi_color_copies
Print multiple copies of a single model, each in a different color, by using AMS filament slots. Automatically detects loaded trays or specify slots manually.
Instructions
Print multiple copies of the same model, each in a different AMS color.
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: Explicit AMS slot indices (0-based) per copy.
E.g. ``[0, 1, 2, 3]`` for all 4 AMS Lite trays.
: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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| colors | No | ||
| copies | No | ||
| material | No | PLA | |
| ams_slots | No | ||
| model_path | Yes | ||
| printer_id | No | ||
| spacing_mm | No | ||
| slicer_path | No |