AutoSortChest

Intelligente Lagerverwaltung & automatisierte Sortiersysteme ohne Redstone-Chaos

---

Über AutoSortChest

Schluss mit unordentlichen Truhen und stundenlangem Sortieren! AutoSortChest ermöglicht es dir, komplexe Sortiersysteme für Farmen, Shops oder Lagerhäuser in Sekunden aufzubauen. Alles funktioniert über ein intuitives Schildersystem – keine komplizierten Befehle oder mühsame Redstone-Leitungen erforderlich.

---

✨ Features

• Einfache Schild-Steuerung: Erstelle Input-, Ziel- und Rest-Truhen durch das Platzieren eines Schildes.
• Visuelles Status-System: Schilder ändern ihre Farbe, wenn eine Truhe voll ist, und senden Warnungen im Chat.
• Smart Rest-Truhe (Fallback): Konfiguriere eine Auffangtruhe für alle Items ohne spezielles Ziel.
• Dynamic Item Update: Ändere das sortierte Item einer Truhe jederzeit per Rechtsklick – kein Abbauen nötig!
• Privatsphäre-Modus: Schalte Truhen per Shift-Rechtsklick zwischen Öffentlich und Privat um.
• Server-übergreifend (CrossLink): Mit MySQL können Zieltruhen auf anderen Servern des Netzwerks liegen. Items werden automatisch via Transfer-Tabelle weitergeleitet.
• Import & Export: Daten lassen sich bequem zwischen players.yml und MySQL hin- und herwechseln – per Admin-Befehl.
• Multiplayer-Optimiert: Jeder Spieler verwaltet sein eigenes System – kein gegenseitiges Stören.
• Vollständig Anpassbar: Alle Nachrichten, Farben und Limits lassen sich in der config.yml editieren.

---

📖 Einrichtung

1. Eingangstruhe (Input)

Hier wirfst du alle unsortierten Items hinein.

Schild an die Truhe platzieren und folgendes schreiben:

[asc]
input

Dein Spielername wird automatisch in Zeile 4 eingetragen.

---

2. Zieltruhe (Target)

Hier landen die spezifisch sortierten Items.

Schild an die Truhe platzieren:

[asc]
ziel

Danach mit dem gewünschten Item (z. B. Diamant) auf das Schild Rechtsklicken – der Item-Typ wird automatisch eingetragen.

---

3. Rest-Truhe (Fallback)

Das Auffangbecken für alle Items ohne Zieltruhe.

[asc]
rest

---

🔐 Zugriff & Modi

Aktion	Beschreibung
Shift + Rechtsklick (leere Hand) auf Schild/Truhe	Wechselt zwischen Privat und Öffentlich
Privat	Nur der Besitzer kann die Truhe nutzen. Sortierung nur bei Online-Status.
Öffentlich	Alle Spieler dürfen Items einwerfen. Sortierung auch offline. Schild zeigt [Public].

Nur der Besitzer (Name auf dem Schild) kann den Modus ändern oder die Truhe/das Schild abbauen.
Zum Abbauen immer Shift gedrückt halten.

---

🌐 Serverübergreifende Sortierung (CrossLink)

Wenn MySQL aktiviert und server_crosslink: true gesetzt ist, können Zieltruhen auf anderen Servern desselben Netzwerks liegen.

Funktionsweise:

1. Server A hat die Eingangstruhe und erkennt, dass die Zieltruhe für OAK_LOG auf Server B liegt.
2. Server A schreibt den Transfer in die gemeinsame Datenbank (asc_transfers).
3. Server B liest die Transfer-Tabelle und befüllt seine lokale Zieltruhe automatisch.

Voraussetzung: Alle Server müssen dieselbe MySQL-Datenbank nutzen.

---

💬 Befehle & Berechtigungen

Befehl	Beschreibung	Berechtigung
/asc help	Zeigt die Hilfe an	–
/asc info	Plugin-Informationen (Version, Autor)	autosortchest.use
/asc reload	Konfiguration neu laden	autosortchest.reload
/asc import	Importiert Daten aus players.yml → MySQL	autosortchest.import (OP)
/asc export	Exportiert Daten aus MySQL → players.yml	autosortchest.export (OP)

Import & Export – Details

/asc import
Überträgt alle Spielerdaten aus der players.yml in die MySQL-Datenbank. Sinnvoll beim erstmaligen Wechsel von YAML auf MySQL. Bestehende MySQL-Einträge werden dabei nicht gelöscht, sondern aktualisiert (REPLACE INTO).

/asc export
Exportiert alle Daten aus MySQL zurück in die players.yml. Enthält die players.yml noch Daten, wird vorher automatisch ein Backup erstellt (players_backup_<timestamp>.yml). Ist die Datei bereits leer, wird kein unnötiges Backup angelegt.

---

⚙️ Konfiguration (config.yml)

# Version der Konfigurationsdatei
version: "2.0"

# Debug-Modus (nur für Entwicklung)
debug: false

# MySQL/MariaDB – für CrossLink und zentralen Datenspeicher
mysql:
  enabled: false
  host: "localhost"
  port: 3306
  database: "autosortchest"
  user: "autosortchest"
  password: "autosortchest"

# Serverübergreifende Sortierung (benötigt MySQL)
server_crosslink: true

# Sprache: 'de' oder 'en'
language: "de"

# Welten, in denen das Plugin deaktiviert ist
world_blacklist:
  - "world_nether"
  - "world_the_end"

# Sortier-Intervall in Ticks (1 Tick = 0,05s)
sort_interval_ticks: 5

# Maximale Anzahl Zieltruhen pro Spielergruppe
chest_limits:
  default: 5
  vip: 100

# Schildfarben (Minecraft-Farbcodes)
sign-colors:
  input:
    line1: "&6"   # [asc]
    line2: "&0"   # input
    line4: "&1"   # Spielername
  target:
    line1: "&6"   # [asc]
    line2: "&0"   # ziel
    line3: "&f"   # Item-Typ
    line4: "&1"   # Spielername
  full:
    line1: "&c"
    line2: "&4"
    line3: "&e"
    line4: "&1"
  rest:
    line1: "&6"
    line2: "&0"
    line3: "&f"
    line4: "&1"

# Nachrichten
messages:
  no-chest-near-sign: "&cKeine Truhe in der Nähe des Schildes!"
  no-item-in-hand: "&cDu musst ein Item in der Hand halten!"
  not-your-chest: "&cDiese Truhe gehört dir nicht!"
  input-chest-set: "&aEingangstruhe erfolgreich gesetzt!"
  target-chest-set: "&aZieltruhe erfolgreich für %item% eingerichtet!"
  rest-chest-set: "&aRest-Truhe (Fallback) erfolgreich gesetzt!"
  target-chest-missing: "&cZieltruhe für %item% fehlt!"
  target-chest-full: "&cZieltruhe für %item% ist voll! Koordinaten: (%x%, %y%, %z%)"
  sign-break-denied: "&cDu musst Shift gedrückt halten, um dieses Schild oder die Truhe abzubauen!"
  no-permission: "&cDu hast keine Berechtigung für diesen Befehl!"
  reload-success: "&aKonfiguration erfolgreich neu geladen!"
  mode-changed: "&aModus gewechselt: &e%mode%"
  mode-public: "&aÖffentlich"
  mode-private: "&cPrivat"

---

🗄️ Datenbank-Tabellen

Bei aktiviertem MySQL erstellt das Plugin folgende Tabellen automatisch:

Tabelle	Inhalt
asc_players	Spieler-UUIDs und Namen
asc_input_chests	Registrierte Eingangstruhen
asc_target_chests	Zieltruhen mit Item-Zuordnung
asc_rest_chests	Rest-/Fallback-Truhen
asc_transfers	Ausstehende CrossLink-Transfers zwischen Servern

---

🔧 Technische Details

• Kompatibilität: Paper, Spigot, Purpur (1.18.x – 1.21.x)
• Java: 17+
• Datenbank: YAML (Standard) oder MySQL/MariaDB (optional)
• Performance: Ressourcenschonende Sortier-Algorithmen mit konfigurierbarem Intervall

---

💬 Support

---

Viper Plugins © 2026 – Effizienz für deinen Server