Schilder hinzugefügt

Schilder.md

@@ -0,0 +1,111 @@
+# Schilder & Truhen-Typen
+
+Das gesamte ASC-System wird über Schilder gesteuert. Platziere ein Schild an eine Truhe und schreibe den gewünschten Typ hinein – fertig.
+
+---
+
+## Schild-Syntax
+
+```
+Zeile 1: [asc]
+Zeile 2: <typ>
+```
+
+Der Spielername wird automatisch in Zeile 4 eingetragen. Zeile 3 und 4 werden je nach Typ automatisch befüllt.
+
+---
+
+## Truhen-Typen
+
+### 1. Eingangstruhe (Input)
+
+Hier kommen alle unsortierten Items hinein. Das System sortiert sie von hier aus automatisch in die passenden Zieltruhen.
+
+```
+[asc]
+input
+```
+
+* Hopper können **keine** Items direkt einlegen (Hopper-Schutz)
+* Spieler wirft Items manuell oder über eigene Mechanismen hinein
+* Items ohne Zieltruhe wandern in die Rest-Truhe (falls vorhanden)
+
+---
+
+### 2. Zieltruhe (Target)
+
+Hierhin werden spezifische Item-Typen sortiert.
+
+```
+[asc]
+ziel
+```
+
+Nach dem Platzieren des Schildes: **Rechtsklick** auf das Schild mit dem gewünschten Item in der Hand → der Item-Typ wird automatisch eingetragen.
+
+**Wichtige Eigenschaften:**
+* Der Item-Typ kann jederzeit per Rechtsklick (Item in Hand) geändert werden – kein Abbauen nötig
+* Mehrere Zieltruhen für denselben Item-Typ möglich – volle Truhen werden automatisch übersprungen
+* Das Schild wechselt die Farbe, wenn die Truhe voll ist, und sendet eine Chat-Warnung
+
+---
+
+### 3. Rest-Truhe (Fallback)
+
+Auffangbecken für alle Items, für die keine Zieltruhe definiert ist.
+
+```
+[asc]
+rest
+```
+
+* Hopper können **keine** Items direkt einlegen (Hopper-Schutz)
+* Mehrere Rest-Truhen möglich – sind alle voll, bleibt das Item in der Eingangstruhe
+* Nachsortierung aus Rest-Truhen kann per `rest_resort_interval_ticks` aktiviert werden
+
+---
+
+### 4. Mülltruhe (Trash)
+
+Items, die in diese Truhe gelangen, werden automatisch vernichtet.
+
+```
+[asc]
+trash
+```
+
+Nach dem Platzieren erscheint ein Hinweis. Per **Rechtsklick** auf das Schild öffnet sich das Konfigurations-GUI.
+
+Details zur Mülltruhe: [Mülltruhe](Muelltruhe)
+
+---
+
+## Schild-Status
+
+| Farbe | Bedeutung |
+| --- | --- |
+| Normal | Truhe hat freien Platz |
+| Rot / abweichend | Truhe ist voll |
+
+---
+
+## Clean-Modus
+
+Wenn `sign-style.clean-target: true` in der `config.yml` gesetzt ist, werden Schilder im aufgeräumten Format ohne `[asc]`-Tag angezeigt:
+
+| Typ | Zeile 1 | Zeile 2 | Zeile 3 |
+| --- | --- | --- | --- |
+| Input | Spielername | „Eingang" / „Input" | Öffentlich / Privat |
+| Target | Item-Name | Spielername | Öffentlich / Privat |
+| Rest | Spielername | „Rest" | Öffentlich / Privat |
+| Trash | Spielername | „Müll" / „Trash" | — |
+
+Die Farben im Clean-Modus werden separat unter `sign-colors-clean` in der `config.yml` konfiguriert.
+
+---
+
+## Schilder und Truhen abbauen
+
+> ⚠️ Zum Abbauen immer **Shift gedrückt halten**.
+
+Nur der Besitzer (Name auf dem Schild) kann sein eigenes Schild oder die zugehörige Truhe abbauen. Admins mit `autosortchest.bypass` können dies ohne Shift.