Reisedateien

Reisedateien #

Jede YAML-Datei in journeys/ definiert eine Reise. Es wird die aktive Reise mit der höchsten Priorität gewählt, die zu einem Anmelde-Auslöser passt. Die mitgelieferte Reise der ersten Stunde nutzt FIRST_JOIN, sodass die Installation des Plugins Spieler, die bereits auf dem Server gespielt haben, nicht anmeldet.

Unterstützte Fortschritts-Auslöser:

FIRST_JOIN, JOIN
ACTIVE_PLAYTIME, MOVE_DISTANCE
BLOCK_BREAK, BLOCK_PLACE, ITEM_CRAFT
ENTITY_KILL, PLAYER_KILL, DEATH
COMMAND, CHAT, ADVANCEMENT
CLICK für eine bewusste Menü-Interaktion

Jeder Schritt kann eigene icon, slot, display-name, lore und click-actions definieren. Eine Reise kann außerdem ein menu mit 9-54 Slots mit eigener Kopfzeile und Statusgegenständen definieren. Reisedateien ohne diese Felder nutzen das automatische Layout.

Verwende match, um ereignisgesteuerte Schritte auf einen bestimmten Wert zu beschränken. Der Abgleich ignoriert Groß-/Kleinschreibung, akzeptiert einen Wert oder eine Liste und ignoriert das Präfix minecraft: bei Vanilla-Schlüsseln.

yaml

steps:
  visit_spawn:
    order: 1
    title: "Visit Spawn"
    trigger: COMMAND
    target: 1
    match: [spawn, hub]
    icon: COMPASS
    slot: 20
    display-name: "&bStep 1 &f- Visit Spawn"
    lore:
      - "&7Use the server's spawn command."
    click-actions:
      - "[close]"
      - "[player] spawn"

Für eine Anleitungskarte, die per Klick abgeschlossen wird, verwende trigger: CLICK und target: 1. Eine fehlgeschlagene Klickaktion mit Spielerbefehl schließt einen CLICK-Schritt nicht ab. Setze [close] vor einen Befehl, der ein anderes Inventar öffnet.

Unterstützte Aktionen:

[message] text
[actionbar] text
[title] title|subtitle
[sound] ENTITY_EXPERIENCE_ORB_PICKUP 1 1
[player] command
[console] command {player}
[close]

Ungültige Auslöser, doppelte Schrittreihenfolgen, ungültige Erinnerungen und unbekannte Aktionen werden mit Dateiname und Grund abgelehnt, ohne die funktionierende Konfiguration zu ersetzen.

Eine config.yml aus einem älteren VelorJourney wird auf die aktuelle Version aktualisiert, wobei deine Werte, Kommentare und unbekannten Abschnitte erhalten bleiben. Das Original wird vor dem Schreiben der Ersetzung als config.yml.bak-v1 gespeichert. Bestehende Reise- und Sprachdateien werden nie überschrieben. Eine config.yml aus einer neueren Version wird abgelehnt und unangetastet gelassen.