Menus

Exemplo completo de configuração

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

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

# 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: 20

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

Sistema de atualização automática

Ativa ou desativa a atualização automática do menu principal.

Exemplo:

menu-updater: true

Com esta opção ativada, o menu será atualizado automaticamente enquanto estiver aberto.

Define o tempo em ticks para atualizar o menu automaticamente.

Exemplo:

# Tempo para atualizar o menu automaticamente
# em ticks -> 20 ticks = 1s
menu-updater-time: 20

Setas de navegação

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 /fragmentos.

Estrutura básica

# Menu principal
main:
  name: '&8Fragmentos'
  size: 45
  slots: [ 11, 12, 13, 20, 21, 22, 29, 30, 31 ]
  previous-slot: 18
  next-slot: 26
  #
  empty-slot: -1
  shop-slot: 24
  info-slot: 15
  top-slot: 33

name

Define o título do menu.

Exemplo:

name: '&8Fragmentos'

size

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

Exemplo:

size: 45

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

slots

Define os slots onde os fragmentos serão exibidos.

Exemplo:

slots: [ 11, 12, 13, 20, 21, 22, 29, 30, 31 ]

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

empty-slot

Define o slot onde o item de inventário vazio será exibido (-1 para desativar).

Exemplo:

empty-slot: -1

shop-slot

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

Exemplo:

shop-slot: 24

info-slot

Define o slot onde o botão de informações será exibido.

Exemplo:

info-slot: 15

top-slot

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

Exemplo:

top-slot: 33

empty

Item exibido quando o jogador não possui nenhum fragmento.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&cVocê não possui nenhum fragmento'
    lore: []

shop

Botão para acessar a loja de fragmentos.

Exemplo:

items:
  shop:
    material: 'GOLD_INGOT'
    name: '&eLoja'
    lore: [ '&7Clique para abrir a loja', '&7de fragmentos.' ]

info

Exibe as informações do jogador.

Exemplo:

items:
  info:
    material: 'd01afe973c5482fdc71e6aa10698833c79c437f21308ea9a1a095746ec274a0f'
    name: '&eSuas informações'
    lore: [ '', ' &fFragmentos Armazenados: &7{stored}', '' ]

Placeholder disponível: {stored}

top

Botão para acessar o ranking de fragmentos.

Exemplo:

items:
  top:
    material: 'BOOK'
    name: '&eTOP'
    lore: [ '&7Clique para ver os', '&7jogadores que possuem', '&7mais fragmentos.' ]

Itens de decoração (facing)

Itens decorativos para melhorar a aparência do menu.

Exemplo:

facing:
  e0:
    slot: 11
    material: '3ed1aba73f639f4bc42bd48196c715197be2712c3b962c97ebf9e9ed8efa025'
    name: ' '
    lore: []
  e1:
    slot: 12
    material: '3ed1aba73f639f4bc42bd48196c715197be2712c3b962c97ebf9e9ed8efa025'
    name: ' '
    lore: []

Você pode adicionar quantos itens de decoração quiser.

Menu onde os jogadores podem retirar seus fragmentos armazenados.

Estrutura básica

# Menu de abrir as chaves
collect:
  name: '&8Fragmentos'
  size: 36
  back-slot: 31
  collect-1-slot: 11
  collect-all-slot: 15

collect-1

Botão para retirar 1 fragmento.

Exemplo:

items:
  collect-1:
    material: 'd9b30303f94e7c785a31e5727a9381535daf4753449ea41db746e1234e9dd2b5'
    name: '&aRetirar 1x'
    lore: [ '', ' &fFragmentos disponíveis: &7{amount}', '', '&aClique para retirar' ]

Placeholder disponível: {amount}

collect-all

Botão para retirar todos os fragmentos.

Exemplo:

items:
  collect-all:
    material: '1a6f1bce5461368a40707c54dc0b895bd61499e812145093db32f9eb12c32954'
    name: '&aRetirar tudo'
    lore: [ '', ' &fFragmentos disponíveis: &7{amount}', '', '&aClique para retirar' ]

Menu onde os jogadores podem trocar fragmentos por itens.

Estrutura básica

# Menu de shop
shop:
  name: '&8Loja fragmentos'
  size: 36
  back-slot: 31

Os itens da loja são configurados no arquivo shop.yml.

Menu que exibe o ranking dos jogadores com mais fragmentos.

Estrutura básica

# Menu de top
top:
  name: '&8Top fragmentos'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  back-slot: 31
  previous-slot: 9
  next-slot: 17

Itens do ranking

stored

Item que representa cada jogador no ranking.

Exemplo:

items:
  # Item do top fragmentos
  stored:
    material: '{player}'
    name: '&7{player}'
    lore:
      - ''
      - '&fFragmentos Armazenados: &7{amount}'
      - '&fPosição: &e{pos}º'
      - ''

Placeholders disponíveis: {player}, {amount}, {pos}

Use {player} no material para exibir a cabeça do jogador.

Opções de configuração de itens

material

Define o material do item. Pode ser um nome de item do Minecraft ou uma textura de cabeça.

Exemplo:

material: 'DIAMOND'
# ou
material: 'f8d818e65ee36cdcab6e315f499d3f5dde2323bf2df56f1e914089cebefa37f6'

name

Define o nome do item.

Exemplo:

name: '&eLoja'

lore

Define a descrição do item.

Exemplo:

lore: [ '&7Clique para abrir a loja', '&7de fragmentos.' ]

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