Missões

Estrutura de arquivos

As missões são criadas em arquivos separados dentro da pasta goals/. Cada arquivo representa uma missão específica.

spawners.yml

mineracao.yml

combate.yml

Exemplo completo de configuração

Aqui está um exemplo de como configurar uma missão:

# Ordem da missão
# começa em 1
order: 1

# Nome nas mensagens
display-name: '&aSpawners 1'

# Categoria da missão
# criada na categories.yml
category: 'spawners'

# Data de liberação. Formato: dd/MM/yyyy-HH:mm
# Use '0' para liberar imediatamente
Libera em: '0'

# Ícones nos menus
displays:
  # Ícone de missão atual
  current:
    material: 'MOB_SPAWNER'
    glow: true
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&f *Progresso: &a{yspawners_actual}&7/&c{yspawners_total} &8({yspawners_percentage})'
      - '&f -> &7[{yspawners_progressbar}&7]'
      - ''
      - '&aIniciada em: &7{start_date} às {start_hour}'
      - ''
  # Ícone de missão atual (no menu principal)
  current-main:
    material: 'MOB_SPAWNER'
    name: '&aMetas de Spawners'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fMOBS&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&f *Progresso: &a{yspawners_actual}&7/&c{yspawners_total} &8({yspawners_percentage})'
      - '&f -> &7[{yspawners_progressbar}&7]'
      - ''
      - '&aIniciada em: &7{start_date} às {start_hour}'
      - ''
      - '&aClique para ver mais informações.'
  # Ícone de próxima missão
  next:
    material: 'BARRIER'
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&c*Essa missão ainda não foi liberada.'
      - '&cConclua a anterior.'
      - ''
  # Ícone de missão bloqueada por data
  locked:
    material: 'BARRIER'
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&c*Essa missão ainda não foi liberada.'
      - '&7Ela será liberada em: &f{data} - &f{hora}'
      - '&7Tempo para liberar: &f{time_formatted}'
      - ''
  # Ícone de missão bloqueada por data (no menu principal)
  locked-main:
    material: 'BARRIER'
    name: '&aMetas de Spawners'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fMOBS&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&c*Essa missão ainda não foi liberada.'
      - '&7Ela será liberada em: &f{data} - &f{hora}'
      - '&7Tempo para liberar: &f{time_formatted}'
      - ''
      - '&aClique para ver mais informações.'
  # Ícone de missão concluída
  completed:
    material: 'MOB_SPAWNER'
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&c*Essa missão já foi concluída.'
      - '&cConcluída em: &7{end_date} às {end_hour}'
      - ''
  # Ícone de missão concluída (com recompensa para coletar)
  to-collect:
    material: 'MOB_SPAWNER'
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - '&7dessa missão.'
      - ''
      - '&c*Essa missão já foi concluída.'
      - '&cConcluída em: &7{end_date} às {end_hour}'
      - ''
      - '&aClique para coletar sua recompensa.'

# Mensagens da missão
messages:
  start:
    chat: '<nl>&a&l[MISSÃO]&a A missão &eSPAWNERS 1&a foi iniciada. &aAcesse em: &f/missoes&e.'
    actionbar: ''
    title: ''
  finish:
    chat: '<nl>&a&l[MISSÃO]&a A missão &eSPAWNERS 1&a foi concluída, resgate sua recompensa em &f/missoes&e.'
    actionbar: ''
    title: ''

# Objetivos dessa missão
goals:
  yspawners:
    # Tipo do objetivo
    # disponível em: goals.txt
    goal-type: 'KILL_MOBS'
    # Tipos necessários
    types:
      type1:
        # (Material / Entidade / config-key) necessária
        # Para permitir todos os blocos (materiais): ALL_BLOCKS
        # Para permitir todas entidades: ALL_ENTITIES
        # caso não for uma missão de blocos ou entidades, deixe ALL ou a config-key
        type: 'ALL_ENTITIES'
        # Quantidade necessária
        amount: 100.0

# Sistema de recompensas
milestones:
  reward1:
    # Progresso (%) necessário para liberar cada recompensa
    progress: 25.0
    # chance,recompensa
    rewards: [ '100.0,reward1' ]
  reward2:
    progress: 50.0
    rewards: [ '100.0,reward2' ]
  reward3:
    progress: 100.0
    rewards: [ '100.0,reward3' ]

# Sistema de anúncios
announces:
  announce1:
    # Progresso (%) necessário para liberar cada anúncio
    progress: 25.0
    # Mensagem na actionbar
    actionbar: ''
    # Mensagem no título e subtítulo
    title: ''
    # Mensagem no chat
    chat: |
      &r
      &a&l[MISSÕES]&a A missão &eSPAWNERS 1&a está com um progresso de 25%!
      &r
  announce2:
    progress: 50.0
    actionbar: ''
    title: ''
    chat: |
      &r
      &a&l[MISSÕES]&a A missão &eSPAWNERS 1&a está com um progresso de 50%!
      &r

Opções disponíveis na configuração

order

Define a ordem da missão na categoria. Começa em 1.

Exemplo:

order: 1

display-name

Nome da missão exibido nas mensagens.

Exemplo:

display-name: '&aSpawners 1'

displays

Configuração dos ícones da missão em diferentes estados.

current

Ícone quando a missão está em andamento.

Exemplo:

displays:
  current:
    material: 'MOB_SPAWNER'
    glow: true
    name: '&aSpawners &eMETA 1'
    lore:
      - '&7Os jogadores do servidor precisarão'
      - '&7matar &fVacas&7 para ajudar no progresso'
      - ''
      - '&f *Progresso: &a{yspawners_actual}&7/&c{yspawners_total}'

Placeholders disponíveis: {goal_actual}, {goal_total}, {goal_percentage}, {goal_progressbar}, {start_date}, {start_hour}

current-main

Ícone quando a missão está em andamento (menu principal).

Ícone quando a missão ainda não foi liberada.

completed

Ícone quando a missão foi concluída.

Placeholders disponíveis: {end_date}, {end_hour}

to-collect

Ícone quando a missão foi concluída e há recompensas para coletar.

messages

Mensagens da missão.

Exemplo:

messages:
  start:
    chat: '<nl>&a&l[MISSÃO]&a A missão foi iniciada.'
    actionbar: ''
    title: ''
  finish:
    chat: '<nl>&a&l[MISSÃO]&a A missão foi concluída.'
    actionbar: ''
    title: ''

Use <nl> para quebrar linha em títulos.

goals

Objetivos da missão. Você pode criar múltiplos objetivos para cada missão.

Exemplo:

goals:
  identificador:
    goal-type: 'KILL_MOBS'
    types:
      type1:
        type: 'ALL_ENTITIES'
        amount: 100.0

Tipos de objetivos disponíveis

Os tipos de objetivos estão listados no arquivo goals.txt:

KILL_MOBS - Matar mobs (incluindo ySpawners e Vanilla)
KILL_PLAYERS - Matar jogadores
DEATH - Morrer
CRAFT_ITEM - Craftar itens
BREAK_BLOCKS - Quebrar blocos normais
PLACE_BLOCKS - Colocar blocos normais
WALK - Andar blocos
YMINAS - Quebrar blocos em minas (yMinas)
YMINASPACKETS - Quebrar blocos em minas (yMinasPackets)
YCAMPO - Quebrar plantas em farms (yCampos)
YPLANTACOES - Quebrar plantas em plot (yPlantacoes)
YPESCA - Pescar peixes (yPesca)
YPESCASIMPLES - Pescar recompensas (yPescaSimples)
YBOSSES - Matar bosses (yBosses)
YSTACKBOSSES - Matar stack de bosses (yStackBosses)

milestones

Sistema de recompensas por progresso.

Exemplo:

milestones:
  reward1:
    progress: 25.0
    rewards: [ '100.0,reward1' ]
  reward2:
    progress: 50.0
    rewards: [ '100.0,reward2' ]
  reward3:
    progress: 100.0
    rewards: [ '100.0,reward3' ]

O formato é chance,recompensa onde chance é de 0.0 a 100.0 e recompensa é o ID definido em rewards.yml.

announces

Sistema de anúncios por progresso.

Exemplo:

announces:
  announce1:
    progress: 25.0
    actionbar: ''
    title: ''
    chat: |
      &r
      &a&l[MISSÕES]&a A missão está com 25% de progresso!
      &r