Überblick

Wartet auf Freigabe v1.0

Plattformen

Paper, Purpur, Folia

Minecraft

1.21.11 oder 26.2

Java

21

Erforderlich

Keine

Optional

PlaceholderAPI, MariaDB or MySQL

VelorJourney führt neue Spieler durch deinen Server und zeigt dir, wie viele von ihnen zurückkommen. Es ist ein eigenständiges System für Einstieg und Bindung: Jede Anbindung ist optional.

Voraussetzungen: Java 21 und ein Paper-, Purpur- oder Folia-Server mit Minecraft 1.21.11 oder 26.2. PlaceholderAPI und ein MariaDB- oder MySQL-Server sind optional.

Erster Start #

1. Lege das VelorJourney-Jar in den Ordner plugins des Servers.
2. Starte den Server einmal.
3. Bearbeite plugins/VelorJourney/config.yml, die Sprachdateien und die Dateien in journeys/.
4. Führe /journey validate aus, um deine Änderungen zu prüfen, und dann /journey reload, um sie anzuwenden.
5. Führe /journey doctor aus, um den Speicher zu prüfen.

/journey validate liest die Dateien auf der Festplatte genau so, wie es ein Reload täte, und nennt Datei und Problem, wenn etwas nicht stimmt. Es ändert nichts. /journey reload ist alles oder nichts: Ist irgendeine Datei ungültig, wird er abgelehnt, und die laufende Konfiguration bleibt im Einsatz.

GUI-Titel, Texte und Icon-Materialien sind konfigurierbar. Das Dashboard nutzt einen einheitlichen Hintergrund, erklärende Lore, Abschlussraten und ausdrückliche „Keine Daten“-Zustände, statt interne Nachrichtenschlüssel zu zeigen.

Speicher #

SQLite ist ohne Einrichtung einsatzbereit und der Standard. Um Daten zwischen Servern zu teilen, setze storage.type: MYSQL und fülle den Abschnitt storage.mysql aus. Es funktioniert mit MariaDB (getestet mit 11.8) und mit MySQL-kompatiblen Servern. Das Datenbankkonto braucht nur das Recht, Tabellen anzulegen und Zeilen in seiner eigenen Datenbank zu lesen, einzufügen, zu aktualisieren und zu löschen. Speicheränderungen erfordern einen Neustart; gewöhnliche Änderungen an Konfiguration, Sprache und Reisen werden live neu geladen.

Der Datenbankzugriff läuft in einem eigenen Thread. Ein Verbindungsversuch gibt nach 5 Sekunden auf und eine Abfrage nach 15, sodass eine nicht erreichbare Datenbank den Server nicht einfrieren kann. Fortschritt, der nicht gespeichert werden konnte, bleibt im Speicher und wird erneut geschrieben, sobald die Datenbank antwortet, einschließlich des Fortschritts von Spielern, die zwischenzeitlich gegangen sind. Wird der Server selbst gestoppt, während die Datenbank noch nicht erreichbar ist, geht noch nicht geschriebener Fortschritt verloren.

Ist die Datenbank beim Serverstart nicht erreichbar oder wird der Login abgelehnt, protokolliert VelorJourney den Grund und bleibt bis zum nächsten Neustart deaktiviert. Es wird nichts in deine Konfiguration oder Daten geschrieben.

Setze journeys.enabled: false, um VelorJourney als reine Analyse-Installation zu betreiben. Aktivzeit-, Spieler- und Bindungs-Tracking laufen weiter, während automatische Anmeldung, Fortschrittssignale und die Reisemenüs der Spieler stoppen. Bestehender Fortschritt bleibt erhalten und wird fortgesetzt, sobald Reisen wieder aktiviert werden.

Im Spiel #