LogoyStore
yVipsConfiguração

Menus

Personalize a aparência e comportamento dos menus do plugin.

Exemplo completo de configuração

O plugin possui diversos menus configuráveis. Abaixo está a estrutura básica de configuração.

Configurações Globais

Sistema de atualização automática do menu principal enquanto estiver aberto.

# 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

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

Menu principal exibido ao executar /vip.

main:
  name: '&8VIPs ➜ Principal'
  size: 36
  items:
    profile:
      slot: 10
      material: '{player}'
      name: '&bPerfil'
      lore:
        - ''
        - ' &fVIP Atual: &r{vip_display}'
        - ' &fTAG: &r{vip_prefix}'
        - ''
        - ' &fCréditos: &b&l♦ &f{credit}'
        - ''
        - ' &fExpira em: &7{expire_remaining}'
        - ' &fAtivado em: &7{activation_date} às {activation_hour}'
        - ''
    profile-no-vip:
      material: '{player}'
      name: '&aPerfil'
      lore:
        - ' &fCréditos: &b♦&f{credit}'
        - ''
        - ' &cAdquira um VIP e'
        - ' &cdesbloqueie o acesso ao menu.'
        - ''
    historic:
      slot: 12
      material: 'EMPTY_MAP'
      name: '&bHistórico de VIPS'
      lore:
        - '&7Clique para visualizar o seu'
        - '&7histórico de VIPs utilizados.'
        - ''
    stored:
      slot: 13
      material: 'TRIPWIRE_HOOK'
      name: '&bChaves'
      lore:
        - '&7Clique para visualizar as suas chaves'
        - '&7armazenadas do seu VIPs'
        - ''
        - ' &7Você possui &f{amount_stored} &7chave(s) armazenada(s).'
        - ' &7Total de chaves obtidas: &f{amount_obtained}&7.'
        - ''
    shop:
      slot: 14
      material: 'GOLD_INGOT'
      name: '&bLoja de Créditos'
      lore:
        - '&7Aqui você pode adquirir itens utilizando'
        - '&7os seus &nCréditos VIP&7.'
        - ''
        - '&aClique para abrir a loja.'
    keys-shop:
      slot: 15
      material: 'DIAMOND'
      name: '&bLoja de Chaves'
      lore:
        - '&7Aqui você pode adquirir chaves VIP'
        - '&7de outros jogadores.'
        - ''
        - '&aClique para abrir a loja.'
    top:
      slot: 16
      material: 'BOOK_AND_QUILL'
      name: '&b&lTOP'
      lore:
        - '&7Veja os jogadores que mais ativaram'
        - '&7vip no servidor.'
        - ''
        - '&aClique para abrir'
    activation:
      slot: 21
      material: 'CHEST'
      name: '&b&lAtivações'
      lore:
        - '&7Recolha as suas ativações pendentes.'
        - ''
        - '&aClique para abrir'
    upgrade-yes:
      slot: 22
      material: 'EMERALD'
      name: '&b&lUpar VIP'
      lore:
        - '&7Faça um upgrade do seu VIP atual para um melhor.'
        - ''
        - '&aClique para abrir'
    upgrade-no:
      material: 'EMERALD'
      name: '&b&lUpar VIP'
      lore:
        - '&cVocê não possui nenhum vip.'

profile é exibido quando o jogador tem VIP ativo

profile-no-vip é exibido quando o jogador não tem VIP

upgrade-yes é exibido quando há upgrade disponível

upgrade-no é exibido quando não há upgrade disponível

Placeholders disponíveis

PlaceholderDescrição
{player}Nome do jogador
{vip_display}Nome de exibição do VIP
{vip_prefix}Prefixo do VIP
{credit}Créditos VIP do jogador
{expire_remaining}Tempo restante do VIP
{activation_date}Data de ativação
{activation_hour}Hora de ativação
{amount_stored}Quantidade de chaves armazenadas
{amount_obtained}Total de chaves obtidas

Menu que exibe o histórico de VIPs do jogador com filtros.

history:
  name: '&8VIP'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 48
  selector:
    slot: 50
    material: HOPPER
    name: '&aFiltro'
    types:
      active:
        enabled: true
        name: 'VIP Equipado'
      pending:
        enabled: true
        name: 'VIP(s) Pendente'
      expired:
        enabled: true
        name: 'VIP(s) Expirados'
    formats:
      seeing: ' &f• &a{name}'
      select: ' &f• &7{name}'

O selector permite filtrar VIPs por status (ativo, pendente, expirado)

Menu que exibe o ranking de jogadores.

top:
  name: '&8TOP VIP'
  size: 36
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  back-slot: 30
  previous-slot: 9
  next-slot: 17
  selector:
    slot: 31
    material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
    name: '&aSeletor do TOP'
    types:
      credit:
        enabled: true
        name: 'Créditos VIP'
      activated-vip:
        enabled: true
        name: 'VIPs ativados'
    formats:
      seeing: ' &f• &a{nome}'
      select: ' &f• &7{nome}'
  items:
    credit:
      material: '{player}'
      name: '&f{player}'
      lore:
        - ''
        - '&fCréditos VIP: &7{amount}'
        - '&fPosição: &e{pos}º'
        - ''
    activated-vip:
      material: '{player}'
      name: '&f{player}'
      lore:
        - ''
        - '&fVIPs ativados: &7{amount}'
        - '&fPosição: &e{pos}º'
        - ''

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

Menu da loja de créditos VIP.

shop:
  name: '&8VIP SHOP'
  size: 27
  back-slot: 10
  profile:
    slot: 12
    material: '{player}'
    name: '&a{player}'
    lore: [ '&7Seus créditos: &f{credit}', "&7Créditos gastos: &f{spent}" ]
  items:
    swords:
      price: 1.0
      preview:
        slot: 14
        material: 'DIAMOND'
        name: '&b&lVIP DIAMANTE'
        lore: ['&7Compre seu vip diamante', '&7muito especial para o servidor.']
      item:
        material: 'DIAMOND'
        name: 'EOQ'
        lore: []
      command: [ 'darvip {player} diamante 10000' ]

price: Custo em créditos VIP

preview: Como o item aparece no menu

item: Item que será dado (se aplicável)

command: Comandos executados ao comprar

Menu de gerenciamento de chaves VIP.

keys:
  name: '&8VIP KEYS'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49
  bonus-slot: 40
  items:
    bonus:
      material: 'TRIPWIRE_HOOK'
      name: '&eKeys bônus!'
      lore: [ '&7Gerencie suas chaves bônus', '&7adquiridas em ativações.', '', '&aClique para abrir' ]
  facing:
    e0:
      slot: 11
      material: 'BARRIER'
      name: ' '
      lore: []

facing define itens decorativos quando não há keys para exibir

Menu específico para chaves bônus.

keys-bonus:
  name: '&8VIP KEYS BÔNUS'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Menu que exibe as keys que o jogador está vendendo.

keys-sell:
  name: '&8VIP KEYS VENDENDO'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Menu de configuração para vender uma key.

sell:
  name: '&8VIP VENDER KEY'
  size: 27
  items:
    back-slot: 10
    provider-slot: 12
    price-slot: 14
    selling-slot: 16
    provider:
      material: '61a8e6d27b96c0aa4df5b8347260eb051c56944c97d837f22655d8ecbc449137'
      name: '&aMoeda da venda'
      lore:
        - '&7Moeda que será utilizada no comércio'
        - '&7desta key.'
        - ''
        - '&7Atual: &fNenhuma'
        - ''
        - '&aClique para alterar a moeda'
    price:
      material: '945f47feb4d75cb333914bfdb999a489c9d0e320d548f310419ad738d1e24b9'
      name: '&aPreço da key'
      lore:
        - '&7Quantia que o jogador vai pagar por esta key:'
        - ''
        - ' &fPreço atual: &7{price}'
        - ''
        - '&aClique para alterar'
    selling:
      material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
      name: '&aAtivar venda'
      lore:
        - '&7Esta key não está sendo vendida no momento.'
        - '&7Jogadores não poderão comprar.'
        - ''
        - '&aClique para ativar a venda'
    selling-not:
      material: '5fde3bfce2d8cb724de8556e5ec21b7f15f584684ab785214add164be7624b'
      name: '&cDesativar venda'
      lore:
        - '&7Esta key está sendo vendida no momento.'
        - '&7Jogadores poderão comprar.'
        - ''
        - '&aClique para desativar a venda'

Menu para selecionar a economia de venda.

providers:
  name: '&8Selecionar economia'
  size: 27
  previous: 9
  next: 17
  back: 18
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]

Menu de confirmação de compra.

confirm:
  name: '&8Confirmação de compra'
  size: 27
  slots: [ 10, 11, 12, 13, 14, 15, 16 ]
  items:
    item-slot: 13
    confirm-slot: 11
    cancel-slot: 15
    confirm:
      material: 'WOOL:5'
      name: '&aConfirmar'
      lore: [ '&7Clique para &aconfirmar&7 a compra.' ]
    cancel:
      material: 'WOOL:14'
      name: '&cCancelar'
      lore: [ '&7Clique para &ccancelar&7 a compra.' ]

Menu para coletar ativações pendentes.

activations:
  name: '&8VIP ATIVAÇÕES'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 49

Opções de configuração de menus

name

Define o título do menu exibido no topo.

name: '&8VIPs ➜ Principal'

size

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

size: 36

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

slots

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

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

previous-slot, next-slot, back-slot

Define onde os botões de navegação aparecerão.

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

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

Personalizando os menus

Escolha o menu

Identifique qual menu você deseja personalizar.

Ajuste o tamanho

Altere o valor de size se necessário (deve ser múltiplo de 9).

Configure os slots

Defina onde os itens aparecerão usando slots.

Personalize os itens

Ajuste material, name e lore de cada item.

Teste no servidor

Reinicie o servidor e verifique o resultado.

Após alterar os menus, é necessário reiniciar o servidor para aplicar as mudanças.

Mensagens

Personalize todas as mensagens do plugin.

Economias

Configure os providers de economia para o sistema de marketplace.

Nesta página

Exemplo completo de configuraçãoConfigurações Globaismenu-updaterarrowsMenu Principal (main)Placeholders disponíveisMenu Histórico (history)Menu TOP (top)Menu Loja (shop)Menu Keys (keys)Menu Keys Bônus (keys-bonus)Menu Keys Vendendo (keys-sell)Menu Vender (sell)Menu Providers (providers)Menu Confirmação (confirm)Menu Ativações (activations)Opções de configuração de menusnamesizeslotsprevious-slot, next-slot, back-slotPersonalizando os menusEscolha o menuAjuste o tamanhoConfigure os slotsPersonalize os itensTeste no servidor