Datenbank & CrossLink

ASC unterstützt zwei Datenspeicher-Backends: YAML (Standard, keine Einrichtung nötig) und MySQL/MariaDB (empfohlen für Netzwerke).

—

YAML-Modus (Standard)

Ohne MySQL-Konfiguration werden alle Spielerdaten in plugins/AutoSortChest/players.yml gespeichert. Kein weiteres Setup erforderlich.

—

MySQL aktivieren

In der config.yml:

„`yaml
mysql:
enabled: true
host: „localhost“
port: 3306
database: „autosortchest“
user: „autosortchest“
password: „autosortchest“
„`

Das Datenbankschema wird beim Start automatisch migriert – keine manuellen SQL-Befehle nötig.

—

Datenbank-Tabellen

| Tabelle | Inhalt |
| — | — |
| ascplayers | Spieler-UUIDs und Namen |
| ascinputchests | Registrierte Eingangstruhen |
| asctargetchests | Zieltruhen mit Item-Zuordnung und Slot-Index |
| ascrestchests | Rest-/Fallback-Truhen |
| asctrashchests | Mülltruhen mit Serverzuordnung |
| asctrashitems | Filter-Listen der Mülltruhen |
| asctransfers | Ausstehende CrossLink-Transfers zwischen Servern |

—

CrossLink (Serverübergreifende Sortierung)

Mit CrossLink können Zieltruhen auf anderen Servern desselben Netzwerks liegen. Benötigt MySQL.

Funktionsweise

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

Einrichtung (BungeeCord / Velocity)

1. Dieselbe MySQL-Datenbank auf allen Servern eintragen
2. Auf jedem Server einen eindeutigen servername setzen

„`yaml
servercrosslink: true
servername: „survival“ # z. B. „lobby“, „survival“, „creative“
„`

1. mysql.enabled: true und servercrosslink: true setzen
2. Alle Server neu starten

⚠️ Wird servername leer gelassen, läuft das Plugin im Legacy-Modus (welt-basierte Erkennung, kein BungeeCord).

Alle Server nutzen dieselbe MySQL-Datenbank
Jeder Server hat einen eindeutigen servername

• servercrosslink: true auf allen beteiligten Servern

Beim Export wird automatisch ein Backup der bestehenden players.yml erstellt:
playersbackup_.yml