Fichiers de parcours

Fichiers de parcours #

Chaque fichier YAML de journeys/ définit un parcours. Le parcours actif de plus haute priorité correspondant à un déclencheur d'inscription est sélectionné. Le parcours de la première heure fourni utilise FIRST_JOIN, si bien que l'installation du plugin n'inscrit pas les joueurs qui ont déjà joué sur le serveur.

Déclencheurs de progression pris en charge :

FIRST_JOIN, JOIN
ACTIVE_PLAYTIME, MOVE_DISTANCE
BLOCK_BREAK, BLOCK_PLACE, ITEM_CRAFT
ENTITY_KILL, PLAYER_KILL, DEATH
COMMAND, CHAT, ADVANCEMENT
CLICK pour une interaction délibérée avec un menu

Chaque étape peut définir ses propres icon, slot, display-name, lore et click-actions. Un parcours peut aussi définir un menu de 9 à 54 emplacements avec un en-tête et des objets d'état personnalisés. Les fichiers de parcours sans ces champs utilisent la disposition automatique.

Utilisez match pour restreindre les étapes pilotées par des événements à une valeur particulière. La comparaison ne tient pas compte de la casse, accepte une valeur ou une liste, et ignore le préfixe minecraft: pour les clés vanilla.

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"

Pour une carte de guide qui se valide d'un clic, utilisez trigger: CLICK et target: 1. Une action de clic avec commande de joueur qui échoue ne valide pas une étape CLICK. Placez [close] avant une commande qui ouvre un autre inventaire.

Actions prises en charge :

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

Les déclencheurs invalides, les ordres d'étape en double, les rappels invalides et les actions inconnues sont refusés avec le nom du fichier et la raison, sans remplacer la configuration qui fonctionne.

Un config.yml issu d'une ancienne version de VelorJourney est mis à niveau vers la version actuelle en conservant vos valeurs, vos commentaires et vos sections inconnues. L'original est conservé sous le nom config.yml.bak-v1 avant l'écriture du remplaçant. Les fichiers de parcours et de langue existants ne sont jamais écrasés. Un config.yml issu d'une version plus récente est refusé et laissé intact.