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

# Menu principal
main:
  name: '&8Mochila de Chaves'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 21, 22, 23 ]
  previous-slot: 18
  next-slot: 26
  items:
    automatic-slot: 38
    upgrade-open-slot: 39
    upgrade-storage-slot: 40
    store-slot: 42

Configurações gerais

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

menu-updater: true

Valores:

true - Menu é atualizado automaticamente
false - Menu estático

A atualização automática é útil para exibir mudanças em tempo real, como contadores de keys ou status de abertura automática.

Tempo para atualizar o menu automaticamente em ticks.

menu-updater-time: 20

Parâmetros:

Padrão: 20 (1 segundo)
20 ticks = 1 segundo
Exemplo: 40 = atualiza a cada 2 segundos

Setas de navegação

arrows

Configuração dos botões de navegação usados em todos os 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.']

Botões disponíveis:

back: Voltar ao menu anterior
previous: Ir à página anterior em menus paginados
next: Ir à próxima página em menus paginados

Cada botão possui:

material: Material do item
name: Nome exibido
lore: Descrição do item

Menu principal da mochila de chaves.

Estrutura básica

main:
  name: '&8Mochila de Chaves'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 21, 22, 23 ]
  previous-slot: 18
  next-slot: 26

Parâmetros:

name: Título do menu
- Padrão: &8Mochila de Chaves
size: Tamanho do menu em slots
- Padrão: 54 (6 linhas)
- Valores válidos: 9, 18, 27, 36, 45, 54
slots: Slots onde as crates aparecem
- Lista de posições no inventário (0-53)
- Padrão: [ 11, 12, 13, 14, 15, 21, 22, 23 ]
previous-slot: Slot da seta de página anterior
- Padrão: 18
next-slot: Slot da seta de próxima página
- Padrão: 26

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

Itens funcionais

main:
  items:
    automatic-slot: 38
    upgrade-open-slot: 39
    upgrade-storage-slot: 40
    store-slot: 42

Slots dos botões:

automatic-slot: Posição do botão de abertura automática (padrão: 38)
upgrade-open-slot: Posição do botão de upgrade de abertura (padrão: 39)
upgrade-storage-slot: Posição do botão de upgrade de armazenamento (padrão: 40)
store-slot: Posição do botão de guardar chaves (padrão: 42)

Configuração dos itens

automatic-has

Item quando a abertura automática NÃO está disponível.

items:
  automatic-has:
    material: '1c8e0ddf2432f4332b87691b5952c7679763ef4f275b874e9bceb888ed5b5b9'
    name: '&cAbertura automática'
    lore:
      - '&7A mochila consegue abrir'
      - '&7suas chaves automaticamente!'
      - ''
      - ' &8> &fPeríodo: &7{time}'
      - ''
      - ' &7Adquira este item:'
      - ' &fystoreplugins.com.br'
      - ''

Placeholders:

{time}: Período de abertura automática

automatic

Item quando a abertura automática está disponível.

items:
  automatic:
    material: '1391203d3752afc71d8f8cb0da8dbc7f13a3baafe0bf5f911cb21c38341f87db'
    name: '&aAbertura automática'
    lore:
      - '&7A mochila consegue abrir'
      - '&7suas chaves automaticamente!'
      - ''
      - ' &8> &fPeríodo: &7{time}'
      - ' &8> &fStatus: &7{status}'
      - ''
      - '&aClique para alternar.'

Placeholders:

{time}: Período de abertura
{status}: Status (ativado/desativado)

upgrade-open

Item de upgrade de abertura quando não está no máximo.

items:
  upgrade-open:
    material: '4ce36fcb1e5f6b36517fbbeb9cbf4b0c05c30d8bdb5154824e60e6d550f528e9'
    name: '&aQuantidade de abertura'
    lore:
      - '&7Evolua a quantidade que'
      - '&7sua mochila consegue abrir'
      - '&7chaves por vez.'
      - ''
      - ' &aAtual:'
      - ' &8> &fQuantidade: &7{actual}'
      - ''
      - ' &aEvolução:'
      - ' &8> &fPreço: &2$&f{money}'
      - ' &8> &fQuantidade: &7{next}'
      - ''
      - '&aClique para evoluir.'

Placeholders:

{actual}: Quantidade atual
{next}: Próxima quantidade após upgrade
{money}: Preço do upgrade

upgrade-open-max

Item quando já atingiu o máximo de upgrades de abertura.

items:
  upgrade-open-max:
    material: '4ce36fcb1e5f6b36517fbbeb9cbf4b0c05c30d8bdb5154824e60e6d550f528e9'
    name: '&aQuantidade de abertura'
    lore:
      - '&7Evolua a quantidade que'
      - '&7sua mochila consegue abrir'
      - '&7chaves por vez.'
      - ''
      - ' &aAtual:'
      - ' &8> &fQuantidade: &7{actual}'
      - ''
      - '&cEsta mochila já está no upgrade máximo.'

Placeholders:

{actual}: Quantidade atual

upgrade-storage

Item de upgrade de armazenamento quando não está no máximo.

items:
  upgrade-storage:
    material: '4ce36fcb1e5f6b36517fbbeb9cbf4b0c05c30d8bdb5154824e60e6d550f528e9'
    name: '&aQuantidade de armazenamento'
    lore:
      - '&7Evolua a quantidade que'
      - '&7sua mochila consegue armazenar'
      - '&7de chaves.'
      - ''
      - ' &aAtual:'
      - ' &8> &fQuantidade: &7{actual}'
      - ''
      - ' &aEvolução:'
      - ' &8> &fPreço: &2$&f{money}'
      - ' &8> &fQuantidade: &7{next}'
      - ''
      - '&aClique para evoluir.'

Placeholders:

{actual}: Quantidade atual
{next}: Próxima quantidade após upgrade
{money}: Preço do upgrade

upgrade-storage-max

Item quando já atingiu o máximo de upgrades de armazenamento.

items:
  upgrade-storage-max:
    material: '4ce36fcb1e5f6b36517fbbeb9cbf4b0c05c30d8bdb5154824e60e6d550f528e9'
    name: '&aQuantidade de armazenamento'
    lore:
      - '&7Evolua a quantidade que'
      - '&7sua mochila consegue armazenar'
      - '&7de chaves.'
      - ''
      - ' &aAtual:'
      - ' &8> &fQuantidade: &7{actual}'
      - ''
      - '&cEsta mochila já está no upgrade máximo.'

Placeholders:

{actual}: Quantidade atual

store

Item para guardar chaves do inventário.

items:
  store:
    material: 'ef221b33f5b39e99ee6fd343abaaa9abdf66d93d4306cf01cca9f202e8773fd6'
    name: '&dGuardar chaves'
    lore:
      - '&7Clique para guardar todas'
      - '&7as chaves disponíveis em'
      - '&7seu inventário.'

Os materiais que começam com letras e números são texturas de cabeças customizadas (player heads). Você pode obter novas texturas em sites como minecraft-heads.com.

Itens decorativos (facing)

Itens decorativos que aparecem em posições específicas apenas para enfeite.

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

Parâmetros para cada item:

slot: Posição no menu
material: Material do item
name: Nome (use espaço ' ' para sem nome)
lore: Descrição (use [] para vazio)

Certifique-se de que os slots dos itens decorativos não conflitem com os slots funcionais (crates, botões, etc.).

Nesta página