Menus

Exemplo completo de configuração

Aqui está um exemplo das principais seções de menus do plugin:

arrows:
  back:
    material: 'ARROW:0'
    name: '&cVoltar'
    lore: ['&7Clique para voltar ao menu anterior.']
  previous:
    material: 'ARROW:0'
    name: '&cAnterior'
    lore: ['&7Clique para ir à página anterior.']
  next:
    material: 'ARROW:0'
    name: '&aPróximo'
    lore: ['&7Clique para ir à próxima página.']

main:
  name: '&8Clan X Clan'
  size: 36
  items:
    rewards-slot: 11
    battles-slot: 13
    top-slot: 15
    stats-slot: 20
    history-slot: 22

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

arrows

Configuração dos botões de navegação usados em todos os menus.

back

Botão para voltar ao menu anterior.

Exemplo:

arrows:
  back:
    material: 'ARROW:0'
    name: '&cVoltar'
    flags: ['*']
    lore: ['&7Clique para voltar ao menu anterior.']

Botão para ir à página anterior em menus paginados.

Exemplo:

arrows:
  previous:
    material: 'ARROW:0'
    name: '&cAnterior'
    flags: ['*']
    lore: ['&7Clique para ir à página anterior.']

Botão para ir à próxima página em menus paginados.

Exemplo:

arrows:
  next:
    material: 'ARROW:0'
    name: '&aPróximo'
    flags: ['*']
    lore: ['&7Clique para ir à próxima página.']

Menu exibido ao executar /clanxclan. Apresenta um resumo do status do jogador e acesso às principais funcionalidades.

main:
  name: '&8Clan X Clan'
  size: 36
  items:
    rewards-slot: 11
    battles-slot: 13
    top-slot: 15
    stats-slot: 20
    history-slot: 22

rewards

Exibe o número de recompensas disponíveis no armazém.

Exemplo:

items:
  rewards:
    material: 'CHEST'
    name: '&aRecompensas'
    flags: ['*']
    lore:
      - ''
      - ' &fRecompensas no armazém: &a{rewards}&f.'
      - ''
      - '&7Clique para gerenciar'

Placeholder disponível: {rewards} - Número de recompensas pendentes

battles

Acesso ao menu de batalhas e desafios.

Exemplo:

items:
  battles:
    material: 'DIAMOND_SWORD'
    name: '&cBatalhas'
    flags: ['*']
    lore:
      - '&7Clique para desafiar outros'
      - '&7clans para uma batalha épica!'
      - ''
      - '&eSeu Rating: &f{rating}'
      - '&eLiga: {league}'

Placeholders disponíveis: {rating} - Rating atual, {league} - Liga atual

top

Acesso ao ranking de clans.

Exemplo:

items:
  top:
    material: '351137e11443a8fbb05fcd3ccc1af9bd2303918f35448185e3ed96ef184da'
    name: '&aTOP Clans'
    flags: ['*']
    lore:
      - '&7Clique para ver os melhores'
      - '&7clans no ranking de batalhas.'
      - ''
      - '&eSua posição: &f#{position}'

stats

Exibe estatísticas detalhadas do clan.

Exemplo:

items:
  stats:
    material: 'BOOK'
    name: '&eEstatísticas'
    flags: ['*']
    enchantments: ['LOOT_BONUS_BLOCKS:1']
    lore:
      - '&fBatalhas totais: &e{total_battles}'
      - '&fVitórias: &a{wins}'
      - '&fDerrotas: &c{losses}'
      - '&fEmpates: &7{draws}'
      - '&fWin Rate: &6{win_rate}%'
      - '&7K/D: &f{kdr}'

history

Acesso ao histórico de batalhas.

Exemplo:

items:
  history:
    material: 'WRITTEN_BOOK'
    name: '&7Histórico'
    flags: ['*']
    lore:
      - '&7Veja o histórico de'
      - '&7suas batalhas anteriores.'
      - ''
      - '&aÚltimas 10 batalhas'

Menu do armazém onde o jogador recolhe as recompensas ganhas em batalhas.

main-rewards:
  name: '&8Clan X Clan'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 16, 19, 21, 22, 23, 24, 25, 28, 29, 31, 32, 33, 34 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 48
  empty-slot: 22
  collect-slot: 50

empty

Exibido quando não há recompensas disponíveis.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&eVazio...'
    flags: ['*']
    lore: [ '&7Nenhuma recompensa para', '&7coletar.' ]

collect

Botão para recolher todas as recompensas de uma vez.

Exemplo:

items:
  collect:
    material: 'a6cc486c2be1cb9dfcb2e53dd9a3e9a883bfadb27cb956f1896d602b4067'
    name: '&eRecolher tudo'
    flags: ['*']
    lore: [ '&7Clique para recolher', '&7todas as recompensas.' ]

Menu central de batalhas. Permite desafiar outros clans e assistir batalhas ativas.

battles:
  name: '&8Batalhas'
  size: 36
  back-slot: 31
  challenge-slot: 11
  active-battles-slot: 15

challenge

Botão para iniciar o processo de desafio.

Exemplo:

items:
  challenge:
    material: '749ac6f41bddd0fb63ca716d08c85aa10cb2f332d62c14a34fc8b4b510397108'
    name: '&aDesafiar Clan'
    flags: ['*']
    lore:
      - '&7Clique para desafiar'
      - '&7outro clan para uma batalha!'

active-battles

Exibe o número de batalhas em andamento.

Exemplo:

items:
  active-battles:
    material: 'bd69e06e5dadfd84e5f3d1c21063f2553b2fa945ee1d4d7152fdc5425bc12a9'
    name: '&eBatalhas Ativas'
    flags: ['*']
    lore:
      - '&7Veja as batalhas que'
      - '&7estão acontecendo agora!'
      - ''
      - '&aBatalhas ativas: &f{active_count}'

Exibe o ranking de clans por rating.

top:
  name: '&8TOP Clans'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  back-slot: 31
  previous-slot: 9
  next-slot: 17

Item de ranking (rating)

Cada clan é representado por um item com seu banner.

Exemplo:

items:
  rating:
    material: '{banner}'
    name: '&7[{clan_tag}&7] &f{clan_name}'
    flags: ['*']
    lore:
      - ''
      - '&fRating: &e{rating}'
      - '&fLiga: {league}'
      - '&fVitórias: &a{wins}'
      - '&fDerrotas: &c{losses}'
      - '&fK/D Ratio: &f{kd_ratio}'
      - '&fPosição: &e{position}º'

Placeholders disponíveis: {banner}, {clan_tag}, {clan_name}, {rating}, {league}, {wins}, {losses}, {kd_ratio}, {position}

Menu para gerenciar desafios recebidos e enviados, e realizar as seleções de modo, kit, habilidade e arena.

challenges:
  name: '&8Desafios'
  size: 45
  slots: [ 20, 21, 22, 23, 24, 25 ]
  back-slot: 38
  pending-slot: 3
  sent-slot: 5
  mode-slot: 39
  kit-slot: 40
  ability-slot: 41
  arena-slot: 42

pending

Botão para acessar desafios recebidos.

Exemplo:

items:
  pending:
    material: 'IRON_SWORD'
    name: '&eDesafios Recebidos'
    flags: ['*']
    enchantments: ['DAMAGE_ALL:1']
    lore:
      - '&7Clique para ver os'
      - '&7desafios que você recebeu!'
      - ''
      - '&aPendentes: &f{pending_count}'

sent

Botão para acessar desafios enviados.

Exemplo:

items:
  sent:
    material: 'DIAMOND_SWORD'
    name: '&cDesafios Enviados'
    flags: ['*']
    enchantments: ['DAMAGE_ALL:2']
    lore:
      - '&7Clique para ver os'
      - '&7desafios que você enviou!'
      - ''
      - '&eEnviados: &f{sent_count}'

mode, kit, ability, arena

Botões de seleção que exibem a escolha atual e permitem alterá-la.

Exemplo:

items:
  mode:
    material: 'DIAMOND_PICKAXE'
    name: '&aModo de Jogo'
    flags: ['*']
    lore:
      - ''
      - '&7Modo selecionado:'
      - '&f{mode}'
      - ''
      - '&eClique para mudar!'
  kit:
    material: 'CHEST'
    name: '&aKit de Batalha'
    lore:
      - '&7Kit selecionado:'
      - '&f{kit}'
  ability:
    material: 'BREWING_STAND_ITEM'
    name: '&aHabilidade do Clan'
    lore:
      - '&7Habilidade selecionada:'
      - '&f{ability}'
  arena:
    material: 'GRASS_BLOCK'
    name: '&aArena de Batalha'
    lore:
      - '&7Arena selecionada:'
      - '&f{arena}'

Lista de todos os desafios recebidos pelo clan.

received-challenges:
  name: '&8Desafios Recebidos'
  size: 45
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40

challenge-item (desafio recebido)

Cada desafio recebido é representado por um item com informações do clan desafiante.

Exemplo:

challenge-item:
  material: 'IRON_SWORD'
  name: '&eDesafio de &f{challenger_tag}'
  flags: ['*']
  enchantments: ['DAMAGE_ALL:1']
  lore:
    - ''
    - '&7Clan: &f{challenger_name}'
    - '&7Rating: &e{challenger_rating}'
    - '&7Liga: {challenger_league}'
    - ''
    - '&7Modo: &f{mode}'
    - '&7Kit: &f{kit}'
    - '&7Habilidade: &f{ability}'
    - ''
    - '&7Recebido: &f{received_time}'
    - '&7Expira em: &c{expires_in}'
    - ''
    - '&aClique esquerdo para aceitar'
    - '&cClique direito para recusar'

Lista de todos os desafios enviados pelo clan.

sent-challenges:
  name: '&8Desafios Enviados'
  size: 45
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40

challenge-item (desafio enviado)

Exemplo:

challenge-item:
  material: 'DIAMOND_SWORD'
  name: '&cDesafio para &f{challenged_tag}'
  lore:
    - '&7Clan: &f{challenged_name}'
    - '&7Modo: &f{mode}'
    - '&7Enviado: &f{sent_time}'
    - '&7Expira em: &c{expires_in}'
    - ''
    - '&cClique para cancelar'

Permite escolher a arena para a batalha.

arena-selection:
  name: '&8Selecione uma Arena'
  size: 45
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40
  random-slot: 4

Itens de arena

random

Botão para seleção aleatória de arena disponível.

Exemplo:

items:
  random:
    material: 'ENDER_EYE'
    name: '&dArena Aleatória'
    flags: ['*']
    enchantments: ['DURABILITY:1']
    lore:
      - '&7Clique para selecionar'
      - '&7uma arena aleatória!'
      - ''
      - '&aArenas disponíveis: &f{available_count}'

arena-available, arena-occupied, arena-disabled, arena-selected

Quatro variantes do item de arena de acordo com seu status:

items:
  arena-available:
    material: 'GRASS_BLOCK'
    name: '&a{arena_name}'
    lore:
      - '&fCapacidade: &e{min_players}-{max_players} jogadores'
      - '&fStatus: &aDisponível'
      - '&aClique para selecionar!'
  arena-occupied:
    material: 'GRAY_STAINED_GLASS_PANE'
    name: '&c{arena_name}'
    lore:
      - '&fStatus: &cOcupada'
      - '&cArena indisponível!'
  arena-disabled:
    material: 'BARRIER'
    name: '&8{arena_name}'
    lore:
      - '&fStatus: &7Desabilitada'
  arena-selected:
    material: 'GRASS_BLOCK'
    name: '&a&l{arena_name} &a(Selecionada)'
    lore:
      - '&a✔ Arena selecionada!'
      - '&7Clique para desselecionar.'

Permite ao líder/capitão escolher quais membros online participarão da batalha.

member-selection:
  name: '&8Selecionar Membros ({selected}/{max})'
  size: 54
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34 ]
  info-slot: 4
  confirm-slot: 48
  cancel-slot: 50
  select-all-slot: 45
  clear-all-slot: 53
  no-members-slot: 22

items:
  info:
    material: 'PAPER'
    name: '&eInformações da Batalha'
    lore:
      - '&7Oponente: &f{clan}'
      - '&7Modo: &f{mode}'
      - '&7Máx. membros: &f{max}'
      - '&7Selecionados: &e{selected}&7/&e{max}'
  confirm:
    material: 'EMERALD_BLOCK'
    name: '&aConfirmar Seleção'
    lore:
      - '&7Clique para iniciar a batalha'
      - '&7com os membros selecionados'
  cancel:
    material: 'REDSTONE_BLOCK'
    name: '&cCancelar'
    lore:
      - '&7Cancelar criação da batalha'
  select-all:
    material: 'LIME_STAINED_GLASS_PANE'
    name: '&aSelecionar Todos'
  clear-all:
    material: 'RED_STAINED_GLASS_PANE'
    name: '&cLimpar Seleção'
  member-selected:
    name: '&a✓ {player}'
    lore:
      - '&aJá selecionado'
      - '&7Clique para remover'
  member-not-selected:
    name: '&7{player}'
    lore:
      - '&7Clique para selecionar'

Exibe os kits disponíveis para seleção.

kits:
  name: '&8Kits de Batalha'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  back-slot: 31
  previous-slot: 18
  next-slot: 26
  clear-slot: 22
  own-items-slot: 4

own-items

Permite ao jogador usar seus próprios itens do inventário.

Exemplo:

items:
  own-items:
    material: 'LEATHER_CHESTPLATE'
    name: '&6Itens Próprios'
    flags: ['*']
    lore:
      - '&7Use seus próprios itens'
      - '&7do inventário na batalha!'
      - ''
      - '&c⚠ Não válido para CTF'
      - ''
      - '&eClique para selecionar!'

A opção de itens próprios não é válida para o modo Capturar Bandeira (CTF), que exige a seleção de um kit.

Exibe as habilidades disponíveis para seleção.

abilities:
  name: '&8Habilidades do Clan'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 31
  clear-slot: 22

Exibe os modos de batalha disponíveis para seleção.

modes:
  name: '&8Modos de Batalha'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 31
  clear-slot: 22

Exibe o histórico de batalhas do clan.

history:
  name: '&8Histórico de Batalhas'
  size: 45
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40

history-item

Cada batalha do histórico é representada por um livro com detalhes.

Exemplo:

history-item:
  material: 'WRITTEN_BOOK'
  name: '&7Batalha #{battle_id}'
  flags: ['*']
  lore:
    - ''
    - '&7Oponente: &f{opponent}'
    - '&7Resultado: {result}'
    - '&7Data: &7{date}'
    - '&7Modo: &f{mode}'
    - ''
    - '&aClique para detalhes!'

Exibido ao clan desafiado para confirmar kit e habilidade antes de aceitar.

accept-preparation:
  name: '&8Preparar para Batalha'
  size: 27
  kit-slot: 11
  ability-slot: 15
  confirm-slot: 22
  cancel-slot: 18

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Clan X Clan'

size

Define o tamanho do menu (deve ser múltiplo de 9, máximo 54).

Exemplo:

size: 36

Valores válidos: 9, 18, 27, 36, 45, 54

slots

Define os slots onde os itens principais serão exibidos.

Exemplo:

slots: [ 10, 11, 12, 13, 14, 15, 16 ]

back-slot / previous-slot / next-slot

Define os slots dos botões de navegação.

Exemplo:

back-slot: 31
previous-slot: 18
next-slot: 26

Os slots começam em 0 (canto superior esquerdo) e vão até 53 (canto inferior direito em um menu de tamanho 54).

Nesta página