Arquivos de jornada

Arquivos de jornada #

Cada arquivo YAML em journeys/ define uma jornada. A jornada ativa de maior prioridade que corresponde a um gatilho de inscrição é selecionada. A jornada da primeira hora incluída usa FIRST_JOIN, então instalar o plugin não inscreve jogadores que já jogaram no servidor.

Gatilhos de progresso aceitos:

FIRST_JOIN, JOIN
ACTIVE_PLAYTIME, MOVE_DISTANCE
BLOCK_BREAK, BLOCK_PLACE, ITEM_CRAFT
ENTITY_KILL, PLAYER_KILL, DEATH
COMMAND, CHAT, ADVANCEMENT
CLICK para uma interação deliberada com um menu

Cada etapa pode definir seus próprios icon, slot, display-name, lore e click-actions. Uma jornada também pode definir um menu de 9-54 slots com cabeçalho e itens de status personalizados. Arquivos de jornada sem esses campos usam o layout automático.

Use match para restringir etapas guiadas por eventos a um valor específico. A comparação ignora maiúsculas e minúsculas, aceita um valor ou uma lista e ignora o prefixo minecraft: nas chaves do 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 um cartão de guia que se conclui com um clique, use trigger: CLICK e target: 1. Uma ação de clique com comando de jogador que falha não conclui uma etapa CLICK. Coloque [close] antes de um comando que abre outro inventário.

Ações aceitas:

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

Gatilhos inválidos, ordens de etapa duplicadas, lembretes inválidos e ações desconhecidas são recusados com o nome do arquivo e o motivo, sem substituir a configuração que está funcionando.

Um config.yml de um VelorJourney mais antigo é atualizado para a versão atual preservando seus valores, comentários e seções desconhecidas. O original é guardado como config.yml.bak-v1 antes de a substituição ser gravada. Os arquivos de jornada e de idioma existentes nunca são sobrescritos. Um config.yml de uma versão mais nova é recusado e deixado intocado.