LogoyStore

Menus

Personalize a aparência e comportamento dos menus do plugin.

Exemplo completo de configuração

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

# Ativar o sistema de atualizar o menu principal automaticamente enquanto estiver aberto
menu-updater: true
# Tempo para atualizar o menu automaticamente (em ticks, 20 ticks = 1s)
menu-updater-time: 200

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

Configurações globais

Ativa o sistema de atualização automática do menu principal enquanto está aberto.

Exemplo:

menu-updater: true

Com esta opção ativada, os itens no menu principal são atualizados automaticamente conforme novos anúncios são adicionados ou expiram.

Define o tempo em ticks para atualizar o menu automaticamente (20 ticks = 1 segundo).

Exemplo:

menu-updater-time: 200

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

previous

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

next

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

Estrutura básica

main:
  name: '&8Mercado'
  size: 54
  sponsored-slots: [ 16, 25, 34 ]
  scroller:
    enabled: false
    slots: [ 11, 12, 13, 14, 15, 16, 19, 21, 22, 23, 24, 25, 28, 29, 31, 32, 33, 34 ]
    previous-slot: 18
    next-slot: 26
  items:
    sponsored-slot: 12
    currencies-slot: 46
    personal-slot: 49
    own-slot: 52

Opções de configuração

name

Define o título do menu exibido no topo.

Exemplo:

main:
  name: '&8Mercado'

size

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

Exemplo:

main:
  size: 54

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

Define os slots onde os itens em destaque serão exibidos no menu principal.

Exemplo:

main:
  sponsored-slots: [ 16, 25, 34 ]

Os itens destacados aparecem nestes slots fixos no menu principal, dando mais visibilidade aos anúncios patrocinados.

scroller

Sistema de rolagem para exibir categorias ou itens.

Exemplo:

main:
  scroller:
    enabled: false
    slots: [ 11, 12, 13, 14, 15, 16, 19, 21, 22, 23, 24, 25, 28, 29, 31, 32, 33, 34 ]
    previous-slot: 18
    next-slot: 26

Itens do menu principal

Botão para acessar o menu de itens em destaque.

Exemplo:

items:
  sponsored:
    material: 'NETHER_STAR'
    name: '&aDestaques!'
    lore:
      - '&7Aqui você pode encontrar os'
      - '&7melhores itens que estão anunciados'
      - '&7no nosso servidor.'
      - ''
      - '&f* &bAtualmente possuímos &f&n{amount}'
      - '&bitens(s) em destaque. :)'
      - ''
      - '&eClique para ver os anúncios.'

Placeholder disponível: {amount} - Quantidade de itens em destaque

personal

Botão para acessar o mercado pessoal.

Exemplo:

items:
  personal:
    material: '{player}'
    name: '&aMercado Pessoal'
    lore:
      - '&7Aqui você pode encontrar os'
      - '&7itens que outros jogadores'
      - '&7anunciaram exclusivamente para você.'
      - ''
      - '&7Você possui &f&n{amount}'
      - '&7anúncio(s) exclusivo(s) no momento. :)'
      - ''
      - '&eClique para ver os anúncios.'

Use {player} como material para exibir a cabeça do jogador. Placeholder disponível: {amount} - Quantidade de anúncios pessoais

own

Botão para acessar os anúncios próprios do jogador.

Exemplo:

items:
  own:
    material: 'b544a770e894a1fab11e2a2bac15fe3d96946fa52396b531978eb37ac64b8a90'
    name: '&eMeus Anúncios'
    lore:
      - '&7Veja aqui os itens colocados'
      - '&7a venda por você.'
      - ''
      - '&7Você possui &f&n{amount}'
      - '&7itens(s) no momento. :)'
      - ''
      - '&eClique para ver seus anúncios.'

Placeholder disponível: {amount} - Quantidade de anúncios do jogador

currencies

Botão para coletar valores de vendas realizadas.

Exemplo quando há valores:

items:
  currencies:
    material: 'GOLD_INGOT'
    name: '&eValores'
    lore:
      - '&r'
      - ' &eValores a receber:'
      - ' {format}'
      - ''
      - '&eClique para coletar os valores.'

Exemplo quando não há valores:

items:
  currencies-none:
    material: 'GOLD_INGOT'
    name: '&cValores'
    lore: [ '&7Você não tem nenhum valor para coletar!' ]

Placeholder disponível: {format} - Lista formatada de valores a receber

facing

Itens decorativos para slots de destaque vazios.

Exemplo:

facing:
  e1:
    slot: 16
    material: 'BARRIER'
    name: '&cSlot de Destaque'
  e2:
    slot: 25
    material: 'BARRIER'
    name: '&cSlot de Destaque'
  e3:
    slot: 34
    material: 'BARRIER'
    name: '&cSlot de Destaque'

Formatos e lore

formats.currency

Formato para exibir cada tipo de moeda no botão de valores.

Exemplo:

formats:
  currency: ' &7> &f{amount} {provider_abbreviated}'

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

lore

Lore exibida nos itens em destaque no menu principal.

Exemplo:

lore:
  - '&r'
  - ' &f* &bITEM EM DESTAQUE &f*'
  - ''
  - ' &fVendedor: &7{owner}'
  - ''
  - '&8> &fPreço: &a{amount} {provider_abbreviated}'
  - '&8> &fExpira em: &7{time}'
  - ''
  - '&eClique para adquirir este item.'

Placeholders disponíveis: {owner}, {amount}, {provider_abbreviated}, {time}

Menu exibido quando o jogador inicia uma nova venda.

Estrutura básica

create:
  name: '&8Mercado'
  size: 45
  back-slot: 0
  items:
    item-slot: 13
    confirm-slot: 28
    provider-slot: 30
    price-slot: 31
    duration-slot: 33
    target-slot: 34

Itens do menu de criação

item

Indicador do slot onde o jogador deve clicar em um item do inventário.

Exemplo:

items:
  item:
    material: 'BARRIER'
    name: '&eClique em algum item do seu inventário'
    lore:
      - '&7Selecione algum item para leiloar.'

confirm

Botão para confirmar e iniciar a venda.

Exemplo quando pode confirmar:

items:
  confirm:
    material: 'STAINED_CLAY:5'
    name: '&aIniciar'
    lore:
      - '&7Esse item será anunciado para'
      - '&7outros jogadores comprarem.'
      - ''
      - '&8> &fItem: &7{item}'
      - '&8> &fDuração: &6{time}'
      - '&8> &fPreço: &6{amount} {provider_abbreviated}'
      - ''

Exemplo quando não pode confirmar:

items:
  confirm-cant:
    material: 'STAINED_CLAY:14'
    name: '&cIniciar'
    lore:
      - '&7Selecione um item do seu inventário'
      - '&7para iniciar este anúncio.'

Placeholders disponíveis: {item}, {time}, {amount}, {provider_abbreviated}

provider

Botão para selecionar a moeda da venda.

Exemplo:

items:
  provider:
    material: '61a8e6d27b96c0aa4df5b8347260eb051c56944c97d837f22655d8ecbc449137'
    name: '&aMoeda'
    lore:
      - '&7Moeda que será utilizada no anúncio'
      - '&7deste item.'
      - ''
      - '&7Atual: &fNenhuma'
      - ''
      - '&aClique para alterar a moeda'

price

Botão para definir o preço do item.

Exemplo:

items:
  price:
    material: 'GOLD_INGOT'
    name: '&6Preço'
    lore:
      - '&7Defina o valor que o jogador'
      - '&7terá que pagar pelo seu item.'
      - ''
      - '&7Preço: &f{amount} {provider_abbreviated}'
      - ''
      - '&eClique para modificar.'

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

duration

Botão para definir a duração da venda.

Exemplo:

items:
  duration:
    material: 'WATCH'
    name: '&aDuração customizada'
    lore:
      - '&7Defina um tempo específico'
      - '&7para a duração do seu anúncio.'
      - ''
      - '&fDuração: &6{time}'
      - ''
      - '&eClique para modificar.'

Placeholder disponível: {time} - Duração formatada

target

Botão para definir o alvo da venda (venda pessoal).

Exemplo:

items:
  target:
    material: '{player}'
    name: '&aPessoa alvo'
    lore:
      - '&7Defina quem poderá comprar'
      - '&7este seu anúncio.'
      - ''
      - '&fAlvo: &6{target}'
      - ''
      - '&eBotão &fESQUERDO&e para alterar.'
      - '&eBotão &fDIREITO&e para resetar.'

Placeholder disponível: {target} - Nome do jogador alvo ou "Ninguém"

Menu para gerenciar uma venda já criada.

Estrutura básica

edit:
  name: '&8Mercado'
  size: 45
  back-slot: 0
  items:
    item-slot: 13
    expire-slot: 28
    provider-slot: 30
    price-slot: 31
    sponsor-slot: 33
    target-slot: 34

Itens do menu de gerenciamento

expire

Botão para expirar/cancelar a venda.

Exemplo:

items:
  expire:
    material: 'STAINED_CLAY:14'
    name: '&aExpirar'
    lore:
      - '&7Esse anúncio será cancelado'
      - '&7e o item ficará disponível para coleta.'
      - ''
      - '&8> &fItem: &7{item}'
      - '&8> &fDuração: &6{time}'
      - '&8> &fPreço: &6{amount} {provider_abbreviated}'
      - ''
      - '&eClique para cancelar o anúncio.'

Placeholders disponíveis: {item}, {time}, {amount}, {provider_abbreviated}

Botões para destacar a venda.

Quando tem permissão gratuita:

items:
  sponsor-perm:
    material: 'NETHER_STAR'
    name: '&aDestacar'
    lore:
      - '&7Deixe esse anúncio destacado nas'
      - '&7páginas de venda e em uma'
      - '&7categoria exclusiva.'
      - ''
      - ' &f* &aVocê é VIP e pode destacar seus'
      - ' &a  anúncios gratuitamente.'
      - ''
      - '&eClique para destacar.'

Quando já está destacado:

items:
  sponsor-already:
    material: 'NETHER_STAR'
    name: '&aDestacar'
    lore:
      - '&7Deixe esse anúncio destacado nas'
      - '&7páginas de venda e em uma'
      - '&7categoria exclusiva.'
      - ''
      - '&aEste item já está destacado.'

Quando precisa pagar:

items:
  sponsor:
    material: 'NETHER_STAR'
    name: '&aDestacar'
    lore:
      - '&7Deixe esse anúncio destacado nas'
      - '&7páginas de venda e em uma'
      - '&7categoria exclusiva.'
      - ''
      - ' &f* Preço: &2$ &a{money} coins&f.'
      - ''
      - '&eClique para destacar.'

Placeholder disponível: {money} - Preço para destacar

Menu para selecionar a economia da venda.

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

Menu para selecionar a duração da venda.

durations:
  name: '&8Selecionar duração'
  size: 36
  previous: 9
  next: 17
  back: 27
  slots: [ 11, 12, 13, 14, 15 ]
  items:
    select-slot: 31
    select:
      material: 'WATCH'
      name: '&aDuração customizada'
      lore:
        - '&7Defina um tempo específico'
        - '&7para a duração do seu leilão.'
        - ''
        - '&eClique para definir.'
    15min:
      material: 'PAPER'
      name: '&a15m'
      nbt-tag: [ 'yMarket-Duration=>900' ]
    30min:
      material: 'PAPER'
      name: '&a30m'
      nbt-tag: [ 'yMarket-Duration=>1800' ]
    1hour:
      material: 'PAPER'
      name: '&a1h'
      nbt-tag: [ 'yMarket-Duration=>3600' ]

Não altere os valores das NBT tags, pois eles são usados internamente pelo plugin para identificar a duração selecionada.

Menu que exibe as vendas próprias do jogador.

my-sells:
  name: '&8Mercado'
  size: 36
  slots: [ 11, 12, 13, 14, 15 ]
  previous-slot: 9
  next-slot: 17
  back-slot: 27
  empty-slot: 13
  create-slot: 31
  items:
    empty:
      material: 'WEB'
      name: '&cVazio...'
      lore: [ '&7Você não tem nenhum anúncio ativo!' ]
    create:
      material: '2ddcfe7d91cd80b364cc060160a0699386d096e0e5adf98e8e45e0a198631d8f'
      name: '&aVender um Item'
      lore: [ '&7Faça um anúncio do seu item para', '&7ver quem gostaria de adquirí-lo.', '', '&aClique para iniciar.' ]
  lore:
    - '&f'
    - '&8> &fPreço: &a{amount} {provider_abbreviated}'
    - '&8> &fVender para: &b{target}'
    - ''
    - '&8> &fExpira em: &7{time}'
    - ''
    - '&eClique para gerenciar o anúncio.'
  lore-expired:
    - '&f'
    - '&8> &fPreço: &a{amount} {provider_abbreviated}'
    - ''
    - '&8* Expirado *'
    - ''
    - '&eClique para coletar o item'
    - '&epara o seu inventário.'

Placeholders disponíveis: {amount}, {provider_abbreviated}, {target}, {time}

Menu que exibe todas as vendas de uma categoria.

sells:
  name: '&8Mercado'
  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: 18
  next-slot: 26
  back-slot: 48
  empty-slot: 22
  filter-slot: 50
  items:
    empty:
      material: 'WEB'
      name: '&cVazio...'
      lore: [ '&7Não há nenhum anúncio ocorrendo!' ]
    filter:
      material: HOPPER
      name: '&aFiltro'
  lore:
    - '&r'
    - ' &fVendedor: &7{owner}'
    - ''
    - '&8> &fPreço: &a{amount} {provider_abbreviated}'
    - '&8> &fExpira em: &7{time}'
    - ''
    - '&eBotão &7ESQUERDO&e para adquirir este item.'
  filter:
    types:
      oldest: 'Menor tempo restante'
      newest: 'Maior tempo restante'
    format:
      seeing: ' &f• &a{name}'
      select: ' &f• &7{name}'

Placeholders disponíveis: {owner}, {amount}, {provider_abbreviated}, {time}, {name}

Menu de confirmação de compra.

confirm:
  name: '&8Mercado'
  size: 27
  items:
    item-slot: 13
    confirm-slot: 11
    cancel-slot: 15
    confirm:
      material: 'WOOL:5'
      name: '&aCONFIRMAR'
      lore:
        - '&7Você está prestes a adquirir'
        - '&7um item no nosso mercado.'
        - ''
        - '&aClique para CONFIRMAR a compra.'
    cancel:
      material: 'WOOL:14'
      name: '&cCANCELAR'
      lore:
        - '&7Você está prestes a desistir de'
        - '&7comprar um item no nosso mercado.'
        - ''
        - '&cClique para DESISTIR da compra.'
  lore:
    - '&r'
    - ' &fVendedor: &7{owner}'
    - ''
    - '&8> &fPreço: &a{amount} {provider_abbreviated}'
    - '&8> &fExpira em: &7{time}'
    - ''

Placeholders disponíveis: {owner}, {amount}, {provider_abbreviated}, {time}

Após alterar os menus, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página