Muelltruhe hinzugefügt

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: <Items> \| Schild-Rechtsklick: Konfigurieren` |