Menus

O arquivo menus.yml controla toda a aparência e comportamento do menu de preferências que os jogadores acessam.

Estrutura básica

preferences:
  # Tamanho do menu (múltiplo de 9)
  size: 27
  # Slots onde as preferências aparecerão
  slots: [10, 11, 12, 13, 14, 15, 16]
  
  # Nomes exibidos no ícone de cada preferência
  # Deixe vazio ('') para desativar a preferência do menu
  names:
    pvp: '&fPvP'
    teleport: '&fPedidos de teleporte'
    # ... mais preferências
  
  # Itens customizados por preferência (sobrescreve os on-item e off-item padrão)
  custom-items:
    pvp:
      on-item:
        material: 'DIAMOND_SWORD:0'
        name: '&fPvP'
        lore:
          - ''
          - '&7Estado: &aLigado'
          - ''
          - '&eClique para desativar.'
      off-item:
        material: 'WOOD_SWORD:0'
        name: '&fPvP'
        lore:
          - ''
          - '&7Estado: &cDesligado'
          - ''
          - '&eClique para ativar.'

Opções de configuração

size

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

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

preferences:
  size: 27

slots

Define a lista de slots onde as preferências serão exibidas no menu.

preferences:
  slots: [10, 11, 12, 13, 14, 15, 16]

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

names

Define os nomes exibidos para cada preferência no menu. Deixe vazio ('') para desativar uma preferência do menu.

preferences:
  names:
    pvp: '&fPvP'
    teleport: '&fPedidos de teleporte'
    private-message: '&fMensagens Privadas'
    chat-local: '&fChat Local'
    chat-global: '&fChat Global'
    full-sell: '&fVenda rápida (inv-full)'
    clan-invite: '&fConvites de clan'
    # yMarket / yLeilao
    market-broadcast: '&fAnúncios do mercado'
    leilao-broadcast: '&fAnúncios de leilão'

Exemplo desativando uma preferência:

preferences:
  names:
    pvp: ''  # Esta preferência não será mostrada no menu
    teleport: '&fPedidos de teleporte'  # Esta será mostrada

Personalização de itens por preferência

A seção custom-items permite customizar completamente o visual dos itens individuais de cada preferência, substituindo o padrão.

Estrutura

preferences:
  custom-items:
    <preferencia>:
      on-item:
        material: '<material>'
        name: '<nome>'
        lore:
          - '<linha1>'
          - '<linha2>'
      off-item:
        material: '<material>'
        name: '<nome>'
        lore:
          - '<linha1>'
          - '<linha2>'

on-item

Configuração do item quando a preferência está ATIVADA.

Exemplo:

custom-items:
  pvp:
    on-item:
      material: 'DIAMOND_SWORD'
      name: '&fPvP'
      lore:
        - ''
        - '&7Estado: &aLigado'
        - ''
        - '&eClique para desativar.'

off-item

Configuração do item quando a preferência está DESATIVADA.

Exemplo:

custom-items:
  pvp:
    off-item:
      material: 'WOOD_SWORD'
      name: '&fPvP'
      lore:
        - ''
        - '&7Estado: &cDesligado'
        - ''
        - '&eClique para ativar.'

Exemplos práticos

Preferências com temas de cores diferentes

preferences:
  size: 27
  slots: [10, 11, 12, 13, 14, 15, 16]
  
  names:
    pvp: '&fPvP'
    teleport: '&fTeleportes'
    private-message: '&fMPs'
  
  custom-items:
    pvp:
      on-item:
        material: 'APPLE'
        name: '&aProtegido contra PvP'
        lore:
          - '&eClique para se desproteger'
      off-item:
        material: 'ROTTEN_FLESH'
        name: '&cVulnerável a PvP'
        lore:
          - '&eClique para se proteger'
    
    teleport:
      on-item:
        material: 'ENDER_PEARL'
        name: '&bTeleportes Aceitos'
        lore:
          - '&eClique para recusar'
      off-item:
        material: 'COBBLESTONE'
        name: '&7Teleportes Recusados'
        lore:
          - '&eClique para aceitar'

Desabilitando preferências específicas

preferences:
  names:
    pvp: '&fPvP'
    teleport: ''  # Desabilitada
    private-message: '&fMPs'
    chat-local: ''  # Desabilitada
    chat-global: '&fChat Global'
    full-sell: '&fVenda Rápida'
    clan-invite: ''  # Desabilitada

Preferências disponíveis

Lista de todas as preferências que podem ser customizadas:

Chave	Descrição
`pvp`	Preferência de PvP
`teleport`	Preferência de pedidos de teleporte
`private-message`	Preferência de mensagens privadas
`chat-local`	Preferência de chat local
`chat-global`	Preferência de chat global
`full-sell`	Preferência de venda rápida quando inventário cheio
`clan-invite`	Preferência de convites de clan
`market-broadcast`	Preferência de anúncios do mercado (yMarket)
`leilao-broadcast`	Preferência de anúncios de leilão (yLeilao)

Nem todas as preferências estarão disponíveis se seus respectivos plugins não estiverem instalados.

Dicas importantes

Use cores consistentes

Mantenha um padrão de cores para as preferências ativadas/desativadas:

custom-items:
  pvp:
    on-item:
      name: '&a✓ PvP'  # Verde para ativado
    off-item:
      name: '&c✗ PvP'  # Vermelho para desativado

Combine com materiais significativos

Use materiais que representem visualmente o estado:

custom-items:
  chat-global:
    on-item:
      material: 'EMERALD'  # Ativo = valioso
      name: '&aChat Global'
    off-item:
      material: 'COAL'  # Inativo = comum
      name: '&7Chat Global'

Teste as mudanças

Sempre teste o menu após alterações para garantir que os itens apareçam corretamente:

/preferences reload

Se você deixar uma preferência sem custom-items, ela usará o visual padrão do plugin. Defina ambos on-item e off-item para completa customização.

Configuração do menu de preferências