Menus

Exemplo completo de configuração

Aqui está um exemplo de como configurar os menus do plugin:

# Ativar o sistema de atualizar o menu principal automaticamente enquanto estiver aberto
menu-updater: true
# Tempo para atualizar o menu automaticamente
# em ticks -> 20 ticks = 1s
menu-updater-time: 200

# Setas dos menus.
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.']

Configurações gerais

Ativa o sistema de atualização automática do menu principal.

menu-updater: true

Define o tempo de atualização do menu em ticks (20 ticks = 1 segundo).

menu-updater-time: 200

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'
    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'
    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'
    lore: ['&7Clique para ir à próxima página.']

Menu principal exibido quando os jogadores executam /arena.

Estrutura básica

main:
  name: '&8Arenas'
  size: 27
  items:
    profile-slot: 10
    rewards-slot: 11
    arenas-slot: 13
    top-slot: 14
    go-slot: 16

profile

Exibe informações do perfil do jogador.

Exemplo:

items:
  profile:
    material: '{player}'
    name: '&eSeu Perfil'
    lore:
      - '&7Confira detalhes do seu'
      - '&7desempenho nas arenas.'
      - ''
      - ' &8▶ &fAbates: &a{kills}'
      - ' &8▶ &fMortes: &c{deaths}'
      - ''
      - ' &8▶ &fRank: &r{rank}'
      - ' &8▶ &fPontos: &b{points}'
      - ''

Placeholders disponíveis: {kills}, {deaths}, {rank}, {points}

rewards

Botão para acessar o menu de recompensas.

Exemplo:

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

Placeholder disponível: {amount}

arenas

Botão para acessar o menu de arenas.

Exemplo:

items:
  arenas:
    material: 'd01afe973c5482fdc71e6aa10698833c79c437f21308ea9a1a095746ec274a0f'
    name: '&eArenas'
    lore:
      - '&7Confira aqui as arenas do nosso'
      - '&7servidor e comece já sua batalha!'
      - ''
      - '&6Clique para acessar!'

top

Botão para acessar o menu de TOP jogadores.

Exemplo:

items:
  top:
    material: '4ea96c49302132167c81c87b79e06dd343020ff20923fce87d388c462409261c'
    name: '&aTOP Jogadores'
    lore:
      - '&7Visualize os jogadores que estão'
      - '&7se destacando em nossas arenas.'
      - ''
      - '&aClique para acessar!'

go

Botão para entrar na arena quando o jogador não está em nenhuma.

Exemplo:

items:
  go:
    material: DIAMOND_SWORD
    name: '&aIr batalhar'
    lore:
      - '&7Teleportar para sua arena e começar'
      - '&7a jornada de batalha.'
      - ''
      - ' &fSua arena: &b{arena}&f.'
      - ''
      - '&aClique para ir batalhar'

Placeholder disponível: {arena}

exit

Botão para sair da arena quando o jogador está dentro de uma.

Exemplo:

items:
  exit:
    material: '5fde3bfce2d8cb724de8556e5ec21b7f15f584684ab785214add164be7624b'
    name: '&eSair da arena'
    lore:
      - '&7Terminar sua jornada de batalha'
      - '&7e sair da arena.'
      - ''
      - ' &fArena atual: &b{arena}&f.'
      - ''
      - '&aClique para sair da arena'

Placeholder disponível: {arena}

Menu onde os jogadores podem visualizar e recolher suas recompensas.

main-rewards:
  name: '&8Arenas'
  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.

Exemplo:

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

collect

Botão para recolher todas as recompensas.

Exemplo:

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

Menu que lista todas as arenas disponíveis.

arenas:
  name: '&8Arenas'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  previous-slot: 32
  next-slot: 33
  back-slot: 29

Menu que exibe o ranking de jogadores por arena.

top:
  name: '&8Arenas'
  size: 45
  slots: [ 10, 12, 14, 16 ]
  previous-slot: 33
  next-slot: 34
  back-slot: 28

Menu para administradores gerenciarem as arenas.

manage:
  name: '&8Gerenciar Arena'
  size: 27
  items:
    locations-slot: 10
    kits-slot: 12

locations

Botão para gerenciar os locais de spawn da arena.

Exemplo:

items:
  locations:
    material: 'PAPER'
    name: '&aLocais'
    lore:
      - ''
      - ' &fLocais cadastrados: &a{amount}&f.'
      - ''
      - '&7Clique para gerenciar'

Placeholder disponível: {amount}

kits

Botão para gerenciar os kits da arena.

Exemplo:

items:
  kits:
    material: 'PAPER'
    name: '&aKits'
    lore:
      - ''
      - ' &fKits cadastrados: &a{amount}&f.'
      - ''
      - '&7Clique para gerenciar'

Placeholder disponível: {amount}

Menu para adicionar e remover locais de spawn.

locations:
  name: '&8Gerenciar Arena'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24, 29, 30, 31, 32, 33 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 47
  items:
    add-slot: 49

location

Exibe um local de spawn cadastrado.

Exemplo:

items:
  location:
    material: 'PAPER'
    name: '&aLocal #{location}'
    lore:
      - ''
      - '&fLocalização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
      - ''
      - '&aBotão ESQUERDO para teleportar.'
      - '&aBotão Q para deletar.'

Placeholders disponíveis: {location}, {x}, {y}, {z}, {world}

add

Botão para adicionar um novo local.

Exemplo:

items:
  add:
    material: '924757bc9a3171f9d0fdfbd209ac42e15f7744eb5f2db31920ff8af8d94567c6'
    name: '&aAdicionar Local'
    lore: [ '&7Clique para adicionar mais', '&7um local nesta arena.' ]

Menu para adicionar e gerenciar kits.

kits:
  name: '&8Gerenciar Arena'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24, 29, 30, 31, 32, 33 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 47
  items:
    add-slot: 49

kit

Exibe um kit cadastrado.

Exemplo:

items:
  kit:
    material: 'PAPER'
    name: '&aKit &e#{order}'
    lore:
      - ''
      - ' &fOrdem: &e{order}'
      - ' &fPermissão: &e{permission}'
      - ''
      - '&aBotão &fESQUERDO&a para gerenciar.'
      - '&aBotão &fDIREITO&a para pré-visualizar.'
      - '&aBotão &fQ&a para deletar.'

Placeholders disponíveis: {order}, {permission}

add

Botão para adicionar um novo kit.

Exemplo:

items:
  add:
    material: '924757bc9a3171f9d0fdfbd209ac42e15f7744eb5f2db31920ff8af8d94567c6'
    name: '&aAdicionar Kit'
    lore: [ '&7Clique para adicionar mais', '&7um kit nesta arena.', '', '&f* &8(Necessário estar com os itens)', '' ]

Menu para editar as propriedades de um kit.

options:
  name: '&8Gerenciar Arena'
  size: 27
  back-slot: 10
  items:
    order-slot: 12
    permission-slot: 14

order

Opção para alterar a ordem do kit.

Exemplo:

items:
  order:
    material: 'e4d49bae95c790c3b1ff5b2f01052a714d6185481d5b1c85930b3f99d2321674'
    name: '&aOrdem'
    lore:
      - '&7A ordem serve para classificar os kits'
      - '&7de acordo com sua permissão. Assim dando'
      - '&7o melhor kit que o jogador tem direito.'
      - ''
      - '&fOrdem: &7{order}&f.'
      - ''
      - '&aClique para alterar a ordem'

Placeholder disponível: {order}

permission

Opção para alterar a permissão do kit.

Exemplo:

items:
  permission:
    material: 'e4d49bae95c790c3b1ff5b2f01052a714d6185481d5b1c85930b3f99d2321674'
    name: '&aPermissão'
    lore:
      - '&7Permissão para obter esse kit ao'
      - '&7entrar na arena.'
      - ''
      - '&fPermissão: &7{permission}&f.'
      - ''
      - '&aBotão &fESQUERDO&a para alterar a permissão'
      - '&aBotão &fDIREITO&a para remover a permissão'

Placeholder disponível: {permission}

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Arenas'

size

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

Exemplo:

size: 27

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

slots

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

Exemplo:

slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]

back-slot

Define o slot onde o botão de voltar será exibido.

Exemplo:

back-slot: 49

previous-slot

Define o slot onde o botão de página anterior será exibido.

Exemplo:

previous-slot: 18

next-slot

Define o slot onde o botão de próxima página será exibido.

Exemplo:

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