The **BambuLab Plugin** is a Driver plugin that extends FilaMan with full BambuLab 3D printer integration. It enables communication via MQTT, AMS slot management, and automatic filament setting assignment.

**Installation:** → [Admin: Plugin Management](./11-admin.md#115-system-plugin-management)

---

| Property | Value |

|----------|-------|

| **Plugin Type** | Driver (Printer Driver) |

| **Author** | FilaMan |

| **Source** | [Fire-Devils/filaman-plugins](https://github.com/Fire-Devils/filaman-plugins) (Registry) |

| **Connection** | MQTT over local network |

| **Capabilities** | AMS support, RFID detection, Automatic filament matching |

---

| Model | AMS Type |

|-------|----------|

| **P1P / P1S** | AMS (Automatic Material System) |

---

When adding or editing a BambuLab printer, the plugin shows the following configuration fields:

| Field | Required | Description |

|-------|----------|-------------|

| **Serial Number** | Yes | Serial number of the printer (found on the device or in the Bambu Handy app) |

| **Access Code** | Yes | Access code from the printer's LAN settings |

| **Reconnect Interval** | No | Interval in minutes for automatic reconnection on connection loss (default: 5, range: 1–60) |

---

Upon installation of the plugin and when a BambuLab printer is first started, the following components are automatically set up:

The plugin creates **10 extra fields** (called "Printer Parameters") specifically needed for BambuLab printers. These fields are automatically created as **System Extra Fields** (visible under [Admin: Extra Fields](./11-admin.md#114-extra-fields)).

| Parameter | Description | Field Type |

|-----------|-------------|------------|

| **Bambu Material Index** (`bambu_idx`) | Material index from the BambuLab filament list — select the matching BambuLab material from a dropdown | Dropdown |

| **Tray Info Index** (`bambu_tray_idx`) | Index identifying the tray entry in the BambuLab system | Text |

| **Setting ID** (`bambu_setting_id`) | Print profile ID used internally by BambuLab for print settings | Text |

| **Calibration Index** (`bambu_cali_idx`) | Calibration index for print calibration | Text |

| **K Value** (`bambu_k_value`) | K value (Pressure Advance) for extrusion control | Number |

| **Flow Ratio** (`bambu_flow_ratio`) | Flow rate / extrusion multiplier | Number |

| **Bed Temperature** (`bambu_bed_temp`) | Print bed temperature in °C | Number |

| **Nozzle Temp Min** (`bambu_nozzle_temp_min`) | Minimum nozzle temperature in °C | Number |

| **Nozzle Temp Max** (`bambu_nozzle_temp_max`) | Maximum nozzle temperature in °C | Number |

| **Max Volumetric Speed** (`bambu_max_volumetric_speed`) | Maximum volumetric flow speed in mm³/s | Number |

---

Printer parameters appear in two places in the user interface:

Under the **"Printer Parameters"** section on the filament edit page.

- This is where you set **default values** for a filament (e.g. "PLA generally at 210–220°C")

- These values serve as the **base** for all spools of this filament

- When creating a new PLA filament, for example, enter the BambuLab parameters that are typical for this filament here

Under the **"Printer Parameters"** section on the spool edit page.

- This is where you can set **spool-specific values** that differ from the filament defaults

- Spool parameters take **priority** over filament parameters when sending to the printer

- Useful when a specific spool requires different calibration values or temperatures

---

There are three ways to populate the parameters:

Open the filament or spool edit form and fill in the values in the "Printer Parameters" section.

- The **Bambu Material Index** can be conveniently selected from a dropdown — the list contains all material types supported by BambuLab

- The remaining fields (temperatures, K value, etc.) can be entered directly as numbers or text

- This method is especially suitable for filaments you are setting up for the first time

On the **spool detail page**, you can import parameters directly from an AMS slot:

1. Click on an AMS slot dot in the printer slot overview

2. Select from the context menu:

- **"Import to spool"** — Imports the values (tray index, temperatures, calibration ID, etc.) into the spool's printer parameters

- **"Import to spool & filament"** — Imports the values into both the spool and its associated filament

When a new BambuLab printer is added and another BambuLab printer already exists, FilaMan automatically copies the printer parameters from the existing printer. This saves you from entering the parameters again.

---

After a successful connection, FilaMan shows all AMS slots and their current contents on the **printer page** and the **spool detail page**:

- **AMS Slots** — Up to 4 slots per AMS unit

- **External Tray** — The printer's external spool feeder

- Displayed information includes: filament type, color, temperature range, and calibration status

- The display updates in **real time** via Server-Sent Events (SSE)

For more details on assigning spools to slots: → [Printers: Setting Spools](./09-printers.md#setting-spools--overview)

---

If you are updating the BambuLab plugin from an older version, existing parameters are automatically renamed:

| Old Name | New Name |

|----------|----------|

| `bambu_cali_id` | `bambu_cali_idx` |

| `bambu_k` | `bambu_k_value` |

| `bambu_max_volspeed` | `bambu_max_volumetric_speed` |

| `bambu_nozzle_temp` | `bambu_nozzle_temp_min` |

Your existing data is preserved — the renaming happens automatically on the first printer connection after the update.

---

← [Back: Tips & FAQ](./13-faq.md) | [Next: More Plugins →](#)