LogoyStore
yCratesVirtuaisAddonsyCratesVirtuaisMochilasConfiguração

Menus

Configuração dos menus do plugin.

O arquivo menus.yml permite personalizar completamente a interface gráfica da mochila, incluindo layout, itens decorativos e botões funcionais.

Estrutura

#
#    /\/\   ___ _ __  _   _ ___
#   /    \ / _ \ '_ \| | | / __|
#  / /\/\ \  __/ | | | |_| \__ \
#  \/    \/\___|_| |_|\__,_|___/
#
# 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
    # ... itens configuráveis

Configurações Gerais

Atualiza automaticamente o menu enquanto estiver aberto, permitindo que mudanças em tempo real sejam exibidas.

# Ativar o sistema de atualizar o menu principal automaticamente enquanto estiver aberto
menu-updater: true
  • true - Menu se atualiza automaticamente (recomendado)
  • false - Menu só atualiza ao reabrir

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

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

Valores recomendados:

  • 20 ticks (1 segundo) - Padrão, bom equilíbrio
  • 10 ticks (0.5 segundos) - Mais responsivo, pode usar mais recursos
  • 40 ticks (2 segundos) - Mais econômico

A atualização automática permite que a quantidade de chaves e a barra de progresso sejam atualizadas em tempo real.

Setas de Navegação

Configuração dos botões de navegação entre páginas.

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

Parâmetros:

  • back: Botão de voltar (não usado neste menu específico)
  • previous: Botão de página anterior
  • next: Botão de próxima página

Cada seta possui:

  • material: Material do item (formato MATERIAL:data)
  • name: Nome exibido
  • lore: Lista de linhas de descrição

Configuração do menu principal da mochila.

Configurações Básicas

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 (inventário)

    • Suporta códigos de cor (&)

  • size: Tamanho do inventário

    • Valores possíveis: 9, 18, 27, 36, 45, 54

  • slots: Lista de slots onde as chaves serão exibidas

    • Os slots são numerados de 0 a 53 (em um menu de 54 slots)

  • previous-slot: Slot do botão de página anterior

    • Padrão: 18

  • next-slot: Slot do botão de próxima página

    • Padrão: 26

Posição dos Itens Funcionais

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

Slots funcionais:

  • automatic-slot: Posição do botão de abertura automática
  • upgrade-open-slot: Posição do botão de upgrade de abertura
  • upgrade-storage-slot: Posição do botão de upgrade de armazenamento
  • store-slot: Posição do botão de guardar chaves

Botão de Abertura Automática

Dois estados: quando o jogador não tem o ativador automático.

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

E quando o jogador tem o ativador automático:

    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 disponíveis:

  • {time} - Tempo configurado entre aberturas automáticas
  • {status} - Status atual (Ativado/Desativado)

Botão de Upgrade de Abertura

Quando ainda pode ser evoluído:

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

Quando já está no máximo:

    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 disponíveis:

  • {actual} - Quantidade atual de abertura
  • {next} - Quantidade após o próximo upgrade
  • {money} - Preço do próximo upgrade (automático para cada economia configurada)

Botão de Upgrade de Armazenamento

Quando ainda pode ser evoluído:

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

Quando já está no máximo:

    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 disponíveis:

  • {actual} - Capacidade atual de armazenamento
  • {next} - Capacidade após o próximo upgrade
  • {money} - Preço do próximo upgrade

Botão de Guardar Chaves

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

Este botão transfere todas as chaves do inventário do yCratesVirtuais para a mochila.

Itens Decorativos (facing)

Itens decorativos que aparecem no menu para melhorar a aparência visual.

  facing:
    e0:
      slot: 11
      material: '3ed1aba73f639f4bc42bd48196c715197be2712c3b962c97ebf9e9ed8efa025'
      name: ' '
      lore: []
    e1:
      slot: 12
      material: '3ed1aba73f639f4bc42bd48196c715197be2712c3b962c97ebf9e9ed8efa025'
      name: ' '
      lore: []
    # ... mais itens decorativos

Parâmetros:

  • slot: Posição do item decorativo no menu
  • material: Material ou textura (Base64 para heads personalizadas)
  • name: Nome do item (use ' ' para vazio)
  • lore: Descrição (use [] para vazia)

Os itens decorativos não têm funcionalidade, apenas melhoram a estética do menu.

Exemplo de Customização Completa

main:
  name: '&6&l⚡ MOCHILA DE CHAVES ⚡'
  size: 54
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25 ]
  previous-slot: 45
  next-slot: 53
  items:
    automatic-slot: 48
    upgrade-open-slot: 49
    upgrade-storage-slot: 50
    store-slot: 51
    automatic:
      material: 'STONE_BUTTON'
      name: '&a&lABERTURA AUTOMÁTICA ATIVA'
      lore:
        - '&8━━━━━━━━━━━━━━━━━━━━'
        - '&7Suas chaves são abertas'
        - '&7automaticamente a cada &e{time}&7!'
        - '&8━━━━━━━━━━━━━━━━━━━━'
        - ''
        - ' &8▸ &fStatus: &a{status}'
        - ''
        - '&e⚡ Clique para desativar'

Certifique-se de que os slots definidos em slots não conflitem com os slots dos itens funcionais (automatic-slot, upgrade-open-slot, etc).

Formato de Material

Os materiais podem ser definidos de duas formas:

Material padrão do Minecraft

material: 'CHEST'
material: 'DIAMOND'
material: 'ARROW:0'

Textura personalizada (Head)

material: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYmFkYzA0OGE3Y2U3OGY3ZGFkNzJhMDdkYTI3ZDg1YzA5MTY4ODFlNTUyMmVlZWQxZTNkYWYyMTdhMzhjMWEifX19'

Para obter texturas personalizadas em formato Base64, utilize sites como minecraft-heads.com ou freshcoal.com.

Economias

Configuração dos sistemas de economia utilizados nos upgrades.

Mensagens

Configuração das mensagens do plugin.

Nesta página

EstruturaConfigurações Geraismenu-updatermenu-updater-timeSetas de NavegaçãoMenu Principal (main)Configurações BásicasPosição dos Itens FuncionaisBotão de Abertura AutomáticaBotão de Upgrade de AberturaBotão de Upgrade de ArmazenamentoBotão de Guardar ChavesItens Decorativos (facing)Exemplo de Customização CompletaFormato de MaterialMaterial padrão do MinecraftTextura personalizada (Head)