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
menu-updater
Ativa o sistema de atualização automática do menu principal enquanto está aberto.
Exemplo:
menu-updater: trueCom esta opção ativada, os itens no menu principal são atualizados automaticamente conforme novos anúncios são adicionados ou expiram.
menu-updater-time
Define o tempo em ticks para atualizar o menu automaticamente (20 ticks = 1 segundo).
Exemplo:
menu-updater-time: 200Estrutura 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 (main)
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: 52Opçõ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: 54Valores válidos: 9, 18, 27, 36, 45, 54
sponsored-slots
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: 26Itens do menu principal
sponsored
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 de criação (create)
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: 34Itens 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 de gerenciamento (edit)
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: 34Itens 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}
sponsor
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 de seleção de economias (providers)
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 de seleção de duração (durations)
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 de vendas próprias (my-sells)
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 de vendas (sells)
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 (confirm)
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.