bambu-printer-mcp 1.0.3 → 1.0.5

package/README.md

@@ -716,6 +716,53 @@ Slice an STL or 3MF file using an external slicer and return the path to the out
 
 For printing on a Bambu printer, the recommended workflow is: slice with `bambustudio` to get a sliced 3MF, then pass that output path to `print_3mf`.
 
+#### BambuStudio Slicer Options
+
+When `slicer_type` is `bambustudio` (the default), these additional parameters are available on `slice_stl`:
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `uptodate` | boolean | Update 3MF configs to latest BambuStudio presets |
+| `repetitions` | number | Number of copies to print |
+| `orient` | boolean | Auto-orient model for optimal printability |
+| `arrange` | boolean | Auto-arrange objects on the build plate |
+| `ensure_on_bed` | boolean | Lift floating models onto the bed |
+| `clone_objects` | string | Clone counts per object, comma-separated (e.g. `"1,3,1,10"`) |
+| `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 |
+| `enable_timelapse` | boolean | Enable timelapse-aware slicing |
+| `allow_mix_temp` | boolean | Allow mixed-temperature filaments on one plate |
+| `scale` | number | Uniform scale factor |
+| `rotate` | number | Z-axis rotation in degrees |
+| `rotate_x` | number | X-axis rotation in degrees |
+| `rotate_y` | number | Y-axis rotation in degrees |
+| `min_save` | boolean | Produce smaller output 3MF (faster uploads) |
+| `skip_modified_gcodes` | boolean | Ignore stale custom gcodes in the 3MF |
+| `slice_plate` | number | Which plate to slice (0 = all plates, default: 0) |
+
+**Example: Slice with auto-orient and 3 copies**
+```json
+{
+  "stl_path": "/path/to/model.stl",
+  "bambu_model": "p1s",
+  "orient": true,
+  "arrange": true,
+  "repetitions": 3
+}
+```
+
+#### Smart Defaults (print_3mf auto-slice)
+
+When `print_3mf` detects an unsliced 3MF and auto-slices it, these defaults are applied automatically:
+
+- `uptodate: true` -- prevents stale config bugs from downloaded 3MFs
+- `ensure_on_bed: true` -- safety net, lifts floating models onto the bed
+- `min_save: true` -- smaller output for faster FTP uploads to the printer
+- `skip_modified_gcodes: true` -- strips custom gcodes from other users' profiles
+
+These defaults keep you safe when printing downloaded models. When calling `slice_stl` directly, you have full control over every flag.
+
 </details>
 
 <details>

package/dist/index.js

@@ -333,7 +333,25 @@ class BambuPrinterMCPServer {
                                 },
                                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env)" },
                                 slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
-                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" }
+                                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
+                                uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
+                                repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
+                                orient: { type: "boolean", description: "Auto-orient the model for optimal printability (minimize supports, maximize bed adhesion). Recommended for raw STL imports that lack a pre-set orientation." },
+                                arrange: { type: "boolean", description: "Auto-arrange all objects on the build plate with optimal spacing. Recommended when importing STLs or adding multiple objects. Set false to preserve existing plate layout." },
+                                ensure_on_bed: { type: "boolean", description: "Detect models floating above the bed and lower them onto the build surface. Safety net for imported models with incorrect Z origins." },
+                                clone_objects: { type: "string", description: "Duplicate specific objects on the plate. Comma-separated clone counts per object index, e.g. '1,3,1,10' clones object 0 once, object 1 three times, etc." },
+                                skip_objects: { type: "string", description: "Skip specific objects during slicing by index. Comma-separated, e.g. '3,5,10'. Useful for multi-object 3MFs where you only want to print some parts." },
+                                load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
+                                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." },
+                                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." },
+                                rotate: { type: "number", description: "Rotate the model around the Z-axis (vertical) by this many degrees before slicing. Positive = counterclockwise when viewed from above." },
+                                rotate_x: { type: "number", description: "Rotate the model around the X-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                                rotate_y: { type: "number", description: "Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                                min_save: { type: "boolean", description: "Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer." },
+                                skip_modified_gcodes: { type: "boolean", description: "Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer." },
+                                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
                             },
                             required: ["stl_path", "bambu_model"]
                         }
@@ -599,8 +617,45 @@ class BambuPrinterMCPServer {
                         const nozzleDiam = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
                         // Resolve printer preset for BambuStudio slicer
                         const printerPreset = BAMBU_MODEL_PRESETS[sliceModel]?.(nozzleDiam);
+                        const sliceBambuOptions = {};
+                        if (args?.uptodate !== undefined)
+                            sliceBambuOptions.uptodate = Boolean(args.uptodate);
+                        if (args?.repetitions !== undefined)
+                            sliceBambuOptions.repetitions = Number(args.repetitions);
+                        if (args?.orient !== undefined)
+                            sliceBambuOptions.orient = Boolean(args.orient);
+                        if (args?.arrange !== undefined)
+                            sliceBambuOptions.arrange = Boolean(args.arrange);
+                        if (args?.ensure_on_bed !== undefined)
+                            sliceBambuOptions.ensureOnBed = Boolean(args.ensure_on_bed);
+                        if (args?.clone_objects !== undefined)
+                            sliceBambuOptions.cloneObjects = String(args.clone_objects);
+                        if (args?.skip_objects !== undefined)
+                            sliceBambuOptions.skipObjects = String(args.skip_objects);
+                        if (args?.load_filaments !== undefined)
+                            sliceBambuOptions.loadFilaments = String(args.load_filaments);
+                        if (args?.load_filament_ids !== undefined)
+                            sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+                        if (args?.enable_timelapse !== undefined)
+                            sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
+                        if (args?.allow_mix_temp !== undefined)
+                            sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
+                        if (args?.scale !== undefined)
+                            sliceBambuOptions.scale = Number(args.scale);
+                        if (args?.rotate !== undefined)
+                            sliceBambuOptions.rotate = Number(args.rotate);
+                        if (args?.rotate_x !== undefined)
+                            sliceBambuOptions.rotateX = Number(args.rotate_x);
+                        if (args?.rotate_y !== undefined)
+                            sliceBambuOptions.rotateY = Number(args.rotate_y);
+                        if (args?.min_save !== undefined)
+                            sliceBambuOptions.minSave = Boolean(args.min_save);
+                        if (args?.skip_modified_gcodes !== undefined)
+                            sliceBambuOptions.skipModifiedGcodes = Boolean(args.skip_modified_gcodes);
+                        if (args?.slice_plate !== undefined)
+                            sliceBambuOptions.slicePlate = Number(args.slice_plate);
                         result = await this.stlManipulator.sliceSTL(String(args.stl_path), slicerType, slicerPath, slicerProfile || undefined, undefined, // progressCallback
-                        printerPreset);
+                        printerPreset, sliceBambuOptions);
                         break;
                     }
                     case "print_3mf": {
@@ -623,8 +678,14 @@ class BambuPrinterMCPServer {
                             const hasGcode = Object.keys(zip.files).some(f => f.match(/Metadata\/plate_\d+\.gcode/i) || f.endsWith('.gcode'));
                             if (!hasGcode) {
                                 console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
+                                const autoSliceOptions = {
+                                    uptodate: true,
+                                    ensureOnBed: true,
+                                    minSave: true,
+                                    skipModifiedGcodes: true,
+                                };
                                 threeMFPath = await this.stlManipulator.sliceSTL(threeMFPath, slicerType, slicerPath, slicerProfile || undefined, undefined, // progressCallback
-                                printPreset);
+                                printPreset, autoSliceOptions);
                                 console.log("Auto-sliced to: " + threeMFPath);
                             }
                         }

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

@@ -22,6 +22,26 @@ export type TransformationParams = {
     relative?: boolean;
     selectionBounds?: THREE.Box3;
 };
+export interface BambuSliceOptions {
+    uptodate?: boolean;
+    repetitions?: number;
+    orient?: boolean;
+    arrange?: boolean;
+    ensureOnBed?: boolean;
+    cloneObjects?: string;
+    skipObjects?: string;
+    loadFilaments?: string;
+    loadFilamentIds?: string;
+    enableTimelapse?: boolean;
+    allowMixTemp?: boolean;
+    scale?: number;
+    rotate?: number;
+    rotateX?: number;
+    rotateY?: number;
+    minSave?: boolean;
+    skipModifiedGcodes?: boolean;
+    slicePlate?: number;
+}
 export declare class STLManipulator extends EventEmitter {
     private tempDir;
     private activeOperations;
@@ -107,9 +127,10 @@ export declare class STLManipulator extends EventEmitter {
      * @param slicerProfile Optional path to the slicer profile/config file
      * @param progressCallback Optional callback for progress updates
      * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+     * @param bambuOptions Optional BambuStudio-specific CLI flags
      * @returns Path to the generated G-code or sliced 3MF file
      */
-    sliceSTL(stlFilePath: string, slicerType: 'prusaslicer' | 'cura' | 'slic3r' | 'orcaslicer' | 'bambustudio', slicerPath: string, slicerProfile?: string, progressCallback?: ProgressCallback, printerPreset?: string): Promise<string>;
+    sliceSTL(stlFilePath: string, slicerType: 'prusaslicer' | 'cura' | 'slic3r' | 'orcaslicer' | 'bambustudio', slicerPath: string, slicerProfile?: string, progressCallback?: ProgressCallback, printerPreset?: string, bambuOptions?: BambuSliceOptions): Promise<string>;
     /**
      * Enhanced version of confirmTemperatures with better error handling
      * @param gcodePath Path to the G-code file

package/dist/stl/stl-manipulator.js

@@ -738,9 +738,10 @@ export class STLManipulator extends EventEmitter {
      * @param slicerProfile Optional path to the slicer profile/config file
      * @param progressCallback Optional callback for progress updates
      * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+     * @param bambuOptions Optional BambuStudio-specific CLI flags
      * @returns Path to the generated G-code or sliced 3MF file
      */
-    async sliceSTL(stlFilePath, slicerType, slicerPath, slicerProfile, progressCallback, printerPreset) {
+    async sliceSTL(stlFilePath, slicerType, slicerPath, slicerProfile, progressCallback, printerPreset, bambuOptions) {
         const operationId = this.generateOperationId();
         this.activeOperations.set(operationId, true);
         if (!fs.existsSync(slicerPath)) {
@@ -809,7 +810,7 @@ export class STLManipulator extends EventEmitter {
                         const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
                         const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
                         args = [
-                            '--slice', '0', // Slice all plates
+                            '--slice', String(bambuOptions?.slicePlate ?? 0),
                             '--export-3mf', bambuOutputPath,
                         ];
                         if (slicerProfile) {
@@ -825,6 +826,41 @@ export class STLManipulator extends EventEmitter {
                             fs.writeFileSync(presetJson, JSON.stringify({ printer_settings_id: printerPreset }));
                             args.push('--load-settings', presetJson);
                         }
+                        // BambuSliceOptions flags
+                        if (bambuOptions?.uptodate)
+                            args.push('--uptodate');
+                        if (bambuOptions?.ensureOnBed)
+                            args.push('--ensure-on-bed');
+                        if (bambuOptions?.enableTimelapse)
+                            args.push('--enable-timelapse');
+                        if (bambuOptions?.allowMixTemp)
+                            args.push('--allow-mix-temp');
+                        if (bambuOptions?.minSave)
+                            args.push('--min-save');
+                        if (bambuOptions?.skipModifiedGcodes)
+                            args.push('--skip-modified-gcodes');
+                        if (bambuOptions?.orient !== undefined)
+                            args.push('--orient', bambuOptions.orient ? '1' : '0');
+                        if (bambuOptions?.arrange !== undefined)
+                            args.push('--arrange', bambuOptions.arrange ? '1' : '0');
+                        if (bambuOptions?.repetitions !== undefined)
+                            args.push('--repetitions', String(bambuOptions.repetitions));
+                        if (bambuOptions?.scale !== undefined)
+                            args.push('--scale', String(bambuOptions.scale));
+                        if (bambuOptions?.rotate !== undefined)
+                            args.push('--rotate', String(bambuOptions.rotate));
+                        if (bambuOptions?.rotateX !== undefined)
+                            args.push('--rotate-x', String(bambuOptions.rotateX));
+                        if (bambuOptions?.rotateY !== undefined)
+                            args.push('--rotate-y', String(bambuOptions.rotateY));
+                        if (bambuOptions?.cloneObjects)
+                            args.push('--clone-objects', bambuOptions.cloneObjects);
+                        if (bambuOptions?.skipObjects)
+                            args.push('--skip-objects', bambuOptions.skipObjects);
+                        if (bambuOptions?.loadFilaments)
+                            args.push('--load-filaments', bambuOptions.loadFilaments);
+                        if (bambuOptions?.loadFilamentIds)
+                            args.push('--load-filament-ids', bambuOptions.loadFilamentIds);
                         args.push(stlFilePath);
                         // Override outputFilePath for bambustudio since it produces 3MF, not gcode
                         outputFilePath = bambuOutputPath;

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "bambu-printer-mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "MCP server for Bambu Lab 3D printers with STL manipulation, slicing, and print management",
   "main": "dist/index.js",
-  "repository": "https://github.com/DMontgomery40/bambu-printer-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DMontgomery40/bambu-printer-mcp.git"
+  },
   "type": "module",
   "scripts": {
     "start": "node dist/index.js",
@@ -13,7 +16,7 @@
     "test": "npm run build && node --test tests/**/*.test.mjs"
   },
   "bin": {
-    "bambu-printer-mcp": "./dist/index.js"
+    "bambu-printer-mcp": "dist/index.js"
   },
   "files": [
     "dist",

package/src/index.ts

@@ -16,7 +16,7 @@ import fs from "fs";
 import path from "path";
 import { createServer as createHttpServer, type IncomingMessage, type Server as HttpServer, type ServerResponse } from "node:http";
 import { randomUUID } from "node:crypto";
-import { STLManipulator } from "./stl/stl-manipulator.js";
+import { STLManipulator, type BambuSliceOptions } from "./stl/stl-manipulator.js";
 import { parse3MF } from './3mf_parser.js';
 import { BambuImplementation } from "./printers/bambu.js";
 
@@ -405,7 +405,25 @@ class BambuPrinterMCPServer {
                 },
                 slicer_path: { type: "string", description: "Path to the slicer executable (default: value from env)" },
                 slicer_profile: { type: "string", description: "Path to the slicer profile/config file (optional, overrides bambu_model preset)" },
-                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" }
+                nozzle_diameter: { type: "string", description: "Nozzle diameter in mm (default: 0.4)" },
+                uptodate: { type: "boolean", description: "Refresh 3MF preset configs to match the latest BambuStudio version. Use when slicing downloaded or older 3MF files to prevent stale-config failures." },
+                repetitions: { type: "number", description: "Print N identical copies of the model. Each copy gets its own plate placement. Example: 3 prints three copies." },
+                orient: { type: "boolean", description: "Auto-orient the model for optimal printability (minimize supports, maximize bed adhesion). Recommended for raw STL imports that lack a pre-set orientation." },
+                arrange: { type: "boolean", description: "Auto-arrange all objects on the build plate with optimal spacing. Recommended when importing STLs or adding multiple objects. Set false to preserve existing plate layout." },
+                ensure_on_bed: { type: "boolean", description: "Detect models floating above the bed and lower them onto the build surface. Safety net for imported models with incorrect Z origins." },
+                clone_objects: { type: "string", description: "Duplicate specific objects on the plate. Comma-separated clone counts per object index, e.g. '1,3,1,10' clones object 0 once, object 1 three times, etc." },
+                skip_objects: { type: "string", description: "Skip specific objects during slicing by index. Comma-separated, e.g. '3,5,10'. Useful for multi-object 3MFs where you only want to print some parts." },
+                load_filaments: { type: "string", description: "Override filament profiles. Semicolon-separated paths to filament JSON configs, e.g. 'pla_basic.json;petg_cf.json'." },
+                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." },
+                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." },
+                rotate: { type: "number", description: "Rotate the model around the Z-axis (vertical) by this many degrees before slicing. Positive = counterclockwise when viewed from above." },
+                rotate_x: { type: "number", description: "Rotate the model around the X-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                rotate_y: { type: "number", description: "Rotate the model around the Y-axis by this many degrees before slicing. Useful for reorienting prints for better layer adhesion." },
+                min_save: { type: "boolean", description: "Write a smaller output 3MF by omitting non-essential metadata. Reduces file size for faster FTP upload to the printer." },
+                skip_modified_gcodes: { type: "boolean", description: "Strip custom start/end gcodes embedded in the 3MF. Recommended for downloaded 3MFs since custom gcodes from other users' profiles may be unsafe for your printer." },
+                slice_plate: { type: "number", description: "Which plate index to slice. 0 = all plates (default). Use 1, 2, etc. to slice only a specific plate in multi-plate 3MF projects." }
               },
               required: ["stl_path", "bambu_model"]
             }
@@ -703,11 +721,33 @@ class BambuPrinterMCPServer {
             const nozzleDiam = String(args?.nozzle_diameter || DEFAULT_NOZZLE_DIAMETER);
             // Resolve printer preset for BambuStudio slicer
             const printerPreset = BAMBU_MODEL_PRESETS[sliceModel]?.(nozzleDiam);
+
+            const sliceBambuOptions: BambuSliceOptions = {};
+            if (args?.uptodate !== undefined) sliceBambuOptions.uptodate = Boolean(args.uptodate);
+            if (args?.repetitions !== undefined) sliceBambuOptions.repetitions = Number(args.repetitions);
+            if (args?.orient !== undefined) sliceBambuOptions.orient = Boolean(args.orient);
+            if (args?.arrange !== undefined) sliceBambuOptions.arrange = Boolean(args.arrange);
+            if (args?.ensure_on_bed !== undefined) sliceBambuOptions.ensureOnBed = Boolean(args.ensure_on_bed);
+            if (args?.clone_objects !== undefined) sliceBambuOptions.cloneObjects = String(args.clone_objects);
+            if (args?.skip_objects !== undefined) sliceBambuOptions.skipObjects = String(args.skip_objects);
+            if (args?.load_filaments !== undefined) sliceBambuOptions.loadFilaments = String(args.load_filaments);
+            if (args?.load_filament_ids !== undefined) sliceBambuOptions.loadFilamentIds = String(args.load_filament_ids);
+            if (args?.enable_timelapse !== undefined) sliceBambuOptions.enableTimelapse = Boolean(args.enable_timelapse);
+            if (args?.allow_mix_temp !== undefined) sliceBambuOptions.allowMixTemp = Boolean(args.allow_mix_temp);
+            if (args?.scale !== undefined) sliceBambuOptions.scale = Number(args.scale);
+            if (args?.rotate !== undefined) sliceBambuOptions.rotate = Number(args.rotate);
+            if (args?.rotate_x !== undefined) sliceBambuOptions.rotateX = Number(args.rotate_x);
+            if (args?.rotate_y !== undefined) sliceBambuOptions.rotateY = Number(args.rotate_y);
+            if (args?.min_save !== undefined) sliceBambuOptions.minSave = Boolean(args.min_save);
+            if (args?.skip_modified_gcodes !== undefined) sliceBambuOptions.skipModifiedGcodes = Boolean(args.skip_modified_gcodes);
+            if (args?.slice_plate !== undefined) sliceBambuOptions.slicePlate = Number(args.slice_plate);
+
             result = await this.stlManipulator.sliceSTL(
               String(args.stl_path), slicerType, slicerPath,
               slicerProfile || undefined,
               undefined, // progressCallback
-              printerPreset
+              printerPreset,
+              sliceBambuOptions
             );
             break;
           }
@@ -737,10 +777,17 @@ class BambuPrinterMCPServer {
               );
               if (!hasGcode) {
                 console.log(`3MF has no gcode — auto-slicing with ${slicerType} for ${printModel}`);
+                const autoSliceOptions: BambuSliceOptions = {
+                  uptodate: true,
+                  ensureOnBed: true,
+                  minSave: true,
+                  skipModifiedGcodes: true,
+                };
                 threeMFPath = await this.stlManipulator.sliceSTL(
                   threeMFPath, slicerType, slicerPath, slicerProfile || undefined,
                   undefined, // progressCallback
-                  printPreset
+                  printPreset,
+                  autoSliceOptions
                 );
                 console.log("Auto-sliced to: " + threeMFPath);
               }

package/src/stl/stl-manipulator.ts

@@ -40,6 +40,28 @@ export type TransformationParams = {
   selectionBounds?: THREE.Box3;
 };
 
+// BambuStudio CLI flags exposed via the slice_stl tool
+export interface BambuSliceOptions {
+  uptodate?: boolean;          // --uptodate: update 3MF configs to latest presets
+  repetitions?: number;        // --repetitions N: print N copies
+  orient?: boolean;            // --orient 1: auto-orient for printability
+  arrange?: boolean;           // --arrange 1: auto-arrange objects on plate
+  ensureOnBed?: boolean;       // --ensure-on-bed: lift floating models onto bed
+  cloneObjects?: string;       // --clone-objects "1,3,1,10": clone counts per object
+  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
+  enableTimelapse?: boolean;   // --enable-timelapse: timelapse-aware slicing
+  allowMixTemp?: boolean;      // --allow-mix-temp: allow mixed-temp filaments
+  scale?: number;              // --scale factor: uniform scale
+  rotate?: number;             // --rotate degrees: Z-axis rotation
+  rotateX?: number;            // --rotate-x degrees
+  rotateY?: number;            // --rotate-y degrees
+  minSave?: boolean;           // --min-save: smaller output 3MF
+  skipModifiedGcodes?: boolean;// --skip-modified-gcodes: ignore stale custom gcodes
+  slicePlate?: number;         // --slice N: which plate (default: 0 = all)
+}
+
 export class STLManipulator extends EventEmitter {
   private tempDir: string;
   private activeOperations: Map<string, boolean> = new Map();
@@ -966,6 +988,7 @@ export class STLManipulator extends EventEmitter {
    * @param slicerProfile Optional path to the slicer profile/config file
    * @param progressCallback Optional callback for progress updates
    * @param printerPreset Optional BambuStudio printer preset name (e.g., "Bambu Lab P1S 0.4 nozzle")
+   * @param bambuOptions Optional BambuStudio-specific CLI flags
    * @returns Path to the generated G-code or sliced 3MF file
    */
   async sliceSTL(
@@ -974,7 +997,8 @@ export class STLManipulator extends EventEmitter {
     slicerPath: string,
     slicerProfile?: string,
     progressCallback?: ProgressCallback,
-    printerPreset?: string
+    printerPreset?: string,
+    bambuOptions?: BambuSliceOptions
   ): Promise<string> {
     const operationId = this.generateOperationId();
     this.activeOperations.set(operationId, true);
@@ -1051,7 +1075,7 @@ export class STLManipulator extends EventEmitter {
             const outputBase = path.basename(stlFilePath, is3mf ? '.3mf' : '.stl');
             const bambuOutputPath = path.join(this.tempDir, outputBase + '_sliced.3mf');
             args = [
-              '--slice', '0',  // Slice all plates
+              '--slice', String(bambuOptions?.slicePlate ?? 0),
               '--export-3mf', bambuOutputPath,
             ];
             if (slicerProfile) {
@@ -1068,6 +1092,26 @@ export class STLManipulator extends EventEmitter {
               fs.writeFileSync(presetJson, JSON.stringify({ printer_settings_id: printerPreset }));
               args.push('--load-settings', presetJson);
             }
+
+            // BambuSliceOptions flags
+            if (bambuOptions?.uptodate) args.push('--uptodate');
+            if (bambuOptions?.ensureOnBed) args.push('--ensure-on-bed');
+            if (bambuOptions?.enableTimelapse) args.push('--enable-timelapse');
+            if (bambuOptions?.allowMixTemp) args.push('--allow-mix-temp');
+            if (bambuOptions?.minSave) args.push('--min-save');
+            if (bambuOptions?.skipModifiedGcodes) args.push('--skip-modified-gcodes');
+            if (bambuOptions?.orient !== undefined) args.push('--orient', bambuOptions.orient ? '1' : '0');
+            if (bambuOptions?.arrange !== undefined) args.push('--arrange', bambuOptions.arrange ? '1' : '0');
+            if (bambuOptions?.repetitions !== undefined) args.push('--repetitions', String(bambuOptions.repetitions));
+            if (bambuOptions?.scale !== undefined) args.push('--scale', String(bambuOptions.scale));
+            if (bambuOptions?.rotate !== undefined) args.push('--rotate', String(bambuOptions.rotate));
+            if (bambuOptions?.rotateX !== undefined) args.push('--rotate-x', String(bambuOptions.rotateX));
+            if (bambuOptions?.rotateY !== undefined) args.push('--rotate-y', String(bambuOptions.rotateY));
+            if (bambuOptions?.cloneObjects) args.push('--clone-objects', bambuOptions.cloneObjects);
+            if (bambuOptions?.skipObjects) args.push('--skip-objects', bambuOptions.skipObjects);
+            if (bambuOptions?.loadFilaments) args.push('--load-filaments', bambuOptions.loadFilaments);
+            if (bambuOptions?.loadFilamentIds) args.push('--load-filament-ids', bambuOptions.loadFilamentIds);
+
             args.push(stlFilePath);
             // Override outputFilePath for bambustudio since it produces 3MF, not gcode
             outputFilePath = bambuOutputPath;