Menus

Personalize a lista de dragões, o ranking, o armazém e o preview de recompensas.

O arquivo menus.yml define os títulos, os slots, os botões e os itens dos menus do yDragon.

Exemplo completo de configuração

#
#    /\/\   ___ _ __  _   _ ___
#   /    \ / _ \ '_ \| | | / __|
#  / /\/\ \  __/ | | | |_| \__ \
#  \/    \/\___|_| |_|\__,_|___/
#
# Sistema de menus.

# Setas dos menus.
arrows:
  back:
    material: 'ARROW:0'
    name: '&c« Voltar'
    lore:
      - ''
      - ' &7Clique para voltar.'
      - ''
  previous:
    material: 'ARROW:0'
    name: '&d« Anterior'
    lore:
      - ''
      - ' &7Clique para ir à página anterior.'
      - ''
  next:
    material: 'ARROW:0'
    name: '&dPróximo »'
    lore:
      - ''
      - ' &7Clique para ir à próxima página.'
      - ''

dragon-list:
  name: '&5&l✦ &dDragões &5&l✦'
  size: 54
  slots: [ 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34 ]
  previous-slot: 48
  next-slot: 50
  back-slot: -1
  ranking-button:
    slot: 51
    material: GOLD_INGOT
    name: '&6&l✦ Ranking'
    lore:
      - ''
      - ' &7Os jogadores que mais causaram'
      - ' &7dano nos dragões do servidor.'
      - ''
      - ' &e▶ Clique para abrir'
      - ''
  rewards-button:
    slot: 47
    material: CHEST
    name: '&e&l✦ Armazém'
    lore:
      - ''
      - ' &7Recolha as recompensas'
      - ' &7ganhas nas batalhas.'
      - ''
      - ' &e▶ Clique para abrir'
      - ''
  info-button:
    slot: 49
    material: ENDER_PEARL
    name: '&d&l✦ Evento Atual'
    lore:
      - ''
      - ' &7Status: &f{status}'
      - ' &7Dragão: &d{dragon}'
      - ''
      - ' &7Próximo spawn: &f{next}'
      - ''
  dragon-item:
    material: DRAGON_EGG
    name: '&5&l{name}'
    lore:
      - ''
      - ' &8▪ &7Vida: &c{health}'
      - ' &8▪ &7Dano: &c{damage}'
      - ' &8▪ &7Raro: &f{rare}'
      - ''
      - ' &8▪ &7Próximo: &f{next}'
      - ''
      - ' &e▶ Clique para ver as recompensas'
      - ''

ranking:
  name: '&6&l✦ &eRanking &6&l✦'
  size: 54
  slots: [ 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34 ]
  previous-slot: 48
  next-slot: 50
  back-slot: 45
  player-item:
    material: '{player}'
    name: '&6#{position} &f{player}'
    lore:
      - ''
      - ' &8▪ &7Dano total: &c{damage}'
      - ' &8▪ &7Abates: &f{kills}'
      - ' &8▪ &eTop 1: &f{top1}'
      - ' &8▪ &7Top 2: &f{top2}'
      - ' &8▪ &6Top 3: &f{top3}'
      - ''

main-rewards:
  name: '&6&l✦ &eArmazém &6&l✦'
  size: 54
  slots: [ 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34 ]
  previous-slot: 48
  next-slot: 50
  back-slot: 45
  empty-slot: 22
  collect-slot: 49
  items:
    empty:
      material: 'WEB'
      name: '&eVazio...'
      lore:
        - ''
        - ' &7Nenhuma recompensa para coletar.'
        - ''
    collect:
      material: 'HOPPER'
      name: '&a&l✦ Recolher tudo'
      lore:
        - ''
        - ' &7Clique para recolher'
        - ' &7todas as recompensas.'
        - ''
        - ' &a▶ Clique para coletar'
        - ''

rewards-preview:
  name: '&5&l✦ &d{name} &5&l✦'
  size: 54
  slots: [ 10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34 ]
  previous-slot: 48
  next-slot: 50
  back-slot: 45

Opções comuns dos menus

Opção	Descrição
`name`	Título exibido no topo do menu. Aceita códigos de cor com `&`.
`size`	Quantidade de slots do inventário. Os quatro menus fornecidos usam `54`.
`slots`	Posições utilizadas pelos itens da lista paginada.
`previous-slot`	Posição da seta de página anterior.
`next-slot`	Posição da seta de próxima página.
`back-slot`	Posição do botão de voltar. A lista principal usa `-1`, sem botão de retorno.

Os slots começam em 0. Nos menus de 54 slots, a última posição é 53.

arrows

Define as setas compartilhadas pelos menus: back volta ao menu anterior, previous muda para a página anterior e next avança a página. Cada item possui material, name e lore.

O nome das setas previous e next aceita <page>, que mostra o número da página de destino.

dragon-list

Menu aberto por /dragon. Cada dragão listado permite acessar o preview das suas recompensas.

ranking-button: botão de acesso ao ranking, no slot 51.
rewards-button: botão de acesso ao armazém, no slot 47.
info-button: informações do evento e do próximo spawn, no slot 49.
dragon-item: modelo do item de cada dragão na listagem.

Os três botões possuem slot, material, name e lore. O modelo dragon-item possui material, name e lore.

No nome e na lore de dragon-item, estão disponíveis {name}, {key}, {health}, {damage}, {rare}, {mode} e {next}. Em info-button, use {status}, {dragon} e {next}.

ranking

Menu aberto por /dragon top, ordenado pelo dano acumulado registrado para os jogadores. O modelo player-item define material, name e lore do item de cada jogador.

Use {player}, {position}, {damage}, {kills}, {top1}, {top2} e {top3} no nome e na lore. O material fornecido também usa {player} para representar o jogador.

O contador {kills}, exibido como “Abates” na lore padrão, é incrementado quando o jogador termina a batalha em primeiro lugar no dano.

main-rewards

Armazém pessoal aberto por /dragon armazem.

Opção	Descrição
`empty-slot`	Posição do item de armazém vazio, por padrão `22`.
`collect-slot`	Posição do botão de recolher tudo, por padrão `49`.
`items.empty`	Item exibido quando não há recompensas para recolher.
`items.collect`	Botão para recolher as recompensas armazenadas.

Os itens empty e collect possuem material, name e lore. A aparência de cada recompensa armazenada fica em rewards.<id>.collect, no arquivo rewards.yml.

A coleta respeita as opções limit da config.yml. A exclusão com botão direito é controlada por general.right-delete-reward.

rewards-preview

Menu que exibe as recompensas do dragão selecionado. O título aceita {name}, com o nome do dragão. Os itens exibidos são definidos em rewards.<id>.preview no catálogo de recompensas.

Consulte Placeholders para conferir os valores aceitos em cada contexto.