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: '&8Loja'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  empty-slot: 22
  my-shop-slot: 39
  favorites-slot: 41

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 /playershop.

Estrutura básica

main:
  name: '&8Loja'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  previous-slot: 18
  next-slot: 26
  empty-slot: 22
  my-shop-slot: 39
  favorites-slot: 41

empty

Exibido quando não há lojas abertas.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&eVazio...'
    lore: [ '&7Nenhuma loja aberta', '&7no momento.' ]

my-shop

Botão para acessar a própria loja do jogador.

Exemplo:

items:
  my-shop:
    material: '182d36b973e57e4c0fe28c371a7f11fc04a2a342a88a7e5e5d83edbcab61770e'
    name: '&aMinha Loja'
    lore: [ '', ' &fSlots ocupados: &c{slots_used}&7/&a{slots_total}', ' &fEstoque atual: &b{stock} itens', ' &fAvaliação: &e{rating} &7({rating_raw}/5.0) {rating_amount}', '', '&aClique para gerenciar sua loja' ]

Placeholders disponíveis: {slots_used}, {slots_total}, {stock}, {rating}, {rating_raw}, {rating_amount}

shop

Exibe lojas de outros jogadores.

Exemplo:

items:
  shop:
    material: '{player}'
    name: '&eLoja de {player}'
    lore: [ '', ' &fAvaliação: &e{rating} &7({rating_raw}/5.0) {rating_amount}', '', '&aClique para visualizar' ]

Placeholders disponíveis: {player}, {rating}, {rating_raw}, {rating_amount}

favorites

Botão para acessar lojas favoritas.

Exemplo:

items:
  favorites:
    material: 'd4a1d6d0a62e1e46e76fec45a5dd2ffbe4bf0b35b7f4c75f6d23f676f77992fd'
    name: '&eFavoritas'
    lore: [ '', ' &fLojas favoritadas: &b{amount}', '', '&aClique para visualizar' ]

Placeholder disponível: {amount}

Menu que exibe as lojas favoritadas pelo jogador.

favorites:
  name: '&8Loja'
  size: 54
  slots: [ 11, 12, 13, 14, 15, 20, 21, 22, 23, 24 ]
  back-slot: 38
  previous-slot: 41
  next-slot: 42

facing

Configuração de itens decorativos para o menu quando está vazio.

Exemplo:

facing:
  e1:
    slot: 11
    material: 'STAINED_GLASS_PANE:14'
  e2:
    slot: 12
    material: 'STAINED_GLASS_PANE:14'

Menu onde o jogador gerencia sua própria loja.

my-shop:
  name: '&8Loja'
  size: 54
  slots: [ 12, 13, 14, 15, 16, 21, 22, 23, 24, 25 ]
  back-slot: 37
  previous-slot: 42
  next-slot: 43
  items:
    info-slot: 10
    categories-slot: 19
    settings-slot: 39
    preview-slot: 40
    add-cancel-slot: 41

info

Exibe informações da loja e permite abrir/fechar.

Exemplo:

items:
  info:
    material: '182d36b973e57e4c0fe28c371a7f11fc04a2a342a88a7e5e5d83edbcab61770e'
    name: '&aInformações'
    lore:
      - ''
      - ' &fSlots ocupados: &c{slots_used}&7/&a{slots_total}'
      - ' &fEstoque atual: &b{stock} itens'
      - ' &fAvaliação: &e{rating} &7({rating_raw}/5.0) {rating_amount}'
      - ''
      - ' &fLoja aberta: {status}'
      - ''
      - '&aClique para abrir ou fechar a loja'

Placeholders disponíveis: {slots_used}, {slots_total}, {stock}, {rating}, {rating_raw}, {rating_amount}, {status}

settings

Botão para configurações do menu.

Exemplo:

items:
  settings:
    material: HOPPER
    name: '&aConfigurações do Menu'
    lore:
      - '&7Configure o tamanho, slots'
      - '&7setas e botões diversos.'
      - ''
      - '&aClique para gerenciar'

preview

Botão para pré-visualizar a loja.

Exemplo:

items:
  preview:
    material: EYE_OF_ENDER
    name: '&aPre-visualização'
    lore:
      - '&7Veja como irá ficar a sua'
      - '&7loja para os outros jogadores.'
      - ''
      - '&aClique para ver'

add

Botão para adicionar itens à loja.

Exemplo:

items:
  add:
    material: '32332b770a4874698862855da5b3fe47f19ab291df766b6083b5f9a0c3c6847e'
    name: '&aAdicionar Item'
    lore:
      - '&7Adicione mais um item no'
      - '&7catálogo de sua loja.'
      - ''
      - '&f * Ao ativar o modo seleção'
      - '&f clique em um item no seu inventário'
      - ''
      - '&aClique para ativar o modo'

item

Formato dos itens na loja.

Exemplo:

items:
  item:
    lore:
      - ''
      - '&fEstoque: &b{amount}'
      - '&fCategoria: &b{category}'
      - ''
      - '&aBotão &fESQUERDO &apara configurar'
      - '&aBotão &fQ &apara deletar'

Placeholders disponíveis: {amount}, {category}

Menu para configurar slots e tamanho da loja.

my-shop-options:
  name: '&8Loja'
  size: 27
  back-slot: 22
  items:
    size-slot: 10
    back-slot-slot: 12
    previous-slot-slot: 13
    next-slot-slot: 14
    review-slot-slot: 15
    favorite-slot-slot: 16

size

Permite alterar o tamanho do menu da loja.

Exemplo:

items:
  size:
    material: CHEST
    name: '&aTamanho'
    lore:
      - '&7Tamanho do menu da'
      - '&7sua loja.'
      - ''
      - '&f Atual: &a{size}'
      - ''
      - '&aClique para alternar o tamanho'

Placeholder disponível: {size}

Menu para configurar itens individuais da loja.

item-options:
  name: '&8Loja'
  size: 27
  back-slot: 10
  items:
    stock-add-slot: 12
    stock-remove-slot: 13
    category-slot: 14
    type-slot: 15
    economies-slot: 16

stock-add

Adicionar estoque ao item.

Exemplo:

items:
  stock-add:
    material: '32332b770a4874698862855da5b3fe47f19ab291df766b6083b5f9a0c3c6847e'
    name: '&a+ Estoque'
    lore:
      - '&7Adicione mais itens ao'
      - '&7estoque da sua loja.'
      - ''
      - ' &f Atual: &a{amount}'
      - ''
      - '&aBotão &fESQUERDO&a para adicionar 64'
      - '&aBotão &fDIREITO&a para adicionar 1'
      - '&aBotão &fQ&a para adicionar TUDO'

type-buy, type-sell, type-buy-sell

Define o tipo de operação (compra, venda ou ambos).

Exemplo:

items:
  type-buy:
    material: '7e3deb57eaa2f4d403ad57283ce8b41805ee5b6de912ee2b4ea736a9d1f465a7'
    name: '&aTipo da loja'
    lore:
      - '&7Tipo da sua loja:'
      - ''
      - ' &f• &aComprar item &8(Jogadores vendem a você)'
      - ' &f• &7Vender item &8(Jogadores compram de você)'
      - ' &f• &7Comprar e vender item'
      - ''
      - '&aClique para alterar'

Menu exibido quando um jogador visita a loja de outro.

player-shop:
  name: '&8Loja de: &7{player}'
  item:
    buy: '&2C &r{price_buy} &7({provider_abbreviated})'
    sell: '&cV &r{price_sell} &7({provider_abbreviated})'
    buy-sell: '&2C &r{price_buy} | &cV &r{price_sell} &7({provider_abbreviated})'
    none: '&cNenhuma economia configurada.'
    lore:
      - ''
      - '&fEstoque: &b{amount}'
      - '&fCategoria: &b{category}'
      - ''
      - '{formats}'
      - ''
      - '&aClique para comercializar'

Placeholders disponíveis: {player}, {price_buy}, {price_sell}, {provider_abbreviated}, {amount}, {category}, {formats}

favorite

Botão para favoritar a loja.

Exemplo:

items:
  favorite:
    material: 'd4a1d6d0a62e1e46e76fec45a5dd2ffbe4bf0b35b7f4c75f6d23f676f77992fd'
    name: '&eFavoritar'
    lore: [ '&7Coloque esta loja na', '&7sua lista de lojas favoritas.', '', ' &fFavorita: &r{status}&f.', '', '&aClique para alternar' ]

review

Botão para avaliar a loja.

Exemplo:

items:
  review:
    material: 'GLASS_BOTTLE'
    name: '&eAvaliar'
    lore: [ '&7Avalie essa loja com uma', '&7nota de 0 a 5.', '', ' &cVocê ainda não avaliou', '' ]

Menu para avaliar uma loja com estrelas.

review:
  name: '&8Loja de: &7{player}'
  size: 27
  back-slot: 10
  items:
    one-slot: 12
    two-slot: 13
    three-slot: 14
    four-slot: 15
    five-slot: 16

Menu para realizar transações.

buy-sell:
  name: '&8Loja de: &7{player}'
  size: 27
  back-slot: 9
  items:
    display-slot: 11
    buy-slot: 13
    sell-slot: 14
    amount-slot: 16

buy

Botão para comprar itens.

Exemplo:

items:
  buy:
    material: '22d145c93e5eac48a661c6f27fdaff5922cf433dd627bf23eec378b9956197'
    name: '&aComprar'
    lore:
      - '&7Comprar o item à venda'
      - ''
      - '{formats}'
      - ''
      - ' &7Estoque atual: &f{stock}'
      - ''
      - '&aBotão &fESQUERDO&a para comprar &f{amount}'

sell

Botão para vender itens.

Exemplo:

items:
  sell:
    material: 'c532576b8bc9a876419a39ae4498c456fe9ee5bdc7ba91fd3b2f1b0a7eb91'
    name: '&aVender'
    lore:
      - '&7Vender seus itens à loja'
      - ''
      - '{formats}'
      - ''
      - '&aBotão &fESQUERDO&a para vender &f{amount}'

Menu para gerenciar categorias da loja.

categories:
  name: '&8Loja'
  size: 45
  slots: [ 12, 13, 14, 15, 16 ]
  back-slot: 28
  previous-slot: 33
  next-slot: 34
  items:
    add-slot: 10

Menu para configurar uma categoria específica.

categories-options:
  name: '&8Loja'
  size: 27
  back-slot: 22
  items:
    icon-slot: 11
    slot-slot: 13
    name-slot: 15

Menu para selecionar o ícone de uma categoria.

categories-icon:
  name: '&8Loja'
  size: 54
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 37, 38, 39 ]
  back-slot: 45
  previous-slot: 41
  next-slot: 43
  items:
    add-slot: 42

Menu para selecionar economia ao configurar preços.

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

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Loja'

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 ]

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