diff --git a/Schilder.md b/Schilder.md new file mode 100644 index 0000000..f6926fc --- /dev/null +++ b/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: +``` + +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.