--load-assemble-list
<assemble_list.json>Assemble composed plates of instanced mesh objects from a JSON recipe that declares paths, copy counts, filament slots, per-copy positions, and merge groups, replacing the project 3MF as the sole geometry source and making each instance addressable by loaded ID for use with --skip-objects.
Details
Builds plates directly from raw STL/OBJ files described by a JSON recipe, with no project 3MF. The slicer loads each mesh, composes the objects, lays them out, and slices as if you had opened a project. The JSON is the sole geometry source.
The file is an object with a single plates array. Each plate has a plate_name, a need_arrange flag, an optional plate_params map of config overrides, and an objects array. Each object names a path (absolute), a count of copies, a 1-based filaments list, an assemble_index (0 = standalone, a shared positive value merges meshes into one composed object), optional pos_x/pos_y/pos_z offsets honored only when need_arrange is false, a subtype (normal_part, negative_part, modifier_part, support_enforcer, or support_blocker), and optional print_params or height_ranges overrides. Objects are added in list order, and each instance gets its loaded ID in that order, which is what --skip-objects references.
The full JSON schema, every field, every enum value, and the exact validation rules, is documented on its own page: see the assemble-list JSON reference linked below.
Examples
{
"plates": [
{
"plate_name": "Plate 1",
"need_arrange": false,
"objects": [
{ "path": "/abs/body.stl", "count": 2, "filaments": [1, 2], "pos_x": [60, 180], "pos_y": [120, 120] },
{ "path": "/abs/logo.stl", "count": 1, "filaments": [3], "assemble_index": [1] }
]
}
]
}Watch out for
- ▲ Array fields (`filaments`, `assemble_index`, each `pos_*`) must be length `count` (one per copy) or length 1 (broadcast to all copies); `count` must be greater than zero.
- ▲ Objects sharing a positive `assemble_index` merge into one object; modifier subtypes must carry a non-zero `assemble_index` so they attach to a host part.
- ▲ Do not pass positional model files alongside `--load-assemble-list`; the JSON is the only geometry source and combining them aborts the run. OBJ files self-color into filament slots, so `filaments` is ignored for them.
Related flags
Sign up for free today
No credit card required. Connect unlimited printers and get production automation running in minutes.