diff --git a/Muelltruhe.md b/Muelltruhe.md new file mode 100644 index 0000000..88b83b7 --- /dev/null +++ b/Muelltruhe.md @@ -0,0 +1,69 @@ +# Mülltruhe + +Die Mülltruhe vernichtet Items automatisch. Sie kann mit einer Filter-Liste konfiguriert werden, sodass nur bestimmte Item-Typen gelöscht werden. + +--- + +## Einrichtung + +Schild an eine Truhe platzieren: + +``` +[asc] +trash +``` + +Nach dem Platzieren erscheint folgender Hinweis im Chat: +> *Rechtsklicke das Schild um Items zu konfigurieren.* + +--- + +## Konfigurations-GUI + +**Rechtsklick auf das Mülltruhen-Schild** öffnet das Konfigurations-GUI. + +| Aktion | Beschreibung | +| --- | --- | +| Rechtsklick auf ein Item im GUI | Item zur Filter-Liste hinzufügen | +| Erneuter Rechtsklick | Item aus der Filter-Liste entfernen | + +--- + +## Filter-Modus + +| Modus | Verhalten | +| --- | --- | +| **Ohne Filter-Liste** | Alle Items in der Truhe werden vernichtet | +| **Mit Filter-Liste** | Nur die eingetragenen Item-Typen werden gelöscht – der Rest bleibt erhalten | + +--- + +## Hopper-Unterstützung + +Items, die per **Hopper** in die Mülltruhe eingeworfen werden, werden sofort verarbeitet – auch ohne manuelles Öffnen der Truhe. + +--- + +## Auto-Clear-Intervall + +In der `config.yml` kann ein automatisches Leeren der Mülltruhe konfiguriert werden: + +```yaml +trash: + auto_clear_interval_seconds: 0 # 0 = Nur beim Schließen leeren + # auto_clear_interval_seconds: 300 # 300 = alle 5 Minuten + # auto_clear_interval_seconds: 3600 # 3600 = stündlich +``` + +Bei `0` wird die Mülltruhe nur dann geleert, wenn der Spieler sie schließt. + +--- + +## Schild-Anzeige + +Das Schild der Mülltruhe zeigt den aktuellen Status: + +| Zustand | Schild-Text | +| --- | --- | +| Kein Filter konfiguriert | `Mülltruhe (Deaktiviert)` | +| Filter aktiv | `Müll: \| Schild-Rechtsklick: Konfigurieren` |