Archivos de viaje

Archivos de viaje #

Cada archivo YAML de journeys/ define un viaje. Se selecciona el viaje activo de mayor prioridad que coincide con un activador de inscripción. El viaje de la primera hora incluido usa FIRST_JOIN, así que instalar el plugin no inscribe a los jugadores que ya jugaron en el servidor.

Activadores de progreso admitidos:

FIRST_JOIN, JOIN
ACTIVE_PLAYTIME, MOVE_DISTANCE
BLOCK_BREAK, BLOCK_PLACE, ITEM_CRAFT
ENTITY_KILL, PLAYER_KILL, DEATH
COMMAND, CHAT, ADVANCEMENT
CLICK para una interacción deliberada con un menú

Cada paso puede definir su propio icon, slot, display-name, lore y click-actions. Un viaje también puede definir un menu de 9-54 ranuras con una cabecera y elementos de estado personalizados. Los archivos de viaje sin estos campos usan el diseño automático.

Usa match para restringir los pasos basados en eventos a un valor concreto. La comparación no distingue mayúsculas, acepta un valor o una lista e ignora el prefijo minecraft: en las claves de 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"

Para una tarjeta de guía que se completa con un clic, usa trigger: CLICK y target: 1. Una acción de clic con comando de jugador fallida no completa un paso CLICK. Pon [close] antes de un comando que abra otro inventario.

Acciones admitidas:

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

Los activadores no válidos, los órdenes de paso duplicados, los recordatorios no válidos y las acciones desconocidas se rechazan con el nombre del archivo y el motivo, sin reemplazar la configuración que funciona.

Un config.yml de un VelorJourney anterior se actualiza a la versión actual conservando tus valores, comentarios y secciones desconocidas. El original se guarda como config.yml.bak-v1 antes de escribir el reemplazo. Los archivos de viaje y de idioma existentes nunca se sobrescriben. Un config.yml de una versión más reciente se rechaza y se deja intacto.