Menus

Exemplo completo de configuração

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

# Navegação
arrows:
  back:
    material: 'ARROW:0'
    name: '&c< Voltar'
    lore:
      - ''
      - ' &7Retorna ào menu anterior.'
      - ''
  previous:
    material: 'ARROW:0'
    name: '&e< Página anterior'
    lore:
      - ''
      - ' &7Volta uma página.'
      - ''
  next:
    material: 'ARROW:0'
    name: '&aPróxima página >'
    lore:
      - ''
      - ' &7Avança uma página.'
      - ''

# Menu principal
main:
  name: '&8Plots'
  size: 27
  items:
    my-plots:
      slot: 11
      material: 4528ed45802400f465b5c4e3a6b7a9f2b6a5b3d478b6fd84925cc5d988391c7d
      name: '&a&lMeus Terrenos'
      lore:
        - ''
        - ' &8| &7Possuídos: &a{count}'
        - ''
        - ' &a> Clique para abrir'
        - ''

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

Menu	Descrição
`arrows`	Botões de navegação (voltar, anterior, próximo)
`main`	Menu principal (`/plots menu`)
`plot-list`	Lista dos terrenos do jogador
`plot-panel`	Painel completo do dono
`plot-info`	Info para visitantes
`plot-member`	Painel limitado para membros
`sell-menu`	Menu de venda do terreno
`plot-settings`	Configurações (nome, descrição, bioma, transferir)
`biomes`	Seleção de biomas
`flags`	Menu de flags do terreno
`members`	Lista e gerenciamento de membros
`member-manage`	Definir cargo do membro
`confirm`	Confirmação genérica (delete, reset, etc.)
`claim`	Menu de reivindicação de terreno livre
`market`	Mercado de terrenos à venda
`favorites`	Lista de favoritos
`buy-confirm`	Confirmação de compra no mercado
`customize`	Personalização (parede, borda, ícone, clear, merge)
`plot-icons`	Seleção de ícone do terreno
`wall-blocks`	Cosméticos de parede
`border-blocks`	Cosméticos de borda

arrows

Configuração dos botões de navegação usados em todos os menus.

arrows:
  back:
    material: 'ARROW:0'
    name: '&c< Voltar'
    lore:
      - ''
      - ' &7Retorna ào menu anterior.'
      - ''
  previous:
    material: 'ARROW:0'
    name: '&e< Página anterior'
    lore:
      - ''
      - ' &7Volta uma página.'
      - ''
  next:
    material: 'ARROW:0'
    name: '&aPróxima página >'
    lore:
      - ''
      - ' &7Avança uma página.'
      - ''

Menu principal exibido com /plots ou /plots menu.

main:
  name: '&8Plots'
  size: 27
  facing:
    g0:
      slot: 0
      material: 'STAINED_GLASS_PANE:15'
      name: ' '
  items:
    my-plots:
      slot: 11
      name: '&a&lMeus Terrenos'
    current-plot:
      slot: 13
      name: '&e&lTerreno Atual'
    market:
      slot: 15
      name: '&6&lMercado'
    favorites:
      slot: 21
      name: '&d&lFavoritos'
    claim:
      slot: 23
      name: '&a&lReivindicar'

Placeholder disponível em my-plots: {count}

Lista de terrenos (plot-list)

plot-list:
  name: '&8Meus Terrenos'
  size: 54
  slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34]
  previous-slot: 48
  next-slot: 50
  back-slot: 45
  plot-item:
    name: '&a&l#{number} &8> &f{name}'
    lore:
      - ' &8- &7ID: &f{id}'
      - ' &8- &7Posição: &e{x}&7;&e{z}'
      - ' &8- &7Mundo: &f{world}'
      - ' &8- &7Grupo: &f{merge_size} &7plot(s)'
      - ' &8- &7Membros: &b{members}'
      - ' &8- &7Status: &r{status}'

Painel do dono (plot-panel)

Painel completo com informações, teleporte, membros, flags, settings, venda, favoritos, cosméticos, fly, title, actionbar, PvP noturno, reset e delete.

plot-panel:
  name: '&8{name}'
  size: 45
  items:
    info:
      slot: 4
      name: '&6&lInformações'
    teleport:
      slot: 19
      name: '&a&lTeleportar'
    members:
      slot: 20
      name: '&b&lMembros'
    flags:
      slot: 21
      name: '&c&lFlags'
    settings:
      slot: 22
      name: '&e&lConfigurações'
    sell:
      slot: 23
      name: '&6&lVender'
    sell-cancel:
      slot: 23
      name: '&c&lCancelar Venda'
    favorite:
      slot: 24
      name: '&d&lFavoritar'
    customize:
      slot: 25
      name: '&e&lPersonalizar'
    fly:
      slot: 28
      name: '&b&lModo de Voo'
      # lore com {fly}, {fly_unlocked} — clica para alternar
    fly-locked:
      slot: 28
      name: '&c&lModo de Voo &7(Bloqueado)'
      # lore com {fly_cost}, {fly_economy}, {fly_unlocked} — clica para comprar
    title:
      slot: 29
      name: '&e&lTitle ao entrar'
    actionbar:
      slot: 30
      name: '&e&lActionbar'
    pvp:
      slot: 32
      name: '&c&lPvP Noturno'
    reset:
      slot: 33
      name: '&c&lResetar'
    delete:
      slot: 40
      name: '&4&lDeletar Terreno'

Info visitante (plot-info)

plot-info:
  name: '&8Info'
  size: 27
  items:
    info:
      slot: 13
      name: '&6&lTerreno de &e{owner}'
    teleport:
      slot: 11
      name: '&a&lTeleportar'
    favorite:
      slot: 15
      name: '&d&lFavoritar'
    buy:
      slot: 22
      name: '&a&lComprar'

Painel membro (plot-member)

plot-member:
  name: '&8Membro #{number}'
  size: 27
  manage-only:
    - members
    - flags

manage-only define quais opções o membro pode acessar neste painel.

sell-menu:
  name: '&8Venda #{number}'
  size: 27

Configurações (plot-settings)

plot-settings:
  name: '&8Configurações'
  size: 27

Biomas (biomes)

biomes:
  name: '&8Biomes'
  size: 54
  slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34]
  previous-slot: 48
  next-slot: 50
  back-slot: 45
  biome-item:
    name: '&a{biome}'
  biome-selected:
    name: '&a&l{biome}'
  list:
    plains:
      id: PLAINS
      display-name: '&aPlanície'
      permission: 'yplots.biome.plains'
      material: GRASS

Cada entrada em list define um bioma disponível no menu.

Flags (flags)

flags:
  name: '&8Flags'
  size: 54
  permission-prefix: 'yplots.flag.'
  permissions:
    pvp: 'yplots.flag.pvp'
    explosion: 'yplots.flag.explosion'
    # ... demais flags
  flag-on:
    name: '&a{flag}'
  flag-off:
    name: '&c{flag}'

Membros (members)

members:
  name: '&8Membros &7({members}/{members_max})'
  size: 54
  add-button:
    slot: 49
    name: '&a&lAdicionar'
  member-slot:
    slot: 47
    name: '&a&l+ Slot de Membro'
  filter-button:
    slot: 53
    name: '&e&lFiltro: &f{filter}'
  member-item:
    material: '{player}'
    name: '&b&l{player}'

Negados são ilimitados. Membro/Confiável contam no limite (yplots.members.X + slots comprados).

Gerenciar membro (member-manage)

member-manage:
  name: '&8{player}'
  size: 27
  items:
    role-member:
      slot: 11
      name: '&a&lMembro'
    role-trusted:
      slot: 13
      name: '&6&lConfiável'
    role-denied:
      slot: 15
      name: '&c&lNegado'
    remove:
      slot: 22
      name: '&c&lRemover'

Confirmação (confirm)

confirm:
  name: '&8Confirmar'
  size: 27
  confirm-slot: 11
  cancel-slot: 15
  info-slot: 13
  types:
    delete:
      name: '&4&lDeletar Terreno'
    reset:
      name: '&c&lResetar Terreno'
    merge:
      material: 9d1eb9bec1b9cd8e1c5d5480d4d895f0b8b765d53bd0f4819b640014de75bdb
      name: '&e&lAgrupar Terrenos'
      lore:
        - ''
        - ' &8| &7{info}'
        - ' &8| &7ID: &f{id}'
        - ''
        - ' &eAgrupa com terrenos vizinhos seus.'
        - ''

types.<ação> define o ícone de info por tipo. info é o fallback.

Claim (claim)

claim:
  name: '&8Reivindicar'
  size: 27
  items:
    info:
      slot: 13
      name: '&a&lTerreno Livre'
      lore:
        - ' &8| &7Coords: &e{x}&7;&e{z}'
        - ' &8| &7Mundo: &f{world}'
        - ' &8| &7Tamanho: &f{size}x{size}'
        - ' &8| &7Preço: &a{price} &7{economy}'

Mercado (market)

market:
  name: '&8Mercado'
  size: 54
  plot-item:
    name: '&6&l#{number} &8> &e{name}'
    lore:
      - ' &8- &7Preço: &a&l{price} &7{economy}'

Favoritos (favorites)

favorites:
  name: '&8Favoritos'
  size: 54
  plot-item:
    name: '&d&l#{number} &8> &f{name}'

Confirmar compra (buy-confirm)

buy-confirm:
  name: '&8Compra'
  size: 27
  confirm-slot: 11
  cancel-slot: 15
  info-slot: 13

Personalização (customize)

customize:
  name: '&8Personalizar'
  size: 27
  items:
    wall-block:
      slot: 10
      name: '&e&lParede'
    border-block:
      slot: 11
      name: '&e&lBorda'
    icon:
      slot: 13
      name: '&e&lÍcone'
    clear:
      slot: 14
      name: '&e&lLimpar'
    merge:
      slot: 15
      name: '&6&lAgrupar'
    merge-slot:
      slot: 16
      name: '&a&l+ Slot de Merge'

Ícones, paredes e bordas

plot-icons:
  name: '&8Ícone'
  size: 54
  head:
    slot: 49
    name: '&e&lCabeça por nick'

wall-blocks:
  name: '&8Paredes'
  size: 45
  block:
    lore-buy:
      - ' &8| &7Custo: &a{money} &7{economy}'
    lore-has:
      - ' &8| &aVocê já possui este bloco.'
    lore-using:
      - ' &a| Em uso neste terreno.'

border-blocks:
  name: '&8Bordas'
  size: 45
  block:
    lore-buy:
      - ' &8| &7Custo: &a{money} &7{economy}'

Opções de configuração de menus

name

Define o título do menu exibido no topo.

name: '&8Plots'

size

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

size: 27

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

slots

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

slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25]

previous-slot / next-slot / back-slot

Slots dos botões de navegação.

previous-slot: 48
next-slot: 50
back-slot: 45

facing

Itens decorativos para preencher o menu.

facing:
  g0:
    slot: 0
    material: 'STAINED_GLASS_PANE:15'
    name: ' '

items / material / slot

Cada item pode ter slot, material (MATERIAL, MATERIAL:data ou hash de head), name e lore.

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

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 slot ou slots.

Adicione decoração

Use facing para adicionar itens decorativos nos slots vazios.

Teste no servidor

Recarregue o plugin com /plots reload e verifique o resultado.