bambu-printer-mcp 1.1.8 → 1.1.9

package/CONTRIBUTORS.md

@@ -6,6 +6,7 @@ Thank you to everyone who builds, tests, reports problems, and shares real print
 
 | Contributor | Contribution |
 | --- | --- |
+| [Sebastian (sebas1986)](https://github.com/sebas1986) | Isolates the multi-filament CLI crash with real BambuStudio bisection, contributes per-slot colours and multi-nozzle prime-tower placement, and verifies X2D identification, status, and slicing in [#18](https://github.com/DMontgomery40/bambu-printer-mcp/pull/18). Direct X2D printing remains deferred pending the native transport. |
 | [Stenslaen](https://github.com/Stenslaen) | Traces the delayed H2 crash to OTA model detection, documents a multi-day workaround, and reports unexpected state-transition crashes in [#7](https://github.com/DMontgomery40/bambu-printer-mcp/issues/7). |
 | [Alejandro Oñate (alexol91)](https://github.com/alexol91) | Reports the missing machine-template G-code and multi-filament override problems in [#12](https://github.com/DMontgomery40/bambu-printer-mcp/issues/12), with measured output and a proposed fix in [#13](https://github.com/DMontgomery40/bambu-printer-mcp/pull/13). |
 | [var-poro](https://github.com/var-poro) | Supplies P2S firmware/MQTT evidence and regression tests in [#15](https://github.com/DMontgomery40/bambu-printer-mcp/pull/15), plus profile-template resolution and inheritance tests in [#16](https://github.com/DMontgomery40/bambu-printer-mcp/pull/16). |

package/README.md

@@ -106,9 +106,10 @@ This fork adds a substantial set of printer control tools beyond the upstream `m
 - Get detailed printer status: temperatures (nozzle, bed, chamber), print progress, current layer, time remaining, and live AMS slot data
 - Query live AMS inventory with resolved Bambu/Orca filament profile paths via `get_printer_filaments`. Includes per-tray display names, match confidence (`high`/`medium`/`low`/`none`), resolution tier (`exact-model-nozzle`/`model`/`generic`/`unresolved`), and a summary with recommended auto-slice filament. Retries automatically when AMS data hasn't arrived yet (common on first MQTT push from idle printers).
 - List, upload, and delete files on the printer's SD card via FTPS
-- Capture a JPEG snapshot from the chamber camera. Supports A1, A1 mini, P1S, P1P (TCP-on-6000), and X1, X1C, X1E, P2S, H2, H2S, H2D, H2C, H2D Pro (RTSP via ffmpeg). Requires ffmpeg in PATH for the RTSP path.
+- Capture a JPEG snapshot from the chamber camera. Supports A1, A1 mini, P1S, P1P (TCP-on-6000), and X1, X1C, X1E, P2S, H2, H2S, H2D, H2C, H2D Pro, X2D (RTSP via ffmpeg). Requires ffmpeg in PATH for the RTSP path.
 - Upload and print pre-sliced `.gcode.3mf` files with full plate selection and calibration flag control (recommended path — see [docs/SLICING.md](./docs/SLICING.md))
-- Optional single-color auto-slice path via BambuStudio CLI. BBL profile inheritance and include templates resolve automatically before slicing; missing dependencies stop the slice. Standalone custom configurations remain supported. H2C requires a compatible installed Bambu Studio profile tree and `BAMBU_MODEL=h2c`. The previously documented H2D multi-color CLI limitation remains; use a GUI-sliced `.gcode.3mf` for that workflow. See [docs/SLICING.md](./docs/SLICING.md).
+- Slice through BambuStudio CLI with automatic BBL inheritance/include resolution, per-slot filament colours, and fallback prime-tower placement for multi-nozzle printers. Missing dependencies stop the slice; custom settings and saved project tower positions are preserved. Multi-colour slicing is verified by the contributor on BambuStudio 02.08.02.60 for Windows; older CLI versions have separate limitations. See [docs/SLICING.md](./docs/SLICING.md).
+- Recognize X2D status and slice with its own installed BambuStudio preset (`BAMBU_MODEL=x2d`). **Direct X2D printing is not supported yet**: the internal eMMC transport is pending. These print requests stop before slicing, uploading, or issuing printer commands. Print exported projects through a supported slicer instead.
 - Parse AMS mapping from the 3MF's embedded slicer metadata (`Metadata/plate_<n>.json` + gcode filament header) and send it correctly formatted per the OpenBambuAPI spec, with correct H2S/H2D/H2C `ams_mapping2` parallel array format
 - **Auto-match AMS slots by RFID** (`auto_match_ams` flag on `print_3mf`). Resolves required `tray_info_idx` from the sliced 3MF against live AMS inventory. Handles same-SKU different-color filaments by matching on `(tray_info_idx, tray_color)` and tracking already-claimed slots. Dry-run with `resolve_3mf_ams_slots` before printing.
 - Cancel, pause, and resume in-progress print jobs via MQTT
@@ -186,7 +187,7 @@ BAMBU_TOKEN=your_access_token     # LAN access token from printer touchscreen
 # BAMBU_PRINTER_HOST / BAMBU_PRINTER_SERIAL / BAMBU_PRINTER_ACCESS_TOKEN
 
 # --- Printer model (CRITICAL for safe operation) ---
-BAMBU_MODEL=p1s                   # Your printer model: p1s, p1p, p2s, x1c, x1e, a1, a1mini, h2d, h2s, h2c
+BAMBU_MODEL=p1s                   # Your printer model: p1s, p1p, p2s, x1c, x1e, a1, a1mini, h2d, h2s, h2c, x2d
 # Alias also accepted: BAMBU_PRINTER_MODEL
 BED_TYPE=textured_plate           # Bed plate type: textured_plate, cool_plate, engineering_plate, hot_plate, supertack_plate
 NOZZLE_DIAMETER=0.4               # Nozzle diameter in mm (default: 0.4)
@@ -227,7 +228,7 @@ BLENDER_MCP_TIMEOUT_MS=120000
 | `PRINTER_HOST` | `localhost` | Yes | IP address of the Bambu printer. Alias: `BAMBU_PRINTER_HOST` |
 | `BAMBU_SERIAL` | | Yes | Printer serial number. Alias: `BAMBU_PRINTER_SERIAL` |
 | `BAMBU_TOKEN` | | Yes | LAN access token. Alias: `BAMBU_PRINTER_ACCESS_TOKEN` |
-| `BAMBU_MODEL` | | **Yes** | Printer model: `p1s`, `p1p`, `p2s`, `x1c`, `x1e`, `a1`, `a1mini`, `h2d`, `h2s`, `h2c`. **Required for safe operation** -- determines the correct G-code generation. Alias: `BAMBU_PRINTER_MODEL`. If omitted and the MCP client supports elicitation, the server will ask you interactively. Use `h2c` for H2C; do not use `h2d` as a fallback. |
+| `BAMBU_MODEL` | | **Yes** | Printer model: `p1s`, `p1p`, `p2s`, `x1c`, `x1e`, `a1`, `a1mini`, `h2d`, `h2s`, `h2c`, `x2d`. **Required for safe operation** -- determines the correct G-code generation. Alias: `BAMBU_PRINTER_MODEL`. If omitted and the MCP client supports elicitation, the server will ask you interactively. Use `h2c` for H2C and `x2d` for X2D; do not use `h2d` as a fallback. |
 | `BED_TYPE` | `textured_plate` | No | Bed plate type: `textured_plate`, `cool_plate`, `engineering_plate`, `hot_plate`, `supertack_plate` |
 | `NOZZLE_DIAMETER` | `0.4` | No | Nozzle diameter in mm. Used to select the correct BambuStudio machine preset. |
 | `SLICER_TYPE` | `bambustudio` | No | Slicer to use for slicing operations |
@@ -1246,6 +1247,7 @@ When `slicer_type` is `bambustudio` (the default), these additional parameters a
 | `skip_objects` | string | Object indices to skip, comma-separated (e.g. `"3,5,10"`) |
 | `load_filaments` | string | Filament profile paths, semicolon-separated |
 | `load_filament_ids` | string | Filament-to-object mapping, comma-separated |
+| `filament_colours` | string | Slot colours, one `#RRGGBB` per filament slot, semicolon-separated. Explicit values take priority, followed by input 3MF colours, each custom profile's colour, then the BambuStudio default. |
 | `enable_timelapse` | boolean | Enable timelapse-aware slicing |
 | `allow_mix_temp` | boolean | Allow mixed-temperature filaments on one plate |
 | `scale` | number | Uniform scale factor |

package/dist/index.js

@@ -14,7 +14,7 @@ import { BambuNetworkBridge } from "./bambu-network-bridge.js";
 import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
-import { BambuImplementation } from "./printers/bambu.js";
+import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 dotenv.config();
 const DEFAULT_HOST = process.env.BAMBU_PRINTER_HOST || process.env.PRINTER_HOST || "localhost";
 const DEFAULT_BAMBU_SERIAL = process.env.BAMBU_PRINTER_SERIAL || process.env.BAMBU_SERIAL || "";
@@ -44,7 +44,7 @@ const DEFAULT_BAMBU_MODEL = process.env.BAMBU_PRINTER_MODEL?.trim().toLowerCase(
     "";
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
-const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c"];
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"];
 const H2_BAMBU_MODELS = new Set(["h2d", "h2s", "h2c"]);
 const VALID_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate", "supertack_plate"];
 const VALID_BAMBUSTUDIO_CLI_BED_TYPES = ["textured_plate", "cool_plate", "engineering_plate", "hot_plate"];
@@ -60,6 +60,7 @@ const BAMBU_MODEL_PRESETS = {
     h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
     h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
     h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
+    x2d: (n) => `Bambu Lab X2D ${n} nozzle`,
 };
 const FILAMENT_PROFILE_DIR = "/Applications/BambuStudio.app/Contents/Resources/profiles/BBL/filament";
 const FILAMENT_MODEL_CODES = {
@@ -73,6 +74,7 @@ const FILAMENT_MODEL_CODES = {
     h2d: "H2D",
     h2s: "H2S",
     h2c: "H2C",
+    x2d: "X2D",
 };
 const COLLAR_CHARM_POLICY = getCollarCharmRolePolicy();
 let filamentProfileIndexCache = null;
@@ -371,6 +373,19 @@ function extractPrinterDiagnostics(status) {
         diagnostic_fields: diagnosticFields,
     };
 }
+/** Parse "#RRGGBB;#RRGGBB" (leading '#' optional) into positional slot colours. */
+function parseFilamentColours(value) {
+    const colours = value.split(";").map((c) => c.trim()).filter(Boolean)
+        .map((c) => (c.startsWith("#") ? c : `#${c}`).toUpperCase());
+    for (const c of colours) {
+        if (!/^#[0-9A-F]{6}([0-9A-F]{2})?$/.test(c)) {
+            throw new Error(`Invalid filament colour "${c}"; expected #RRGGBB.`);
+        }
+    }
+    if (colours.length === 0)
+        throw new Error("filament_colours must list at least one colour.");
+    return colours;
+}
 function validateBambuModel(model) {
     const normalized = model.trim().toLowerCase();
     if (!VALID_BAMBU_MODELS.includes(normalized)) {
@@ -822,6 +837,7 @@ class BambuPrinterMCPServer {
                                 { const: "h2d", title: "H2D" },
                                 { const: "h2s", title: "H2S" },
                                 { const: "h2c", title: "H2C" },
+                                { const: "x2d", title: "X2D" },
                             ],
                         },
                     },
@@ -1549,6 +1565,7 @@ class BambuPrinterMCPServer {
                                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
                                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs." },
                                 load_filament_ids: { type: "string", description: "Optional filament-to-object mapping string." },
+                                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                                 ensure_on_bed: { type: "boolean", description: "Lift floating models onto the bed." },
                                 arrange: { type: "boolean", description: "Auto-arrange objects on the build plate." },
                                 orient: { type: "boolean", description: "Auto-orient model for optimal printability." },
@@ -1603,6 +1620,7 @@ class BambuPrinterMCPServer {
                                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
                                 filament_profile: { type: "string", description: "Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths." },
                                 load_filament_ids: { type: "string", description: "Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3." },
+                                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                                 enable_timelapse: { type: "boolean", description: "Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time." },
                                 allow_mix_temp: { type: "boolean", description: "Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG." },
                                 scale: { type: "number", description: "Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing." },
@@ -2107,7 +2125,7 @@ class BambuPrinterMCPServer {
                                 bambu_model: {
                                     type: "string",
                                     enum: [...VALID_BAMBU_MODELS],
-                                    description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
+                                    description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths. X2D direct printing is not supported."
                                 },
                                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -2343,23 +2361,27 @@ class BambuPrinterMCPServer {
                         }
                         break;
                     }
-                    case "upload_file":
+                    case "upload_file": {
                         if (!args?.file_path || !args?.filename) {
                             throw new Error("Missing required parameters: file_path and filename");
                         }
-                        if (Boolean(args.print ?? false)) {
-                            await this.resolveBambuModel(args?.bambu_model);
-                        }
-                        result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, String(args.file_path), String(args.filename), Boolean(args.print ?? false));
+                        const print = Boolean(args.print ?? false);
+                        const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model) : undefined;
+                        if (print)
+                            assertDirectPrintSupported(uploadModel, bambuSerial);
+                        result = await this.bambu.uploadFile(host, bambuSerial, bambuToken, String(args.file_path), String(args.filename), print, uploadModel);
                         break;
+                    }
                     case "start_print":
-                    case "start_print_job":
+                    case "start_print_job": {
                         if (!args?.filename) {
                             throw new Error("Missing required parameter: filename");
                         }
-                        await this.resolveBambuModel(args?.bambu_model);
-                        result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename));
+                        const startModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(startModel, bambuSerial);
+                        result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename), startModel);
                         break;
+                    }
                     case "cancel_print":
                         result = await this.bambu.cancelJob(host, bambuSerial, bambuToken);
                         break;
@@ -2499,6 +2521,8 @@ class BambuPrinterMCPServer {
                         }
                         if (args?.load_filament_ids !== undefined)
                             sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.filament_colours !== undefined)
+                            sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
@@ -2576,6 +2600,8 @@ class BambuPrinterMCPServer {
                         }
                         if (args?.load_filament_ids !== undefined)
                             sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.filament_colours !== undefined)
+                            sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
                         sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type);
                         if (args?.enable_timelapse !== undefined)
                             sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
@@ -2628,6 +2654,7 @@ class BambuPrinterMCPServer {
                         }
                         const { slicerType, slicerPath, slicerProfile } = this.resolveSlicerConfigFromArgs(args, "print_3mf");
                         const printModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(printModel, bambuSerial);
                         const printBedType = resolveBedType(args?.bed_type);
                         const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(args, slicerProfile || undefined, resolveTemplatePathFromName(["json", "config", "3mf"]) || explicitTemplatePath || undefined, TEMP_DIR);
@@ -2768,6 +2795,7 @@ class BambuPrinterMCPServer {
                         }
                         const { slicerType, slicerPath, slicerProfile } = this.resolveSlicerConfigFromArgs(args, "print_collar_charm");
                         const printModel = await this.resolveBambuModel(args?.bambu_model);
+                        assertDirectPrintSupported(printModel, bambuSerial);
                         const printBedType = resolveBedType(args?.bed_type);
                         const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(args, slicerProfile || undefined, resolvedTemplateSourcePath || explicitTemplatePath || undefined, TEMP_DIR);

package/dist/printers/bambu.d.ts

@@ -1,3 +1,4 @@
+export declare function assertDirectPrintSupported(model: string | undefined, serial?: string): void;
 interface BambuPrintOptionsInternal {
     projectName: string;
     filePath: string;
@@ -67,8 +68,8 @@ export declare class BambuImplementation {
         name: string;
         exists: boolean;
     }>;
-    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean): Promise<Record<string, unknown>>;
-    startJob(host: string, serial: string, token: string, filename: string): Promise<{
+    uploadFile(host: string, serial: string, token: string, filePath: string, filename: string, print: boolean, bambuModel?: string): Promise<Record<string, unknown>>;
+    startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string): Promise<{
         status: string;
         message: string;
         file: string;

package/dist/printers/bambu.js

@@ -37,6 +37,7 @@ const MODEL_ID_TO_NAME = {
     O1D: "H2D",
     O1E: "H2D Pro",
     O1S: "H2S",
+    N6: "X2D",
     N2S: "A1",
     A1M: "A1 Mini",
     C11: "P1P",
@@ -46,6 +47,12 @@ const MODEL_ID_TO_NAME = {
     C13: "X1E",
 };
 const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s"]);
+export function assertDirectPrintSupported(model, serial) {
+    if (model?.trim().toLowerCase() === "x2d" || serial?.trim().toUpperCase().startsWith("20P")) {
+        throw new Error("X2D direct printing is not supported pending native eMMC transport support. " +
+            "X2D status and slicing remain available; use a supported slicer to print.");
+    }
+}
 function isH2ModelName(model) {
     return H2_MODEL_NAMES.has(String(model ?? "").trim().toLowerCase().replace(/\s+/g, " "));
 }
@@ -95,6 +102,8 @@ class TolerantBambuClient extends BambuClient {
             return "H2C";
         if (sn.startsWith("31B"))
             return "H2DPRO";
+        if (sn.startsWith("20P"))
+            return "X2D";
         if (sn.startsWith("00M"))
             return "X1C";
         if (sn.startsWith("00W"))
@@ -457,6 +466,7 @@ export class BambuImplementation {
         }
     }
     async print3mf(host, serial, token, options) {
+        assertDirectPrintSupported(options.bambuModel, serial);
         if (!options.filePath.toLowerCase().endsWith(".3mf")) {
             throw new Error("print3mf requires a .3mf input file.");
         }
@@ -929,7 +939,9 @@ export class BambuImplementation {
             exists,
         };
     }
-    async uploadFile(host, serial, token, filePath, filename, print) {
+    async uploadFile(host, serial, token, filePath, filename, print, bambuModel) {
+        if (print)
+            assertDirectPrintSupported(bambuModel, serial);
         await fs.access(filePath);
         const normalizedFileName = filename.replace(/^\/+/, "");
         const remotePath = normalizedFileName.includes("/")
@@ -945,7 +957,7 @@ export class BambuImplementation {
         };
         if (print) {
             if (remotePath.toLowerCase().endsWith(".gcode")) {
-                response.startResult = await this.startJob(host, serial, token, remotePath);
+                response.startResult = await this.startJob(host, serial, token, remotePath, bambuModel);
             }
             else if (remotePath.toLowerCase().endsWith(".3mf")) {
                 response.note =
@@ -957,7 +969,8 @@ export class BambuImplementation {
         }
         return response;
     }
-    async startJob(host, serial, token, filename) {
+    async startJob(host, serial, token, filename, bambuModel) {
+        assertDirectPrintSupported(bambuModel, serial);
         const lower = filename.toLowerCase();
         if (lower.endsWith(".3mf") && !lower.endsWith(".gcode.3mf")) {
             throw new Error("Use print_3mf for .3mf project files.");
@@ -1007,7 +1020,7 @@ export class BambuImplementation {
         // P1/A1 series still use the proprietary TCP-on-6000 framed JPEG path
         // (per https://github.com/Doridian/OpenBambuAPI/blob/main/video.md).
         const TCP_CAMERA_MODELS = new Set(["a1", "a1mini", "p1s", "p1p"]);
-        // X1, P2S, AND H2 (H2S/H2D/H2C) all use RTSP on port 322. The
+        // X1, P2S, H2 (H2S/H2D/H2C), AND X2D all use RTSP on port 322. The
         // OpenBambuAPI doc only mentions X1/P2S, but the HA bambulab
         // integration's models.py shows the printer reports its own
         // `ipcam.rtsp_url` for these models, and Parker (H2S) rejects the
@@ -1015,7 +1028,7 @@ export class BambuImplementation {
         // confirmed by local H2 camera transport probes).
         const RTSP_MODELS = new Set([
             "x1", "x1c", "x1carbon", "x1e", "p2s",
-            "h2", "h2s", "h2d", "h2c", "h2dpro",
+            "h2", "h2s", "h2d", "h2c", "h2dpro", "x2d",
         ]);
         if (!model) {
             throw new Error("camera_snapshot requires bambu_model or BAMBU_MODEL so it can choose the correct Bambu camera protocol.");

package/dist/slicer/profile-flatten.d.ts

@@ -70,7 +70,21 @@ export interface FlattenOptions {
         process?: Record<string, unknown>;
         filaments?: (Record<string, unknown> | undefined)[];
     };
+    /**
+     * Positional `#RRGGBB` colour per filament slot (e.g. from the input 3MF
+     * project or the caller). Missing entries keep the profile's own colour or
+     * fall back to DEFAULT_FILAMENT_COLOUR.
+     */
+    filamentColours?: (string | undefined)[];
+    /** Saved per-plate positions, used only when the process sets no position. */
+    projectTowerPosition?: {
+        wipe_tower_x?: unknown;
+        wipe_tower_y?: unknown;
+    };
 }
+/** Best-effort extruder count for fallback nozzle_volume_type sizing. */
+/** BambuStudio's built-in filament_colour default. */
+export declare const DEFAULT_FILAMENT_COLOUR = "#00AE42";
 /**
  * Flatten the leaf profiles, post-process for CLI, and write to temp files.
  *

package/dist/slicer/profile-flatten.js

@@ -219,6 +219,86 @@ function enforceMatchingNozzles(arr) {
     }
 }
 /** Best-effort extruder count for fallback nozzle_volume_type sizing. */
+/** BambuStudio's built-in filament_colour default. */
+export const DEFAULT_FILAMENT_COLOUR = "#00AE42";
+const FILAMENT_COLOUR_RE = /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/;
+/**
+ * No BBL filament profile defines `filament_colour`; the GUI fills it from
+ * the AMS. Without it the CLI keeps a single-entry colour vector however many
+ * filaments are loaded and crashes (access violation) as soon as a slice uses
+ * any filament after the first. Give every slot exactly one colour.
+ */
+function ensureFilamentColour(flat, colour) {
+    if (colour !== undefined) {
+        if (!FILAMENT_COLOUR_RE.test(colour)) {
+            throw new Error(`Invalid filament colour "${colour}"; expected #RRGGBB.`);
+        }
+        flat["filament_colour"] = [colour];
+        return;
+    }
+    const own = flat["filament_colour"];
+    if (Array.isArray(own) && typeof own[0] === "string" && FILAMENT_COLOUR_RE.test(own[0])) {
+        flat["filament_colour"] = [own[0]];
+        return;
+    }
+    flat["filament_colour"] = [DEFAULT_FILAMENT_COLOUR];
+}
+// BambuStudio's defaults when a process sets no prime tower position/width.
+const DEFAULT_WIPE_TOWER_X = 15;
+const DEFAULT_WIPE_TOWER_Y = 220;
+const DEFAULT_PRIME_TOWER_WIDTH = 35;
+// Clearance inside the shared nozzle area for the auto-sized tower brim and
+// the CLI's own safety margin (X2D fails at 5 mm from the edge, passes at 6).
+const WIPE_TOWER_MARGIN = 15;
+function parseArea(area) {
+    const points = area.split(",").map((p) => p.trim().split("x").map(Number));
+    if (points.length < 3 || points.some((p) => p.length !== 2 || p.some((n) => !Number.isFinite(n)))) {
+        throw new Error(`Malformed extruder_printable_area entry "${area}".`);
+    }
+    const xs = points.map((p) => p[0]);
+    const ys = points.map((p) => p[1]);
+    return { minX: Math.min(...xs), maxX: Math.max(...xs), minY: Math.min(...ys), maxY: Math.max(...ys) };
+}
+/**
+ * On multi-nozzle machines (H2D, X2D) each nozzle reaches only part of the
+ * bed (`extruder_printable_area`), and the prime tower must be reachable by
+ * every nozzle. The CLI's default tower position (x=15) lies outside the
+ * X2D/H2D right-nozzle area, so slicing fails with "G-code outside of the
+ * printable area". When the process sets no position and the default does
+ * not fit, move the tower inside the area all nozzles share.
+ */
+function placePrimeTowerForAllNozzles(machineFlat, processFlat) {
+    if (processFlat["wipe_tower_x"] !== undefined || processFlat["wipe_tower_y"] !== undefined)
+        return;
+    if (["0", "false"].includes(String(processFlat["enable_prime_tower"]).toLowerCase()))
+        return;
+    const areas = machineFlat["extruder_printable_area"];
+    if (!Array.isArray(areas) || areas.length < 2)
+        return;
+    const rects = areas.map((a) => {
+        if (typeof a !== "string")
+            throw new Error("Malformed extruder_printable_area in machine profile.");
+        return parseArea(a);
+    });
+    const shared = {
+        minX: Math.max(...rects.map((r) => r.minX)) + WIPE_TOWER_MARGIN,
+        maxX: Math.min(...rects.map((r) => r.maxX)) - WIPE_TOWER_MARGIN,
+        minY: Math.max(...rects.map((r) => r.minY)) + WIPE_TOWER_MARGIN,
+        maxY: Math.min(...rects.map((r) => r.maxY)) - WIPE_TOWER_MARGIN,
+    };
+    const width = Number(processFlat["prime_tower_width"] ?? DEFAULT_PRIME_TOWER_WIDTH);
+    const size = Number.isFinite(width) && width > 0 ? width : DEFAULT_PRIME_TOWER_WIDTH;
+    if (shared.maxX - shared.minX < size || shared.maxY - shared.minY < size) {
+        throw new Error("No bed area is reachable by every nozzle for the prime tower.");
+    }
+    const clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+    const x = clamp(DEFAULT_WIPE_TOWER_X, shared.minX, shared.maxX - size);
+    const y = clamp(DEFAULT_WIPE_TOWER_Y, shared.minY, shared.maxY - size);
+    if (x === DEFAULT_WIPE_TOWER_X && y === DEFAULT_WIPE_TOWER_Y)
+        return;
+    processFlat["wipe_tower_x"] = [String(x)];
+    processFlat["wipe_tower_y"] = [String(y)];
+}
 function inferExtruderCount(flat) {
     for (const key of ["nozzle_diameter", "extruder_type", "extruder_variant_list"]) {
         const v = flat[key];
@@ -466,7 +546,15 @@ export async function flattenForCli(opts) {
     normalizeForCli(machineFlat, "machine", opts.machineLeaf);
     normalizeForCli(processFlat, "process", opts.processLeaf);
     filamentFlats.forEach((f, i) => normalizeForCli(f, "filament", opts.filamentLeaves[i]));
+    if (opts.filamentColours && opts.filamentColours.length !== filamentFlats.length) {
+        throw new Error(`${opts.filamentColours.length} filament colours were supplied for ${filamentFlats.length} filament slots.`);
+    }
+    filamentFlats.forEach((f, i) => ensureFilamentColour(f, opts.filamentColours?.[i]));
     applyBedType(processFlat, opts.bedType);
+    if (processFlat["wipe_tower_x"] === undefined && processFlat["wipe_tower_y"] === undefined) {
+        Object.assign(processFlat, opts.projectTowerPosition);
+    }
+    placePrimeTowerForAllNozzles(machineFlat, processFlat);
     // Mirror the GUI's auto-extend behavior: when the caller explicitly
     // chose a process or filament that wasn't pre-declared compatible with
     // the chosen machine (e.g. "0.20mm Standard @BBL P1P" used on a P1S),

package/dist/stl/stl-manipulator.d.ts

@@ -36,6 +36,7 @@ export interface BambuSliceOptions {
     skipObjects?: string;
     loadFilaments?: string;
     loadFilamentIds?: string;
+    filamentColours?: string[];
     bedType?: string;
     enableTimelapse?: boolean;
     allowMixTemp?: boolean;

package/dist/stl/stl-manipulator.js

@@ -382,20 +382,32 @@ export class STLManipulator extends EventEmitter {
             profilesRoot,
             tempDir: this.tempDir,
             bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
+            filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
+            projectTowerPosition: bundle.projectTowerPosition,
             sourceProfiles: {
                 machine: isBundledFile(machinePath) ? undefined : machine,
                 process: isBundledFile(processPath) ? undefined : processProfile,
                 filaments: filaments.map((profile, i) => isBundledFile(bundle.filamentPaths[i]) ? undefined : profile),
             },
         });
-        // Standalone custom files have no BBL dependencies; preserve their identity
-        // and content. Other profiles retain user values through sourceProfiles.
+        // Standalone files retain their own identity and settings, but still need
+        // the CLI colour/tower fields. Do not discard those required overlays when
+        // choosing the original profile instead of the normalized BBL output.
+        const withCliFields = (filePath, profile, flatPath, keys) => {
+            const flattened = readProfile(flatPath);
+            const fields = Object.fromEntries(keys.filter(key => flattened[key] !== undefined).map(key => [key, flattened[key]]));
+            if (Object.entries(fields).every(([key, value]) => JSON.stringify(profile[key]) === JSON.stringify(value)))
+                return filePath;
+            return this.writeTempJson(path.basename(filePath, '.json'), 'cli', { ...profile, ...fields });
+        };
         return {
             settingsArg: [
                 needsResolution(machinePath, machine) ? flat.machinePath : machinePath,
-                needsResolution(processPath, processProfile) ? flat.processPath : processPath,
+                needsResolution(processPath, processProfile) ? flat.processPath
+                    : withCliFields(processPath, processProfile, flat.processPath, ['wipe_tower_x', 'wipe_tower_y']),
             ].join(';'),
-            filamentPaths: filaments.map((profile, i) => needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i] : bundle.filamentPaths[i]),
+            filamentPaths: filaments.map((profile, i) => needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i]
+                : withCliFields(bundle.filamentPaths[i], profile, flat.filamentPaths[i], ['filament_colour'])),
         };
     }
     /** --load-filaments is positional; a single override must cover every project slot. */
@@ -417,13 +429,20 @@ export class STLManipulator extends EventEmitter {
             .map(key => Array.isArray(data[key]) ? data[key].length : 0));
         if (count === 0)
             throw new Error('Cannot determine project filament slots from project_settings.config.');
+        // Keep the project's slot colours; loaded profiles carry none of their own.
+        const colours = Array.isArray(data.filament_colour) && data.filament_colour.length === count &&
+            data.filament_colour.every(c => typeof c === 'string' && /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/.test(c))
+            ? data.filament_colour
+            : undefined;
+        const projectTowerPosition = Object.fromEntries(['wipe_tower_x', 'wipe_tower_y']
+            .filter(key => data[key] !== undefined).map(key => [key, data[key]]));
         if (bundle.filamentPaths.length === 1) {
-            return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]) };
+            return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]), filamentColours: colours, projectTowerPosition };
         }
         if (bundle.filamentPaths.length !== count) {
             throw new Error(`Project declares ${count} filament slots, but ${bundle.filamentPaths.length} profiles were supplied. Provide one profile for all slots or one per slot.`);
         }
-        return bundle;
+        return { ...bundle, filamentColours: colours, projectTowerPosition };
     }
     resolveBambuStudioBedType(bedType) {
         if (!bedType)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "description": "MCP server for Bambu Lab 3D printers with STL manipulation, slicing, and print management",
   "main": "dist/index.js",
   "repository": {

package/src/index.ts

@@ -29,7 +29,7 @@ import { BlenderMcpBridge } from "./blender-mcp-bridge.js";
 import { hasAmsMappingInput, normalizeAmsMappingObject, normalizeBridgeAmsTrayValue } from "./ams-mapping.js";
 import { analyze3MFAmsRequirements, analyze3MFPlateObjects, analyzeCollarCharm3MF, extractBambuTemplateSettings, getCollarCharmRolePolicy, parse3MF } from './3mf_parser.js';
 import type { ThreeMFAmsRequirements } from "./types.js";
-import { BambuImplementation } from "./printers/bambu.js";
+import { BambuImplementation, assertDirectPrintSupported } from "./printers/bambu.js";
 
 dotenv.config();
 
@@ -64,7 +64,7 @@ const DEFAULT_BAMBU_MODEL =
 const DEFAULT_BED_TYPE = process.env.BED_TYPE?.trim().toLowerCase() || "textured_plate";
 const DEFAULT_NOZZLE_DIAMETER = process.env.NOZZLE_DIAMETER?.trim() || "0.4";
 
-const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c"] as const;
+const VALID_BAMBU_MODELS = ["p1s", "p1p", "p2s", "x1c", "x1e", "a1", "a1mini", "h2d", "h2s", "h2c", "x2d"] as const;
 type BambuModel = typeof VALID_BAMBU_MODELS[number];
 const H2_BAMBU_MODELS = new Set<string>(["h2d", "h2s", "h2c"]);
 
@@ -83,6 +83,7 @@ const BAMBU_MODEL_PRESETS: Record<string, (nozzle: string) => string> = {
   h2d: (n) => `Bambu Lab H2D ${n} nozzle`,
   h2s: (n) => `Bambu Lab H2S ${n} nozzle`,
   h2c: (n) => `Bambu Lab H2C ${n} nozzle`,
+  x2d: (n) => `Bambu Lab X2D ${n} nozzle`,
 };
 
 const FILAMENT_PROFILE_DIR =
@@ -98,6 +99,7 @@ const FILAMENT_MODEL_CODES: Record<string, string> = {
   h2d: "H2D",
   h2s: "H2S",
   h2c: "H2C",
+  x2d: "X2D",
 };
 
 type FilamentProfileIndex = {
@@ -516,6 +518,19 @@ function extractPrinterDiagnostics(status: any): Record<string, unknown> {
   };
 }
 
+/** Parse "#RRGGBB;#RRGGBB" (leading '#' optional) into positional slot colours. */
+function parseFilamentColours(value: string): string[] {
+  const colours = value.split(";").map((c) => c.trim()).filter(Boolean)
+    .map((c) => (c.startsWith("#") ? c : `#${c}`).toUpperCase());
+  for (const c of colours) {
+    if (!/^#[0-9A-F]{6}([0-9A-F]{2})?$/.test(c)) {
+      throw new Error(`Invalid filament colour "${c}"; expected #RRGGBB.`);
+    }
+  }
+  if (colours.length === 0) throw new Error("filament_colours must list at least one colour.");
+  return colours;
+}
+
 function validateBambuModel(model: string): string {
   const normalized = model.trim().toLowerCase();
   if (!VALID_BAMBU_MODELS.includes(normalized as BambuModel)) {
@@ -1108,6 +1123,7 @@ class BambuPrinterMCPServer {
                 { const: "h2d", title: "H2D" },
                 { const: "h2s", title: "H2S" },
                 { const: "h2c", title: "H2C" },
+                { const: "x2d", title: "X2D" },
               ],
             },
           },
@@ -2045,6 +2061,7 @@ class BambuPrinterMCPServer {
                 bambu_token: { type: "string", description: "Access token (default: value from env)" },
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs." },
                 load_filament_ids: { type: "string", description: "Optional filament-to-object mapping string." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 ensure_on_bed: { type: "boolean", description: "Lift floating models onto the bed." },
                 arrange: { type: "boolean", description: "Auto-arrange objects on the build plate." },
                 orient: { type: "boolean", description: "Auto-orient model for optimal printability." },
@@ -2099,6 +2116,7 @@ class BambuPrinterMCPServer {
                 load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
                 filament_profile: { type: "string", description: "Compatibility alias for load_filaments. Semicolon-separated Orca/Bambu filament profile JSON paths." },
                 load_filament_ids: { type: "string", description: "Map filaments to objects/parts. Comma-separated IDs matching load_filaments order, e.g. '1,2,3,1' assigns filament 1 to objects 0 and 3." },
+                filament_colours: { type: "string", description: "Optional slot colours, one #RRGGBB per filament slot in order, separated by ';' (e.g. '#161616;#FFFFFF'). Defaults to the input 3MF's project colours, else the BambuStudio default." },
                 enable_timelapse: { type: "boolean", description: "Insert timelapse parking moves into gcode. The toolhead parks at a fixed position each layer for camera capture. Adds ~10% print time." },
                 allow_mix_temp: { type: "boolean", description: "Allow filaments with different temperature requirements on the same plate. Required for multi-material prints mixing e.g. PLA and PETG." },
                 scale: { type: "number", description: "Uniform scale factor applied to all axes. 1.0 = original size, 2.0 = double, 0.5 = half. Applied before slicing." },
@@ -2603,7 +2621,7 @@ class BambuPrinterMCPServer {
                 bambu_model: {
                   type: "string",
                   enum: [...VALID_BAMBU_MODELS],
-                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths."
+                  description: "REQUIRED: Bambu Lab printer model. H2D, H2S, and H2C are the primary intended paths. X2D direct printing is not supported."
                 },
                 host: { type: "string", description: "Hostname or IP of the printer (default: value from env)" },
                 bambu_serial: { type: "string", description: "Serial number (default: value from env)" },
@@ -2895,28 +2913,31 @@ class BambuPrinterMCPServer {
             break;
           }
 
-          case "upload_file":
+          case "upload_file": {
             if (!args?.file_path || !args?.filename) {
               throw new Error("Missing required parameters: file_path and filename");
             }
-            if (Boolean(args.print ?? false)) {
-              await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            }
+            const print = Boolean(args.print ?? false);
+            const uploadModel = print ? await this.resolveBambuModel(args?.bambu_model as string | undefined) : undefined;
+            if (print) assertDirectPrintSupported(uploadModel, bambuSerial);
             result = await this.bambu.uploadFile(
               host, bambuSerial, bambuToken,
               String(args.file_path), String(args.filename),
-              Boolean(args.print ?? false)
+              print, uploadModel
             );
             break;
+          }
 
           case "start_print":
-          case "start_print_job":
+          case "start_print_job": {
             if (!args?.filename) {
               throw new Error("Missing required parameter: filename");
             }
-            await this.resolveBambuModel(args?.bambu_model as string | undefined);
-            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename));
+            const startModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(startModel, bambuSerial);
+            result = await this.bambu.startJob(host, bambuSerial, bambuToken, String(args.filename), startModel);
             break;
+          }
 
           case "cancel_print":
             result = await this.bambu.cancelJob(host, bambuSerial, bambuToken);
@@ -3118,6 +3139,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3203,6 +3225,7 @@ class BambuPrinterMCPServer {
               sliceBambuOptions.loadFilaments = String(args.filament_profile);
             }
             if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.filament_colours !== undefined) sliceBambuOptions.filamentColours = parseFilamentColours(String(args.filament_colours));
             sliceBambuOptions.bedType = resolveBambuStudioCliBedType(args?.bed_type as string | undefined);
             if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
             if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
@@ -3265,6 +3288,7 @@ class BambuPrinterMCPServer {
               "print_3mf"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(
@@ -3450,6 +3474,7 @@ class BambuPrinterMCPServer {
               "print_collar_charm"
             );
             const printModel = await this.resolveBambuModel(args?.bambu_model as string | undefined);
+            assertDirectPrintSupported(printModel, bambuSerial);
             const printBedType = resolveBedType(args?.bed_type as string | undefined);
             const printNozzle = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             const activeSlicerProfile = await resolveTemplateFirstSlicerProfilePath(

package/src/printers/bambu.ts

@@ -47,6 +47,7 @@ const MODEL_ID_TO_NAME: Record<string, string> = {
   O1D: "H2D",
   O1E: "H2D Pro",
   O1S: "H2S",
+  N6: "X2D",
   N2S: "A1",
   A1M: "A1 Mini",
   C11: "P1P",
@@ -58,6 +59,15 @@ const MODEL_ID_TO_NAME: Record<string, string> = {
 
 const H2_MODEL_NAMES = new Set(["h2", "h2c", "h2d", "h2dpro", "h2d pro", "h2s"]);
 
+export function assertDirectPrintSupported(model: string | undefined, serial?: string): void {
+  if (model?.trim().toLowerCase() === "x2d" || serial?.trim().toUpperCase().startsWith("20P")) {
+    throw new Error(
+      "X2D direct printing is not supported pending native eMMC transport support. " +
+      "X2D status and slicing remain available; use a supported slicer to print."
+    );
+  }
+}
+
 function isH2ModelName(model: unknown): boolean {
   return H2_MODEL_NAMES.has(String(model ?? "").trim().toLowerCase().replace(/\s+/g, " "));
 }
@@ -151,6 +161,7 @@ class TolerantBambuClient extends BambuClient {
     if (sn.startsWith("094")) return "H2D";
     if (sn.startsWith("239")) return "H2C";
     if (sn.startsWith("31B")) return "H2DPRO";
+    if (sn.startsWith("20P")) return "X2D";
     if (sn.startsWith("00M")) return "X1C";
     if (sn.startsWith("00W")) return "X1";
     if (sn.startsWith("03W")) return "X1E";
@@ -568,6 +579,7 @@ export class BambuImplementation {
     token: string,
     options: BambuPrintOptionsInternal
   ): Promise<any> {
+    assertDirectPrintSupported(options.bambuModel, serial);
     if (!options.filePath.toLowerCase().endsWith(".3mf")) {
       throw new Error("print3mf requires a .3mf input file.");
     }
@@ -1159,8 +1171,10 @@ export class BambuImplementation {
     token: string,
     filePath: string,
     filename: string,
-    print: boolean
+    print: boolean,
+    bambuModel?: string
   ) {
+    if (print) assertDirectPrintSupported(bambuModel, serial);
     await fs.access(filePath);
 
     const normalizedFileName = filename.replace(/^\/+/, "");
@@ -1180,7 +1194,7 @@ export class BambuImplementation {
 
     if (print) {
       if (remotePath.toLowerCase().endsWith(".gcode")) {
-        response.startResult = await this.startJob(host, serial, token, remotePath);
+        response.startResult = await this.startJob(host, serial, token, remotePath, bambuModel);
       } else if (remotePath.toLowerCase().endsWith(".3mf")) {
         response.note =
           "3MF upload complete. Use print_3mf to start a project print with plate and metadata options.";
@@ -1194,7 +1208,8 @@ export class BambuImplementation {
     return response;
   }
 
-  async startJob(host: string, serial: string, token: string, filename: string) {
+  async startJob(host: string, serial: string, token: string, filename: string, bambuModel?: string) {
+    assertDirectPrintSupported(bambuModel, serial);
     const lower = filename.toLowerCase();
     if (lower.endsWith(".3mf") && !lower.endsWith(".gcode.3mf")) {
       throw new Error("Use print_3mf for .3mf project files.");
@@ -1281,7 +1296,7 @@ export class BambuImplementation {
     // P1/A1 series still use the proprietary TCP-on-6000 framed JPEG path
     // (per https://github.com/Doridian/OpenBambuAPI/blob/main/video.md).
     const TCP_CAMERA_MODELS = new Set(["a1", "a1mini", "p1s", "p1p"]);
-    // X1, P2S, AND H2 (H2S/H2D/H2C) all use RTSP on port 322. The
+    // X1, P2S, H2 (H2S/H2D/H2C), AND X2D all use RTSP on port 322. The
     // OpenBambuAPI doc only mentions X1/P2S, but the HA bambulab
     // integration's models.py shows the printer reports its own
     // `ipcam.rtsp_url` for these models, and Parker (H2S) rejects the
@@ -1289,7 +1304,7 @@ export class BambuImplementation {
     // confirmed by local H2 camera transport probes).
     const RTSP_MODELS = new Set([
       "x1", "x1c", "x1carbon", "x1e", "p2s",
-      "h2", "h2s", "h2d", "h2c", "h2dpro",
+      "h2", "h2s", "h2d", "h2c", "h2dpro", "x2d",
     ]);
 
     if (!model) {

package/src/slicer/profile-flatten.ts

@@ -78,6 +78,14 @@ export interface FlattenOptions {
     process?: Record<string, unknown>;
     filaments?: (Record<string, unknown> | undefined)[];
   };
+  /**
+   * Positional `#RRGGBB` colour per filament slot (e.g. from the input 3MF
+   * project or the caller). Missing entries keep the profile's own colour or
+   * fall back to DEFAULT_FILAMENT_COLOUR.
+   */
+  filamentColours?: (string | undefined)[];
+  /** Saved per-plate positions, used only when the process sets no position. */
+  projectTowerPosition?: { wipe_tower_x?: unknown; wipe_tower_y?: unknown };
 }
 
 interface IndexedProfile {
@@ -308,6 +316,91 @@ function enforceMatchingNozzles(arr: unknown[]): void {
 }
 
 /** Best-effort extruder count for fallback nozzle_volume_type sizing. */
+/** BambuStudio's built-in filament_colour default. */
+export const DEFAULT_FILAMENT_COLOUR = "#00AE42";
+const FILAMENT_COLOUR_RE = /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/;
+
+/**
+ * No BBL filament profile defines `filament_colour`; the GUI fills it from
+ * the AMS. Without it the CLI keeps a single-entry colour vector however many
+ * filaments are loaded and crashes (access violation) as soon as a slice uses
+ * any filament after the first. Give every slot exactly one colour.
+ */
+function ensureFilamentColour(flat: Record<string, unknown>, colour?: string): void {
+  if (colour !== undefined) {
+    if (!FILAMENT_COLOUR_RE.test(colour)) {
+      throw new Error(`Invalid filament colour "${colour}"; expected #RRGGBB.`);
+    }
+    flat["filament_colour"] = [colour];
+    return;
+  }
+  const own = flat["filament_colour"];
+  if (Array.isArray(own) && typeof own[0] === "string" && FILAMENT_COLOUR_RE.test(own[0])) {
+    flat["filament_colour"] = [own[0]];
+    return;
+  }
+  flat["filament_colour"] = [DEFAULT_FILAMENT_COLOUR];
+}
+
+// BambuStudio's defaults when a process sets no prime tower position/width.
+const DEFAULT_WIPE_TOWER_X = 15;
+const DEFAULT_WIPE_TOWER_Y = 220;
+const DEFAULT_PRIME_TOWER_WIDTH = 35;
+// Clearance inside the shared nozzle area for the auto-sized tower brim and
+// the CLI's own safety margin (X2D fails at 5 mm from the edge, passes at 6).
+const WIPE_TOWER_MARGIN = 15;
+
+interface Rect { minX: number; maxX: number; minY: number; maxY: number }
+
+function parseArea(area: string): Rect {
+  const points = area.split(",").map((p) => p.trim().split("x").map(Number));
+  if (points.length < 3 || points.some((p) => p.length !== 2 || p.some((n) => !Number.isFinite(n)))) {
+    throw new Error(`Malformed extruder_printable_area entry "${area}".`);
+  }
+  const xs = points.map((p) => p[0]);
+  const ys = points.map((p) => p[1]);
+  return { minX: Math.min(...xs), maxX: Math.max(...xs), minY: Math.min(...ys), maxY: Math.max(...ys) };
+}
+
+/**
+ * On multi-nozzle machines (H2D, X2D) each nozzle reaches only part of the
+ * bed (`extruder_printable_area`), and the prime tower must be reachable by
+ * every nozzle. The CLI's default tower position (x=15) lies outside the
+ * X2D/H2D right-nozzle area, so slicing fails with "G-code outside of the
+ * printable area". When the process sets no position and the default does
+ * not fit, move the tower inside the area all nozzles share.
+ */
+function placePrimeTowerForAllNozzles(
+  machineFlat: Record<string, unknown>,
+  processFlat: Record<string, unknown>
+): void {
+  if (processFlat["wipe_tower_x"] !== undefined || processFlat["wipe_tower_y"] !== undefined) return;
+  if (["0", "false"].includes(String(processFlat["enable_prime_tower"]).toLowerCase())) return;
+  const areas = machineFlat["extruder_printable_area"];
+  if (!Array.isArray(areas) || areas.length < 2) return;
+  const rects = areas.map((a) => {
+    if (typeof a !== "string") throw new Error("Malformed extruder_printable_area in machine profile.");
+    return parseArea(a);
+  });
+  const shared: Rect = {
+    minX: Math.max(...rects.map((r) => r.minX)) + WIPE_TOWER_MARGIN,
+    maxX: Math.min(...rects.map((r) => r.maxX)) - WIPE_TOWER_MARGIN,
+    minY: Math.max(...rects.map((r) => r.minY)) + WIPE_TOWER_MARGIN,
+    maxY: Math.min(...rects.map((r) => r.maxY)) - WIPE_TOWER_MARGIN,
+  };
+  const width = Number(processFlat["prime_tower_width"] ?? DEFAULT_PRIME_TOWER_WIDTH);
+  const size = Number.isFinite(width) && width > 0 ? width : DEFAULT_PRIME_TOWER_WIDTH;
+  if (shared.maxX - shared.minX < size || shared.maxY - shared.minY < size) {
+    throw new Error("No bed area is reachable by every nozzle for the prime tower.");
+  }
+  const clamp = (v: number, lo: number, hi: number) => Math.min(Math.max(v, lo), hi);
+  const x = clamp(DEFAULT_WIPE_TOWER_X, shared.minX, shared.maxX - size);
+  const y = clamp(DEFAULT_WIPE_TOWER_Y, shared.minY, shared.maxY - size);
+  if (x === DEFAULT_WIPE_TOWER_X && y === DEFAULT_WIPE_TOWER_Y) return;
+  processFlat["wipe_tower_x"] = [String(x)];
+  processFlat["wipe_tower_y"] = [String(y)];
+}
+
 function inferExtruderCount(flat: Record<string, unknown>): number {
   for (const key of ["nozzle_diameter", "extruder_type", "extruder_variant_list"]) {
     const v = flat[key];
@@ -586,7 +679,17 @@ export async function flattenForCli(opts: FlattenOptions): Promise<FlattenedProf
   normalizeForCli(machineFlat, "machine", opts.machineLeaf);
   normalizeForCli(processFlat, "process", opts.processLeaf);
   filamentFlats.forEach((f, i) => normalizeForCli(f, "filament", opts.filamentLeaves[i]));
+  if (opts.filamentColours && opts.filamentColours.length !== filamentFlats.length) {
+    throw new Error(
+      `${opts.filamentColours.length} filament colours were supplied for ${filamentFlats.length} filament slots.`
+    );
+  }
+  filamentFlats.forEach((f, i) => ensureFilamentColour(f, opts.filamentColours?.[i]));
   applyBedType(processFlat, opts.bedType);
+  if (processFlat["wipe_tower_x"] === undefined && processFlat["wipe_tower_y"] === undefined) {
+    Object.assign(processFlat, opts.projectTowerPosition);
+  }
+  placePrimeTowerForAllNozzles(machineFlat, processFlat);
 
   // Mirror the GUI's auto-extend behavior: when the caller explicitly
   // chose a process or filament that wasn't pre-declared compatible with

package/src/stl/stl-manipulator.ts

@@ -162,6 +162,7 @@ export interface BambuSliceOptions {
   skipObjects?: string;        // --skip-objects "3,5,10": skip specific objects
   loadFilaments?: string;      // --load-filaments "f1.json;f2.json": filament profiles
   loadFilamentIds?: string;    // --load-filament-ids "1,2,3,1": filament-to-object mapping
+  filamentColours?: string[];  // positional #RRGGBB per loaded filament slot
   bedType?: string;            // Bambu bed type, e.g. textured_plate or cool_plate
   enableTimelapse?: boolean;   // --enable-timelapse: timelapse-aware slicing
   allowMixTemp?: boolean;      // --allow-mix-temp: allow mixed-temp filaments
@@ -177,6 +178,10 @@ export interface BambuSliceOptions {
 interface BambuSettingsBundle {
   settingsArg?: string;
   filamentPaths: string[];
+  /** Positional slot colours declared by the input 3MF project. */
+  filamentColours?: string[];
+  /** Saved per-plate tower coordinates must survive default process loading. */
+  projectTowerPosition?: { wipe_tower_x?: unknown; wipe_tower_y?: unknown };
   /** Identity provenance before the process is merged into a generated file. */
   processSource?: { filePath: string; profile: Record<string, unknown> };
 }
@@ -534,21 +539,32 @@ export class STLManipulator extends EventEmitter {
       profilesRoot,
       tempDir: this.tempDir,
       bedType: this.resolveBambuStudioBedType(bambuOptions?.bedType),
+      filamentColours: bambuOptions?.filamentColours ?? bundle.filamentColours,
+      projectTowerPosition: bundle.projectTowerPosition,
       sourceProfiles: {
         machine: isBundledFile(machinePath) ? undefined : machine,
         process: isBundledFile(processPath) ? undefined : processProfile,
         filaments: filaments.map((profile, i) => isBundledFile(bundle.filamentPaths[i]) ? undefined : profile),
       },
     });
-    // Standalone custom files have no BBL dependencies; preserve their identity
-    // and content. Other profiles retain user values through sourceProfiles.
+    // Standalone files retain their own identity and settings, but still need
+    // the CLI colour/tower fields. Do not discard those required overlays when
+    // choosing the original profile instead of the normalized BBL output.
+    const withCliFields = (filePath: string, profile: Record<string, unknown>, flatPath: string, keys: string[]): string => {
+      const flattened = readProfile(flatPath);
+      const fields = Object.fromEntries(keys.filter(key => flattened[key] !== undefined).map(key => [key, flattened[key]]));
+      if (Object.entries(fields).every(([key, value]) => JSON.stringify(profile[key]) === JSON.stringify(value))) return filePath;
+      return this.writeTempJson(path.basename(filePath, '.json'), 'cli', { ...profile, ...fields });
+    };
     return {
       settingsArg: [
         needsResolution(machinePath, machine) ? flat.machinePath : machinePath,
-        needsResolution(processPath, processProfile) ? flat.processPath : processPath,
+        needsResolution(processPath, processProfile) ? flat.processPath
+          : withCliFields(processPath, processProfile, flat.processPath, ['wipe_tower_x', 'wipe_tower_y']),
       ].join(';'),
       filamentPaths: filaments.map((profile, i) =>
-        needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i] : bundle.filamentPaths[i]),
+        needsResolution(bundle.filamentPaths[i], profile) ? flat.filamentPaths[i]
+          : withCliFields(bundle.filamentPaths[i], profile, flat.filamentPaths[i], ['filament_colour'])),
     };
   }
 
@@ -571,13 +587,20 @@ export class STLManipulator extends EventEmitter {
     const count = Math.max(0, ...['filament_settings_id', 'filament_type', 'filament_colour', 'filament_diameter']
       .map(key => Array.isArray(data[key]) ? data[key].length : 0));
     if (count === 0) throw new Error('Cannot determine project filament slots from project_settings.config.');
+    // Keep the project's slot colours; loaded profiles carry none of their own.
+    const colours = Array.isArray(data.filament_colour) && data.filament_colour.length === count &&
+      data.filament_colour.every(c => typeof c === 'string' && /^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$/.test(c))
+      ? data.filament_colour as string[]
+      : undefined;
+    const projectTowerPosition = Object.fromEntries(['wipe_tower_x', 'wipe_tower_y']
+      .filter(key => data[key] !== undefined).map(key => [key, data[key]]));
     if (bundle.filamentPaths.length === 1) {
-      return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]) };
+      return { ...bundle, filamentPaths: Array(count).fill(bundle.filamentPaths[0]), filamentColours: colours, projectTowerPosition };
     }
     if (bundle.filamentPaths.length !== count) {
       throw new Error(`Project declares ${count} filament slots, but ${bundle.filamentPaths.length} profiles were supplied. Provide one profile for all slots or one per slot.`);
     }
-    return bundle;
+    return { ...bundle, filamentColours: colours, projectTowerPosition };
   }
 
   private resolveBambuStudioBedType(bedType?: string): string | undefined {