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

main-menu:
  name: '&8yAlugarItem — Menu'
  size: 27
  browse-slot: 11
  my-listings-slot: 13
  my-rentals-slot: 15

Estrutura de menus

O plugin possui nove menus ao total:

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

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 de entrada exibido ao usar /alugar. Dá acesso ao mercado, às suas listagens e aos seus aluguéis.

main-menu:
  name: '&8yAlugarItem — Menu'
  size: 27
  browse-slot: 11
  my-listings-slot: 13
  my-rentals-slot: 15
  browse:
    material: CHEST
    name: '&6&lMercado de Aluguéis'
    lore:
      - ''
      - ' &7Veja todos os itens disponíveis'
      - ' &7para aluguel no servidor.'
      - ''
      - ' &eClique para abrir'
      - ''
  my-listings:
    material: ITEM_FRAME
    name: '&a&lMinhas Listagens'
    lore:
      - ''
      - ' &7Gerencie os itens que você'
      - ' &7colocou para alugar.'
      - ''
      - ' &eClique para abrir'
      - ''
  my-rentals:
    material: BOOK
    name: '&b&lMeus Aluguéis'
    lore:
      - ''
      - ' &7Veja os itens que você'
      - ' &7está alugando atualmente.'
      - ''
      - ' &eClique para abrir'
      - ''
  facing:
    glass1:
      slot: 0
      material: 'STAINED_GLASS_PANE:15'
      name: ' '
    glass2:
      slot: 8
      material: 'STAINED_GLASS_PANE:15'
      name: ' '
    glass3:
      slot: 18
      material: 'STAINED_GLASS_PANE:15'
      name: ' '
    glass4:
      slot: 26
      material: 'STAINED_GLASS_PANE:15'
      name: ' '

browse

Botão que abre o mercado de aluguéis do servidor.

my-listings

Botão que abre o menu com as listagens do próprio jogador.

my-rentals

Botão que abre o menu com os aluguéis ativos do próprio jogador.

Menu paginado com todos os itens disponíveis para alugar no servidor.

browse-menu:
  name: '&8Mercado de Aluguéis'
  size: 54
  slots: [0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44]
  previous-slot: 48
  next-slot: 50
  back-slot: 49
  create-listing-slot: 45
  empty-slot: 22
  create-listing-button:
    material: NETHER_STAR
    name: '&a&lCriar Nova Listagem'
    lore:
      - ''
      - ' &7Coloque um item para alugar'
      - ' &7e ganhe dinheiro!'
      - ''
      - ' &eClique para criar'
      - ''
  listing-item:
    material: PAPER
    name: '&6{item}'
    lore:
      - ''
      - ' &7Dono: &f{owner}'
      - ' &7Preço/hora: &f{price} &7({provider})'
      - ' &7Status: &f{status}'
      - ''
      - ' &eClique para alugar'
      - ''
  empty:
    material: WEB
    name: '&cVazio'
    lore:
      - '&7Não há itens disponíveis para'
      - '&7aluguel nesta página.'

listing-item

Representa cada item disponível para alugar no mercado.

Placeholders disponíveis: {item}, {owner}, {price}, {provider}, {status}

Menu paginado para escolher a duração do aluguel, com base nos pré-sets configurados em config.yml.

duration-select-menu:
  name: '&8Selecionar Duração — {item}'
  size: 27
  slots: [10,11,12,13,14,15,16]
  previous-slot: 18
  next-slot: 26
  back-slot: 0
  duration-item:
    material: PAPER
    name: '&6{duration}'
    lore:
      - ''
      - ' &7Duração: &f{duration}'
      - ' &7Custo total: &f{price} &7({provider})'
      - ''
      - ' &eClique para confirmar'
      - ''

duration-item

Representa cada duração pré-definida disponível para seleção.

Placeholders disponíveis: {duration}, {price}, {provider}, {item}

Menu de confirmação exibido antes de finalizar o aluguel, evitando cliques acidentais.

rent-confirm-menu:
  name: '&8Confirmar Aluguel'
  size: 27
  item-slot: 13
  confirm-slot: 11
  cancel-slot: 15
  confirm:
    material: 'WOOL:5'
    name: '&aConfirmar Aluguel'
    lore:
      - ''
      - ' &7Item: &f{item}'
      - ' &7Dono: &f{owner}'
      - ' &7Duração: &f{duration}'
      - ' &7Custo total: &f{price} &7({provider})'
      - ''
      - ' &aClique para confirmar'
      - ''
  cancel:
    material: 'WOOL:14'
    name: '&cCancelar'
    lore:
      - ''
      - ' &7Clique para voltar ao mercado.'
      - ''

Placeholders disponíveis: {item}, {owner}, {duration}, {price}, {provider}

Menu onde o dono configura o item, preço e economia antes de publicar a listagem.

create-listing-menu:
  name: '&8Criar Listagem'
  size: 54
  item-slot: 13
  price-slot: 29
  item-value-slot: 31
  economy-slot: 33
  confirm-slot: 38
  cancel-slot: 42
  item-placeholder:
    material: 'BARRIER'
    name: '&eSem item selecionado'
    lore:
      - ''
      - ' &7Clique em algum item do seu'
      - ' &7inventário para selecioná-lo.'
      - ''
  price-button:
    material: 'GOLD_INGOT'
    name: '&6Preço por hora'
    lore:
      - ''
      - ' &7Preço atual: &f{price}'
      - ''
      - ' &eClique para definir'
      - ''
  item-value-button:
    material: 'DIAMOND'
    name: '&bValor do Item'
    lore:
      - ''
      - ' &7Declare o valor de mercado do item.'
      - ' &7Valor atual: &f{item_value}'
      - ''
      - ' &7Ao morrer ou ter o item recolhido,'
      - ' &7o locatário pagará uma multa'
      - ' &7proporcional a este valor.'
      - ''
      - ' &7Deixe em &f0 &7para não aplicar multa.'
      - ''
      - ' &eClique para definir'
      - ''
  economy-button:
    material: 'EMERALD'
    name: '&aEconomia'
    lore:
      - ''
      - ' &7Economia: &f{economy}'
      - ''
      - ' &eClique para alterar'
      - ''
  confirm-cant:
    material: 'WOOL:14'
    name: '&cNão é possível confirmar'
    lore:
      - ''
      - ' &7Preencha todos os campos:'
      - ' &7• Selecione um item'
      - ' &7• Defina um preço'
      - ' &7• Escolha uma economia'
      - ''
  confirm:
    material: 'WOOL:5'
    name: '&aConfirmar Listagem'
    lore:
      - ''
      - ' &7Item: &f{item}'
      - ' &7Preço/hora: &f{price} &7({provider})'
      - ' &7Valor do item: &f{item_value} &7({provider})'
      - ''
      - ' &aClique para confirmar'
      - ''
  cancel:
    material: 'WOOL:14'
    name: '&cCancelar'
    lore:
      - ''
      - ' &7Clique para cancelar.'
      - ''

Placeholders disponíveis: {item}, {price}, {item_value}, {provider}, {economy}

Menu paginado para escolher a economia da listagem, tanto na criação quanto na edição.

economy-select-menu:
  name: '&8Selecionar Economia'
  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: 45
  next-slot: 53
  back-slot: 49

Menu paginado com todos os itens que o jogador colocou para alugar.

my-listings-menu:
  name: '&8Minhas Listagens'
  size: 54
  slots: [0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44]
  previous-slot: 48
  next-slot: 50
  back-slot: 49
  create-listing-slot: 45
  empty-slot: 22
  create-listing-button:
    material: NETHER_STAR
    name: '&a&lCriar Nova Listagem'
    lore:
      - ''
      - ' &7Coloque um item para alugar'
      - ' &7e ganhe dinheiro!'
      - ''
      - ' &eClique para criar'
      - ''
  listing-item:
    material: PAPER
    name: '&6{item}'
    lore:
      - ''
      - ' &7Status: &f{status}'
      - ' &7Preço/hora: &f{price} &7({provider})'
      - ' &7Criado em: &f{created}'
      - ''
      - ' &eClique &7para gerenciar'
      - ''
  empty:
    material: WEB
    name: '&cVazio'
    lore:
      - '&7Não há itens disponíveis para'
      - '&7aluguel nesta página.'

listing-item

Representa cada listagem criada pelo jogador.

Placeholders disponíveis: {item}, {status}, {price}, {provider}, {created}

Menu paginado com todos os aluguéis ativos do jogador.

my-rentals-menu:
  name: '&8Meus Aluguéis'
  size: 54
  slots: [0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44]
  previous-slot: 48
  next-slot: 50
  back-slot: 49
  empty-slot: 22
  rental-item:
    material: PAPER
    name: '&6{item}'
    lore:
      - ''
      - ' &7Dono: &f{owner}'
      - ' &7Expira em: &f{expire}'
      - ' &7Tempo restante: &f{remaining}'
      - ' &7Total pago: &f{price} &7({provider})'
      - ''
      - ' &eClique &7para gerenciar'
      - ''
  empty:
    material: WEB
    name: '&cVazio'
    lore:
      - '&7Não há itens disponíveis para'
      - '&7aluguel nesta página.'

rental-item

Representa cada aluguel ativo do jogador.

Placeholders disponíveis: {item}, {owner}, {expire}, {remaining}, {price}, {provider}

Menu fixo para o locatário gerenciar um aluguel ativo: depositar, retirar e renovar o item.

manage-rental-menu:
  name: '&8Gerenciar Aluguel'
  size: 27
  item-slot: 13
  deposit-slot: 10
  retrieve-slot: 16
  renew-slot: 22
  back-slot: 4
  deposit:
    material: CHEST
    name: '&6Depositar Item'
    lore:
      - ''
      - ' &7Armazena o item alugado enquanto'
      - ' &7você não está usando.'
      - ''
      - ' &eClique para depositar'
      - ''
  deposit-cant:
    material: 'WOOL:14'
    name: '&cItem já depositado'
    lore:
      - ''
      - ' &7O item já está no armazém.'
      - ' &7Clique em &eRetirar Item &7para recuperá-lo.'
      - ''
  retrieve:
    material: 'WOOL:5'
    name: '&aRetirar Item'
    lore:
      - ''
      - ' &7Devolve o item ao seu inventário.'
      - ''
      - ' &eClique para retirar'
      - ''
  retrieve-cant:
    material: 'WOOL:14'
    name: '&cItem no inventário'
    lore:
      - ''
      - ' &7O item já está no seu inventário.'
      - ' &7Clique em &eDepositar &7para guardá-lo.'
      - ''
  renew:
    material: WATCH
    name: '&bRenovar Aluguel'
    lore:
      - ''
      - ' &7Expira em: &f{expire}'
      - ' &7Tempo restante: &f{remaining}'
      - ''
      - ' &eClique para renovar'
      - ''

Placeholders disponíveis no item renew: {expire}, {remaining}

Menu fixo para o dono gerenciar uma listagem: editar preço, editar economia, cancelar ou retirar o item.

manage-listing-menu:
  name: '&8Gerenciar Listagem'
  size: 27
  item-slot: 13
  edit-price-slot: 10
  edit-economy-slot: 11
  cancel-slot: 15
  collect-slot: 16
  back-slot: 22
  edit-price:
    material: GOLD_INGOT
    name: '&6Editar Preço'
    lore:
      - ''
      - ' &7Preço atual: &f{price} &7({provider})'
      - ''
      - ' &eClique para alterar'
      - ''
  edit-economy:
    material: EMERALD
    name: '&aEditar Economia'
    lore:
      - ''
      - ' &7Economia atual: &f{provider}'
      - ''
      - ' &eClique para alterar'
      - ''
  cancel:
    material: 'WOOL:14'
    name: '&cCancelar Listagem'
    lore:
      - ''
      - ' &7Clique para cancelar esta listagem.'
      - ''
  collect:
    material: 'WOOL:5'
    name: '&aRetirar Item'
    lore:
      - ''
      - ' &7Clique para retirar o item'
      - ' &7do armazém para seu inventário.'
      - ''
  collect-cant:
    material: 'WOOL:14'
    name: '&cItem indisponível'
    lore:
      - ''
      - ' &7O item só pode ser retirado'
      - ' &7após expirar ou ser cancelado.'
      - ''

Placeholders disponíveis: {price}, {provider}

Menu paginado com todos os itens guardados no armazém do dono (expirados, cancelados ou depositados).

owner-storage-menu:
  name: '&8Armazém — {player}'
  size: 54
  slots: [0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44]
  previous-slot: 48
  next-slot: 50
  back-slot: 49
  storage-item:
    material: PAPER
    name: '&6{item}'
    lore:
      - ''
      - ' &7Status: &f{status}'
      - ''
      - ' &eClique para retirar o item'
      - ''

Placeholders disponíveis: {player}, {item}, {status}

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8yAlugarItem — Menu'

size

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

Exemplo:

size: 54

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

slots

Define a lista de slots onde os itens paginados serão exibidos.

Exemplo:

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

back-slot / previous-slot / next-slot

Definem os slots dos botões de navegação.

Exemplo:

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

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

Exemplo completo de configuração

Estrutura de menus

arrows

back

previous

next

Menu principal (main-menu)

Itens do menu

browse

my-listings

my-rentals

Mercado de aluguéis (browse-menu)

Itens do menu

listing-item

Seleção de duração (duration-select-menu)

Itens do menu

duration-item

Confirmação de aluguel (rent-confirm-menu)

Criação de listagem (create-listing-menu)

Seleção de economia (economy-select-menu)

Minhas listagens (my-listings-menu)

Itens do menu

listing-item

Meus aluguéis (my-rentals-menu)

Itens do menu

rental-item

Gerenciar aluguel (manage-rental-menu)

Gerenciar listagem (manage-listing-menu)

Armazém do dono (owner-storage-menu)

Opções de configuração de menus

name

size

slots

back-slot / previous-slot / next-slot

Nesta página