Menus

Exemplo completo de configuração

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

# 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: '&8Terreno'
  size: 45
  back-slot: 36
  items:
    info-slot: 10
    friends-slot: 12
    sell-slot: 14
    teleport-slot: 16

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

arrows

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

back

Botão para voltar ao menu anterior.

Exemplo:

arrows:
  back:
    material: 'ARROW:0'
    name: '&cVoltar'
    lore: ['&7Clique para voltar ao menu anterior.']

Botão para ir à página anterior em menus paginados.

Exemplo:

arrows:
  previous:
    material: 'ARROW:0'
    name: '&cAnterior'
    lore: ['&7Clique para ir à página anterior.']

Botão para ir à próxima página em menus paginados.

Exemplo:

arrows:
  next:
    material: 'ARROW:0'
    name: '&aPróximo'
    lore: ['&7Clique para ir à próxima página.']

Menu principal exibido quando os jogadores executam /plot no seu terreno.

Estrutura básica

main:
   name: '&8Terreno'
   size: 45
   back-slot: 36
   items:
     info-slot: 10
     friends-slot: 12
     sell-slot: 14
     teleport-slot: 16
     fly-slot: 20
     home-slot: 31
     icon-slot: 24
     customize-slot: 40
     title-slot: 42
     delete-slot: 44
     pvp-slot: 38

info

Exibe informações do terreno e permite alterar o nome.

Exemplo:

items:
  info:
    material: 'PAPER'
    name: '&aInformações'
    lore:
      - ''
      - '&aNome: &f{custom_name}'
      - '&aDono: &f{owner}'
      - ''
      - '&aClique para alterar o nome.'

Placeholders disponíveis: {custom_name}, {owner}

friends

Permite gerenciar amigos do terreno.

Exemplo:

items:
  friends:
    material: 'BOOK'
    name: '&aAmigos'
    lore:
      - '&7Gerencie quem pode morar junto'
      - '&7contigo nesse terreno.'
      - ''
      - '&f> Quantia: &a{friends}'
      - ''
      - '&aClique para gerenciar.'

Placeholder disponível: {friends}

sell

Permite colocar o terreno à venda.

Exemplo:

items:
  sell:
    material: 'EMERALD'
    name: '&aVender'
    lore:
      - '&7Comercialize seu terreno com'
      - '&7outros jogadores do servidor.'
      - ''
      - '&f> A venda: &r{selling}'
      - ''
      - '{formats}'
      - ''
      - '&aClique para abrir.'

Placeholders disponíveis: {selling}, {formats}

teleport

Permite teleportar para o terreno.

Exemplo:

items:
  teleport:
    material: 'ENDER_PEARL'
    name: '&aTeleportar'
    lore:
      - '&7Teleporte para o local exato'
      - '&7do seu terreno.'
      - ''
      - '&fLocalização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
      - ''
      - '&f> Custo: &2$ &a1000,00'
      - ''
      - '&aClique para teleportar. &6(Apenas VIPS).'

Placeholders disponíveis: {x}, {y}, {z}, {world}

fly

Gerencia o modo de voo no terreno.

Exemplo:

items:
  fly:
    material: 'FEATHER'
    name: '&aModo de Voo'
    lore:
      - '&7Gerencie a permissão de voo'
      - '&7no seu terreno.'
      - ''
      - '&f> Modo de Voo: &r{fly}'
      - ''
      - '&aClique para alternar.'

Placeholder disponível: {fly}

home

Define o local de entrada do terreno.

Exemplo:

items:
  home:
    material: 'WOOD_DOOR'
    name: '&aLocal da Home'
    lore:
      - '&7Defina o local que será a entrada'
      - '&7do seu terreno.'
      - ''
      - '&fLocalização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
      - ''
      - '&aClique para alterar.'

Placeholders disponíveis: {x}, {y}, {z}, {world}

icon

Altera o ícone do terreno.

Exemplo:

items:
  icon:
    material: 'ITEM_FRAME'
    name: '&aÍcone do Terreno'
    lore:
      - '&7Mude o ícone que ficará'
      - '&7no seu terreno.'
      - ''
      - '&aClique para alterar o ícone.'

customize

Acessa o menu de customização (PlotSquared apenas).

Exemplo:

items:
  customize:
    material: 'BRICK'
    name: '&ePersonalização'
    lore:
      - '&7Personalize seu terreno para'
      - '&7ficar do jeito que goste.'
      - ''
      - '&aClique para abrir.'

title

Alterna a exibição de título ao entrar no terreno.

Exemplo:

items:
  title:
    material: 'PAINTING'
    name: '&aTítulo'
    lore:
      - '&7Aparecer o nome do terreno no título'
      - '&7ao entrar nele.'
      - ''
      - '&fStatus: &r{title}'
      - ''
      - '&cClique para alternar.'

Placeholder disponível: {title}

delete

Deleta o terreno permanentemente.

Exemplo:

items:
  delete:
    material: 'BARRIER'
    name: '&cDeletar Terreno'
    lore:
      - '&7Remova por completo a proteção'
      - '&7desse terreno.'
      - ''
      - '&cClique para deletar.'

pvp

Controla o estado do PvP no terreno durante o período de noite (requer sistema day-night ativo).

Exemplo:

items:
  pvp:
    material: 'IRON_SWORD'
    name: '&cPvP do Terreno'
    lore:
      - '&7Controle se o PvP estará ativo'
      - '&7no seu terreno durante a noite.'
      - ''
      - '&f> PvP Noturno: &r{pvp}'
      - ''
      - '&cClique para alternar.'

Placeholder disponível: {pvp} (mostra LIGADO ou DESLIGADO)

Este item só aparece se o sistema day-night estiver configurado e ativo no arquivo config.yml.

Itens específicos por plugin (facing)

O menu principal pode conter itens específicos que aparecem apenas quando determinados plugins estão instalados.

Exemplo:

main:
  facing:
    storage:
      slot: 22
      material: 'CHEST'
      name: '&aArmazém'
      nbt-tag: ['yStore-Menu-Command=>sudo {player} /armazem']
      lore:
        - '&7Acesse o armazém de drops deste'
        - '&7terreno.'
        - ''
        - '&aClique para acessar.'

Menu para gerenciar os amigos do terreno.

friends:
  name: '&8Terreno'
  size: 54
  slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 43]
  previous-slot: 9
  next-slot: 17
  back-slot: 18
  items:
    add-slot: 27
    add:
      material: '8e9b27fccd80921bd263c91dc511d09e9a746555e6c9cad52e8562ed0182a2f'
      name: '&aAdicionar amigo'
      lore:
        - '&7Clique aqui para adicionar'
        - '&7amigos para poder usar'
        - '&7este terreno.'
    friend:
      material: '{player}'
      name: '&a{player}'
      lore:
        - ''
        - '&aClique para deletar.'
        - ''

O placeholder {player} no material carrega automaticamente a cabeça do jogador.

Menu para alterar o ícone do terreno.

change-icon:
  name: '&8Terreno'
  size: 54
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 37, 38, 39 ]
  previous-slot: 41
  next-slot: 43
  back-slot: 45
  items:
    head-slot: 42
    head:
      material: '62d90ad63dd826df02994abdcc6c2306163e1072d1b9e63ad4e7d7d1cf87cdf9'
      name: '&eDefinir head'
      lore:
      - '&7Clique para definir uma'
      - '&7cabeça customizada no terreno.'

Menu que lista todos os terrenos do jogador.

terrains:
  name: '&8Terrenos'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  terrain:
    name: '&aTerreno &7(&e{name}&7)'
    lore:
      - ''
      - '&f> Nome: &b{custom_name}'
      - '&f> Dono: &c{owner}'
      - ''
      - '&aClique para abrir o menu do terreno.'
  items:
    profile-slot: 38
    selling-slot: 40
    friends-slot: 42
    empty-slot: 22

Placeholders disponíveis: {name}, {custom_name}, {owner}

profile

Exibe informações do jogador.

Exemplo:

items:
  profile:
    material: '{player}'
    name: '&eMinhas Informações'
    lore:
    - '&7Confira as suas informações acerca'
    - '&7dos seus terrenos no servidor.'
    - ''
    - '&f> Quantia de Terrenos: &b{amount}'
    - '&f> Terrenos à Venda: &c{selling}'
    - '&f> Terrenos de Amigos: &c{friends}'
    - ''

Placeholders disponíveis: {amount}, {selling}, {friends}

selling

Acessa terrenos à venda.

Exemplo:

items:
  selling:
    material: '91be4b5b592fee21a65e0f903038c5333be388234a43731d4adfe5d57d3644e5'
    name: '&eTerrenos à Venda'
    lore:
    - '&7Confira todos os terrenos que'
    - '&7estão à venda no servidor.'
    - ''
    - '&f> Quantia de Terrenos: &b{amount}'
    - ''
    - '&aClique para abrir.'

Placeholder disponível: {amount}

friends

Acessa terrenos de amigos.

Exemplo:

items:
  friends:
    material: 'f151bec8f91ef93c60cf40a98acbbeb17f6375725f00d4433a118f1010b298b'
    name: '&eTerrenos de Amigos'
    lore:
    - '&7Confira todos os terrenos que'
    - '&7você está adicionado como amigo.'
    - ''
    - '&f> Quantia de Terrenos: &b{amount}'
    - ''
    - '&aClique para abrir.'

empty

Exibido quando não há terrenos.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&cVazio'
    lore:
    - '&7Você não possui nenhum terreno'
    - '&7no nosso servidor.'

Menu para selecionar a economia ao colocar terreno à venda.

providers:
  name: '&8Terreno'
  size: 27
  previous: 9
  next: 17
  back: 18
  slots: [ 10, 11, 12, 13, 14 ]
  items:
    selling-slot: 16
    selling:
      material: 'EMERALD'
      name: '&aVender'
      lore:
        - '&7Comercialize seu terreno com'
        - '&7outros jogadores do servidor.'
        - ''
        - '&f> A venda: &r{selling}'
        - ''
        - '&aClique para alternar.'

Placeholder disponível: {selling}

Menu que lista todos os terrenos à venda no servidor.

selling:
  name: '&8Terrenos'
  size: 45
  previous-slot: 18
  next-slot: 26
  back-slot: 31
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  items:
    empty-slot: 13
    formats:
      prices: '&2{provider_symbol} &r{price} &7({provider_abbreviated})'
      none: '&cNenhuma economia configurada.'
    terrain:
      name: '&aTerreno &7(&e{name}&7)'
      lore:
        - ''
        - '&f> Nome: &b{custom_name}'
        - '&f> Dono: &c{owner}'
        - ''
        - '&f> Localização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
        - ''
        - '&ePreços:'
        - '{formats}'
        - ''
        - '&aClique para comprar.'
    empty:
      material: 'WEB'
      name: '&cVazio'
      lore:
        - '&7Não há terrenos a venda'
        - '&7no nosso servidor.'

Placeholders disponíveis: {name}, {custom_name}, {owner}, {x}, {y}, {z}, {world}, {formats}

Menu que lista terrenos onde o jogador é amigo.

friend-terrains:
  name: '&8Terrenos'
  size: 45
  previous-slot: 18
  next-slot: 26
  back-slot: 31
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  items:
    empty-slot: 13
    terrain:
      name: '&aTerreno &7(&e{name}&7)'
      lore:
        - ''
        - '&f> Nome: &b{custom_name}'
        - '&f> Dono: &c{owner}'
        - ''
        - '&f> Localização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
        - ''
        - '&aClique para gerenciar.'
    empty:
      material: 'WEB'
      name: '&cVazio'
      lore:
        - '&7Não há terrenos de amigos'
        - '&7disponível para você.'

Menu de confirmação ao comprar um terreno.

confirm-sell:
  name: '&8Terreno'
  size: 27
  items:
    cancel-slot: 11
    terrain-slot: 13
    confirm-slot: 15
    formats:
      prices: '&2{provider_symbol} &r{price} &7({provider_abbreviated})'
      none: '&cNenhuma economia configurada.'
    terrain:
      name: '&aTerreno &7(&e{name}&7)'
      lore:
        - ''
        - '&f> Nome: &b{custom_name}'
        - '&f> Dono: &c{owner}'
        - ''
        - '&f> Localização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
        - ''
        - '&ePreços:'
        - '{formats}'
        - ''
    cancel:
      material: '32cbdc9d4c590eac285a4544f2b1e068bd27fd52173ac8d7679013823cbab95a'
      name: '&cCancelar'
      lore:
        - '&7Cancele o processo de compra deste'
        - '&7terreno e volte para o menu anterior.'
        - ''
        - '&cClique para cancelar.'
    confirm:
      material: '8e9b27fccd80921bd263c91dc511d09e9a746555e6c9cad52e8562ed0182a2f'
      name: '&aConfirmar'
      lore:
        - '&7Confirme o processo de compra deste'
        - '&7terreno e vá para o menu de informações dele.'
        - ''
        - '&aClique para confirmar a compra.'

Menu de confirmação ao deletar um terreno.

confirm-delete:
  name: '&8Terreno'
  size: 27
  items:
    cancel-slot: 11
    terrain-slot: 13
    confirm-slot: 15
    terrain:
      name: '&aTerreno &7(&e{name}&7)'
      lore:
        - ''
        - '&f> Nome: &b{custom_name}'
        - '&f> Dono: &c{owner}'
        - ''
    cancel:
      material: '32cbdc9d4c590eac285a4544f2b1e068bd27fd52173ac8d7679013823cbab95a'
      name: '&cCancelar'
      lore:
        - '&7Cancele o processo de deletar este'
        - '&7terreno e volte para o menu anterior.'
        - ''
        - '&cClique para cancelar.'
    confirm:
      material: '8e9b27fccd80921bd263c91dc511d09e9a746555e6c9cad52e8562ed0182a2f'
      name: '&aConfirmar'
      lore:
        - '&7Confirme o processo de deletar este'
        - '&7terreno e vá para o menu principal.'
        - ''
        - '&aClique para confirmar e deletar.'

Menu exibido quando um amigo acessa um terreno.

info-friend:
  name: '&8Terreno'
  size: 27
  items:
    terrain-slot: 10
    friends-slot: 12
    buy-slot: 13
    teleport-slot: 16
    formats:
      prices: '&2{provider_symbol} &r{price} &7({provider_abbreviated})'
      none: '&cNenhuma economia configurada.'
    terrain:
      name: '&aTerreno &7(&e{name}&7)'
      lore:
        - ''
        - '&f> Nome: &b{custom_name}'
        - '&f> Dono: &c{owner}'
        - ''
    friends:
      material: 'BOOK'
      name: '&aAmigos'
      lore:
        - '&7Veja todas as pessoas que possuem'
        - '&7permissão neste terreno.'
        - ''
        - '&f> Quantia: &a{friends}'
        - ''
        - '&aClique para ver.'
    buy-no:
      material: 'EMERALD'
      name: '&cComprar'
      lore:
        - '&cEste terreno não está a venda.'
    buy:
      material: 'EMERALD'
      name: '&aComprar'
      lore:
        - ''
        - '&f> A venda: &r{selling}'
        - ''
        - '{formats}'
        - ''
        - '&aClique para comprar.'
    teleport:
      material: 'ENDER_PEARL'
      name: '&aTeleportar'
      lore:
        - '&7Teleporte para o local exato'
        - '&7deste terreno.'
        - ''
        - '&fLocalização: &fX:&b{x}&f - &fY:&b{y}&f - &fZ:&b{z} &7({world})'
        - ''
        - '&f> Custo: &2$ &a1000,00'
        - ''
        - '&aClique para teleportar. &6(Apenas VIPS).'
  facing:
    storage:
      slot: 14
      material: 'CHEST'
      name: '&aArmazém'
      nbt-tag: ['yStore-Menu-Command=>sudo {player} /armazem']
      lore:
        - '&7Acesse o armazém de drops deste'
        - '&7terreno.'
        - ''
        - '&aClique para acessar.'

Menu de customização exclusivo para PlotSquared.

customize:
  name: '&8Terrenos'
  size: 27
  back-slot: 9
  items:
    wall-block-slot: 11
    border-block-slot: 13
    clear-slot: 15
    merge-slot: 17
    wall-block:
      material: 'BRICK'
      name: '&eParede'
      lore:
        - '&7Customize a parede do seu terreno'
        - '&7para diversos blocos!'
        - ''
        - '&aClique para abrir.'
    border-block:
      material: 'STEP'
      name: '&eBorda'
      lore:
        - '&7Customize a borda do seu terreno'
        - '&7para diversos blocos!'
        - ''
        - '&aClique para abrir.'
    clear:
      material: 'IRON_SPADE'
      name: '&eLimpar'
      lore:
        - '&7Limpe totalmente seu terreno'
        - '&7para iniciar uma nova construção!'
        - ''
        - '&f> Custo: &2$ &a{money}'
        - ''
        - '&aClique para limpar.'
    merge:
      material: 'NETHER_STAR'
      name: '&eAgrupar'
      lore:
        - '&7Agrupe seus terrenos vizinhos'
        - '&7para obter um lote maior!'
        - ''
        - '&f> Custo: &2$ &a{money}'
        - ''
        - '&aClique para agrupar.'

Placeholder disponível: {money}

wall-blocks:
  name: '&8Terrenos'
  size: 45
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40
  block:
    lore-buy:
      - '&7Compre um novo bloco para customizar'
      - '&7a parede do seu terreno.'
      - ''
      - '&f> Custo: &2$ &a{money}'
      - ''
      - '&aClique para comprar'
    lore-has:
      - '&aClique para alterar.'
    lore-using:
      - '&aVocê está usando esse.'

Placeholder disponível: {money}

border-blocks:
  name: '&8Terrenos'
  size: 45
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 40
  block:
    lore-buy:
      - '&7Compre um novo bloco para customizar'
      - '&7a borda do seu terreno.'
      - ''
      - '&f> Custo: &2$ &a{money}'
      - ''
      - '&aClique para comprar'
    lore-has:
      - '&aClique para alterar.'
    lore-using:
      - '&aVocê está usando esse.'

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Terreno'

size

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

Exemplo:

size: 27

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

slots

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

Exemplo:

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

back-slot

Define o slot onde o botão de voltar será exibido.

Exemplo:

back-slot: 49

previous-slot

Define o slot onde o botão de página anterior será exibido.

Exemplo:

previous-slot: 18

next-slot

Define o slot onde o botão de próxima página será exibido.

Exemplo:

next-slot: 26

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

Nesta página