Print Guard

Print Guard is 3DPrintForge's real-time monitoring system. It continuously monitors the camera, sensors, and printer data, and performs configurable actions when something is wrong.

Go to: https://localhost:3443/#protection

XCam event detection

Bambu Lab printers send XCam events via MQTT when the AI camera detects issues:

Event	Code	Severity
Spaghetti detected	xcam_spaghetti	Critical
Plate detachment	xcam_detach	High
First layer malfunction	xcam_first_layer	High
Stringing	xcam_stringing	Medium
Extrusion error	xcam_extrusion	High

For each event type you can configure one or more actions:

• Notify — send notification via active notification channels
• Pause — pause the print for manual inspection
• Stop — cancel the print immediately
• None — ignore the event (still log it)

:::danger Default behavior By default, XCam events are set to Notify and Pause. Change to Stop if you fully trust the AI detection. :::

Sensor monitoring

Print Guard continuously monitors sensor data and triggers alerts on anomalies:

Temperature deviation

1. Go to Print Guard → Temperature
2. Set Max deviation from target temperature (recommended: ±5°C for nozzle, ±3°C for bed)
3. Choose Action on deviation: Notify / Pause / Stop
4. Set Delay (seconds) before action is taken — gives the temperature time to stabilize

Filament low

The system calculates remaining filament on spools:

1. Go to Print Guard → Filament
2. Set Minimum threshold in grams (e.g. 50 g)
3. Choose action: Pause and notify (recommended) to change spool manually

Print stop detection

Detects when a print has stopped unexpectedly (MQTT timeout, filament break, etc.):

1. Enable Stop detection
2. Set Timeout (recommended: 120 seconds without data = stopped)
3. Action: Always notify — the print may already have stopped

Configuration

Enabling Print Guard

1. Go to Settings → Print Guard
2. Turn on Enable Print Guard
3. Select which printers should be monitored
4. Click Save

Per-printer rules

Different printers can have different rules:

1. Click on a printer in the Print Guard overview
2. Turn off Inherit global rules
3. Configure custom rules for this printer

Test, snooze & reliability

Each printer card in the Print Guard sensor dashboard has three extra controls:

• Test — fires a safe test alert that only logs and notifies (it never pauses or stops a real print), so you can confirm your notification channels work. The entry is tagged [Test] in the log.
• Snooze — temporarily mutes a printer's guard for 15, 30 or 60 minutes during a known-tricky print, without losing your configuration. A Snoozed N min — Resume now state lets you re-enable it at any time.
• Reliability summary — a short line per printer derived from the event log: total incidents, incidents in the last 7 days, the most common issue type, and when the last incident happened.

Log and event history

All Print Guard events are logged:

• Go to Print Guard → Log
• Filter by printer, event type, date, and severity
• Click on an event to see detailed information and any actions that were taken
• Export log to CSV

:::tip False positives If Print Guard triggers unnecessary pauses, adjust the sensitivity under Print Guard → Settings → Sensitivity. Start with "Low" and increase gradually. :::