Menus

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

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

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

Exemplo:

menu-updater: true

Tempo para atualizar o menu automaticamente em ticks.

Exemplo:

menu-updater-time: 200

20 ticks = 1 segundo. 200 ticks = 10 segundos.

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

Estrutura básica

main:
  name: '&8Leilão'
  size: 27
  items:
    center-slot: 10
    bids-slot: 12
    auctions-slot: 14
    courier-slot: 16

center

Botão para acessar a central de leilões.

Exemplo:

items:
  center:
    material: 'GOLD_BLOCK'
    name: '&eCentral de leilões'
    lore:
      - '&7Aqui você pode encontrar os'
      - '&7itens que estão sendo leiloados'
      - '&7pelos jogadores do servidor.'
      - ''
      - '&7Caso você consiga ter maior'
      - '&7lance até o fim do leilão de um'
      - '&7item, ele será seu.'
      - ''
      - '&eClique para ver os leilões.'

bids

Botão para ver os lances ativos do jogador.

Exemplo:

items:
  bids:
    material: 'GOLDEN_CARROT'
    name: '&eMeus lances'
    lore:
      - '&7Você possui &f{amount}'
      - '&7lance(s) no momento. :)'
      - ''
      - '&eClique para ver seus lances.'

Placeholder disponível: {amount}

bids-none

Exibido quando o jogador não possui lances ativos.

Exemplo:

items:
  bids-none:
    material: 'GOLDEN_CARROT'
    name: '&eMeus lances'
    lore:
      - '&7Você não possui nenhum'
      - '&7lance no momento. :('

auctions

Botão para acessar os leilões do jogador.

Exemplo:

items:
  auctions:
    material: 'GOLD_BARDING'
    name: '&eMeus leilões'
    lore:
      - '&7Anuncie seus itens na casa de'
      - '&7leilões para que outros jogadores'
      - '&7possam comprá-los.'
      - ''
      - '&eClique para leiloar.'

courier

Botão para acessar o correio.

Exemplo:

items:
  courier:
    material: 'CHEST'
    name: '&eMeu correio'
    lore:
      - '&7Colete aqui suas compras, leilões'
      - '&7cancelados ou expirados e valores'
      - '&7de lances não efetivados.'
      - ''
      - '&eClique para acessar.'

Menu onde os jogadores coletam itens e valores.

courier:
  name: '&8Leilão'
  size: 54
  slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 21, 22, 23, 24, 25, 28, 29, 31, 32, 33, 34 ]
  previous-slot: 18
  next-slot: 26
  back-slot: 47
  empty-slot: 22
  currencies-slot: 49

empty

Exibido quando o correio está vazio.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&cVazio...'
    lore: [ '&7Você não tem nenhum lance ativo!' ]

currencies

Botão para coletar valores acumulados.

Exemplo:

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

Placeholder disponível: {format}

currencies-none

Exibido quando não há valores para coletar.

Exemplo:

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

Formatos

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

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

Menu que exibe os lances ativos do jogador.

bids:
  name: '&8Leilão'
  size: 54
  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
  back-slot: 49
  empty-slot: 22

Lore dos itens

lore:
  - '&f'
  - ' &fLeiloador: &7{owner}'
  - ''
  - ' {format}'
  - ''
  - '&8> &fTermina em: &7{time}'
  - '&8> &fSeu lance: &6{amount} {provider_abbreviated}'
  - ''
  - '&eClique para aumentar o seu lance.'

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

Formatos

formats:
  bid: ' &7> {pos}º {player}: &f{amount} {provider_abbreviated}'
  none: ' &cNenhum lance até o momento'
  has: ' &eMaiores lances:<nl>{formats}'

Placeholders disponíveis: {pos}, {player}, {amount}, {provider_abbreviated}, {formats}

Menu que exibe todos os leilões ativos.

auctions:
  name: '&8Leilão'
  size: 54
  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
  back-slot: 48
  empty-slot: 22
  filter-slot: 50
  bids-slot: -1
  auctions-slot: -1
  courier-slot: -1

filter

Botão para filtrar os leilões.

Exemplo:

items:
  filter:
    material: HOPPER
    name: '&aFiltro'

bids

Botão para ver os lances ativos do jogador.

Exemplo:

items:
  bids:
    material: 'GOLDEN_CARROT'
    name: '&eMeus lances'
    lore:
      - '&7Você possui &f{amount}'
      - '&7lance(s) no momento. :)'
      - ''
      - '&eClique para ver seus lances.'

Placeholder disponível: {amount}

auctions

Botão para acessar os leilões do jogador.

Exemplo:

items:
  auctions:
    material: 'GOLD_BARDING'
    name: '&eMeus leilões'
    lore:
      - '&7Anuncie seus itens na casa de'
      - '&7leilões para que outros jogadores'
      - '&7possam comprá-los.'
      - ''
      - '&eClique para leiloar.'

courier

Botão para acessar o correio.

Exemplo:

items:
  courier:
    material: 'CHEST'
    name: '&eMeu correio'
    lore:
      - '&7Colete aqui suas compras, leilões'
      - '&7cancelados ou expirados e valores'
      - '&7de lances não efetivados.'
      - ''
      - '&eClique para acessar.'

Lore dos itens

lore:
  - '&r'
  - ' &fLeiloador: &7{owner}'
  - ''
  - ' {format}'
  - ''
  - '&8> &fTermina em: &7{time}'
  - '&8> &fLance inicial: &6{amount} {provider_abbreviated}'
  - ''
  - '&eClique para dar um lance.'

Lore quando o jogador já tem lance

lore-has:
  - '&r'
  - ' &fLeiloador: &7{owner}'
  - ''
  - ' {format}'
  - ''
  - '&8> &fTermina em: &7{time}'
  - '&8> &fLance inicial: &6{amount} {provider_abbreviated}'
  - ''
  - '&eClique para aumentar seu lance.'

Sistema de filtro

filter:
  types:
    oldest: 'Menor tempo restante'
    newest: 'Maior tempo restante'
  format:
    seeing: ' &f• &a{name}'
    select: ' &f• &7{name}'

Placeholder disponível: {name}

Menu que exibe os leilões do próprio jogador.

my-auctions:
  name: '&8Leilão'
  size: 36
  slots: [ 11, 12, 13, 14, 15 ]
  previous-slot: 9
  next-slot: 17
  back-slot: 27
  empty-slot: 13
  create-slot: 31

create

Botão para criar um novo leilão.

Exemplo:

items:
  create:
    material: '2ddcfe7d91cd80b364cc060160a0699386d096e0e5adf98e8e45e0a198631d8f'
    name: '&aIniciar um leilão'
    lore: [ '&7Faça um leilão do seu item para', '&7ver quem paga mais por ele.', '', '&aClique para iniciar.' ]

Lore dos itens

lore:
  - '&f'
  - '{format}'
  - ''
  - '&8> &fTermina em: &7{time}'
  - '&8> &fLance inicial: &6{amount} {provider_abbreviated}'
  - ''
  - '&eClique para remover o leilão.'

Menu onde os jogadores criam novos leilões.

create:
  name: '&8Leilão'
  size: 45
  back-slot: 0
  items:
    item-slot: 13
    confirm-slot: 28
    provider-slot: 30
    start-bid-slot: 32
    duration-slot: 34

item

Exibido quando nenhum item foi selecionado.

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 o leilão.

Exemplo:

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

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

confirm-cant

Exibido quando não é possível criar o leilão.

Exemplo:

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

provider

Botão para selecionar a economia do leilão.

Exemplo:

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

start-bid

Botão para definir o lance inicial.

Exemplo:

items:
  start-bid:
    material: 'GOLD_INGOT'
    name: '&6Lance inicial'
    lore:
      - '&7Defina o valor mínimo que um jogador'
      - '&7pode oferecer pelo seu item.'
      - ''
      - '&7Lance inicial: &f{amount} {provider_abbreviated}'
      - ''
      - '&eClique para modificar.'

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

duration

Botão para definir a duração do leilão.

Exemplo:

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

Placeholder disponível: {time}

Menu para escolher a economia do leilão.

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

Menu para escolher a duração do leilão.

durations:
  name: '&8Selecionar duração'
  size: 36
  previous: 9
  next: 17
  back: 27
  slots: [ 11, 12, 13, 14, 15 ]

select

Botão para definir duração customizada.

Exemplo:

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

Opções de duração predefinidas

items:
  15min:
    material: 'PAPER'
    name: '&a15m'
    nbt-tag: [ 'yLeilao-Duration=>900' ]
  30min:
    material: 'PAPER'
    name: '&a30m'
    nbt-tag: [ 'yLeilao-Duration=>1800' ]
  1hour:
    material: 'PAPER'
    name: '&a1h'
    nbt-tag: [ 'yLeilao-Duration=>3600' ]
  2hour:
    material: 'PAPER'
    name: '&a2h'
    nbt-tag: [ 'yLeilao-Duration=>7200' ]
  3hour:
    material: 'PAPER'
    name: '&a3h'
    nbt-tag: [ 'yLeilao-Duration=>10800' ]
  4hour:
    material: 'PAPER'
    name: '&a4h'
    nbt-tag: [ 'yLeilao-Duration=>14400' ]
  5hour:
    material: 'PAPER'
    name: '&a5h'
    nbt-tag: [ 'yLeilao-Duration=>18000' ]
  6hour:
    material: 'PAPER'
    name: '&a6h'
    nbt-tag: [ 'yLeilao-Duration=>21600' ]

Opções de configuração de menus

name

Define o título do menu exibido no topo.

Exemplo:

name: '&8Leilão'

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 ]

Menu que exibe o histórico de todos os leilões finalizados, cancelados ou expirados.

history:
  name: '&8Histórico de Leilões'
  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: 49
  empty-slot: 22

Slots especiais:

previous-slot: Botão para página anterior
next-slot: Botão para próxima página
back-slot: Botão para voltar ao menu principal
empty-slot: Placeholder quando não há leilões

Itens do histórico

empty

Exibido quando não há histórico.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&cVazio...'
    lore: [ '&7Não há nenhum histórico de leilões!' ]

Formatos de lore

Leilão finalizado:

lore-completed:
  - '&r'
  - ' &fVendedor: &7{seller}'
  - ' &fComprador: &7{winner}'
  - ''
  - '&8> &fLance final: &6{final_bid} {provider_abbreviated}'
  - '&8> &fData: &7{date}'
  - '&8> &fStatus: &aFinalizado'

Leilão cancelado:

lore-cancelled:
  - '&r'
  - ' &fVendedor: &7{seller}'
  - ''
  - '&8> &fLance inicial: &6{start_bid} {provider_abbreviated}'
  - '&8> &fData: &7{date}'
  - '&8> &fStatus: &cCancelado'

Leilão expirado:

lore-expired:
  - '&r'
  - ' &fVendedor: &7{seller}'
  - ''
  - '&8> &fLance inicial: &6{start_bid} {provider_abbreviated}'
  - '&8> &fData: &7{date}'
  - '&8> &fStatus: &7Expirado'

Menu que exibe o histórico de itens e valores recebidos/coletados no correio.

courier-history:
  name: '&8Histórico do Correio'
  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: 49
  empty-slot: 22

Itens do histórico do correio

empty

Exibido quando não há histórico.

Exemplo:

items:
  empty:
    material: 'WEB'
    name: '&cVazio...'
    lore: [ '&7Você não possui nenhum histórico no correio!' ]

Tipos de histórico

Item recebido:

item-received:
  material: 'CHEST'
  name: '&aItem Recebido'

Item coletado:

item-collected:
  material: 'CHEST'
  name: '&eItem Coletado'

Valor recebido:

currency-received:
  material: 'GOLD_INGOT'
  name: '&aValor Recebido'

Valor coletado:

currency-collected:
  material: 'GOLD_INGOT'
  name: '&eValor Coletado'

Formatos de lore

Item recebido:

lore-item-received:
  - '&r'
  - ' &fTipo: &aItem Recebido'
  - ' &fDe: &7{related_player}'
  - ''
  - '&8> &fData: &7{date}'

Item coletado:

lore-item-collected:
  - '&r'
  - ' &fTipo: &eItem Coletado'
  - ''
  - '&8> &fData: &7{date}'

Valor recebido:

lore-currency-received:
  - '&r'
  - ' &fTipo: &aValor Recebido'
  - ' &fDe: &7{related_player}'
  - ' &fValor: &6{amount} {provider_abbreviated}'
  - ''
  - '&8> &fData: &7{date}'

Valor coletado:

lore-currency-collected:
  - '&r'
  - ' &fTipo: &eValor Coletado'
  - ' &fValor: &6{amount} {provider_abbreviated}'
  - ''
  - '&8> &fData: &7{date}'

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

Após alterar a configuração, é necessário reiniciar o servidor para aplicar as mudanças.

Nesta página