Menus

Exemplo completo de configuração

Aqui está o conteúdo completo do arquivo menus.yml do plugin:

#
#    /\/\   ___ _ __  _   _ ___
#   /    \ / _ \ '_ \| | | / __|
#  / /\/\ \  __/ | | | |_| \__ \
#  \/    \/\___|_| |_|\__,_|___/
#
# Sistema de menus.

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

main-menu:
  name: '&8Multas - Menu'
  size: 27
  pending-slot: 11
  history-slot: 13
  ranking-slot: 15
  vault-slot: 22
  pending:
    material: PAPER
    name: '&c&lMultas Pendentes'
    lore:
      - ''
      - ' &7Veja e pague suas multas pendentes.'
      - ' &7Pendentes: &f{pending}'
      - ' &7Dívida: &f{debt}'
      - ''
      - ' &eClique para abrir'
      - ''
  history:
    material: BOOK
    name: '&6&lHistórico de Infrações'
    lore:
      - ''
      - ' &7Veja suas multas pagas, removidas'
      - ' &7e ainda pendentes.'
      - ''
      - ' &eClique para abrir'
      - ''
  ranking:
    material: GOLD_INGOT
    name: '&e&lMaiores Devedores'
    lore:
      - ''
      - ' &7Ranking dos jogadores com'
      - ' &7maior dívida ativa.'
      - ''
      - ' &eClique para abrir'
      - ''
  vault:
    material: CHEST
    name: '&a&lCofre de Multas'
    lore:
      - ''
      - ' &7Total arrecadado: &f{collected}'
      - ' &7Total pendente: &f{pending_total}'
      - ''
      - ' &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: ' '}

pending-menu:
  name: '&8Multas Pendentes'
  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
  fine-item:
    material: PAPER
    name: '&cMulta #{id}'
    lore:
      - ''
      - ' &7Valor: &f{amount}'
      - ' &7Economia: &f{provider}'
      - ' &7Aplicada por: &f{issuer}'
      - ' &7Criada em: &f{created}'
      - ' &7Vence em: &f{due}'
      - ' &7Motivo: &f{reason}'
      - ''
      - ' &eClique para pagar'
      - ''

history-menu:
  name: '&8Histórico de Infrações'
  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
  fine-item:
    material: BOOK
    name: '&6Multa #{id}'
    lore:
      - ''
      - ' &7Status: &f{status}'
      - ' &7Valor atual: &f{amount}'
      - ' &7Valor pago: &f{paid}'
      - ' &7Economia: &f{provider}'
      - ' &7Motivo: &f{reason}'
      - ''

ranking-menu:
  name: '&8Maiores Devedores'
  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
  player-item:
    material: '{player}'
    name: '&e#{position} &f{player}'
    lore:
      - ''
      - ' &7Dívida pendente: &f{debt}'
      - ' &7Multas pendentes: &f{pending}'
      - ''

vault-menu:
  name: '&8Cofre de Multas'
  size: 27
  info-slot: 13
  back-slot: 9
  info:
    material: CHEST
    name: '&a&lCofre de Multas'
    lore:
      - ''
      - ' &7Total arrecadado: &f{collected}'
      - ' &7Total pendente: &f{pending_total}'
      - ' &7Multas pendentes: &f{pending_count}'
      - ' &7Multas pagas: &f{paid_count}'
      - ''
  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: ' '}

pay-confirm-menu:
  name: '&8Confirmar Pagamento'
  size: 27
  fine-slot: 13
  confirm-slot: 11
  cancel-slot: 15
  confirm:
    material: 'WOOL:5'
    name: '&aConfirmar Pagamento'
    lore:
      - ''
      - ' &7ID: &f{id}'
      - ' &7Valor: &f{amount}'
      - ' &7Economia: &f{provider}'
      - ''
      - ' &aClique para pagar'
      - ''
  cancel:
    material: 'WOOL:14'
    name: '&cCancelar'
    lore:
      - ''
      - ' &7Clique para cancelar.'
      - ''
  fine-item:
    material: PAPER
    name: '&cMulta #{id}'
    lore:
      - ''
      - ' &7Valor: &f{amount}'
      - ' &7Motivo: &f{reason}'
      - ''

Estrutura de menus

O plugin possui diferentes menus para diferentes finalidades:

arrows

Configuração dos botões de navegação usados nos 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 aberto pelo comando /multas.

main-menu:
  name: '&8Multas - Menu'
  size: 27
  pending-slot: 11
  history-slot: 13
  ranking-slot: 15
  vault-slot: 22

Itens disponíveis:

pending: abre as multas pendentes.
history: abre o histórico de infrações.
ranking: abre o ranking de maiores devedores.
vault: abre o cofre de multas.

Placeholders disponíveis neste menu: {pending}, {debt}, {collected}, {pending_total}.

Menu de multas pendentes, com itens clicáveis para pagamento.

pending-menu:
  name: '&8Multas Pendentes'
  size: 54
  previous-slot: 48
  next-slot: 50
  back-slot: 49

Placeholders disponíveis no item da multa: {id}, {amount}, {provider}, {issuer}, {created}, {due}, {reason}.

Menu que exibe o histórico de infrações do jogador.

history-menu:
  name: '&8Histórico de Infrações'
  size: 54
  previous-slot: 48
  next-slot: 50
  back-slot: 49

Placeholders disponíveis no item do histórico: {id}, {status}, {amount}, {paid}, {provider}, {reason}.

Menu que exibe os maiores devedores.

ranking-menu:
  name: '&8Maiores Devedores'
  size: 54
  previous-slot: 45
  next-slot: 53
  back-slot: 49

Placeholders disponíveis no item do ranking: {position}, {player}, {debt}, {pending}.

Menu do cofre de multas.

vault-menu:
  name: '&8Cofre de Multas'
  size: 27
  info-slot: 13
  back-slot: 9

Placeholders disponíveis no cofre: {collected}, {pending_total}, {pending_count}, {paid_count}.

Menu de confirmação de pagamento da multa.

pay-confirm-menu:
  name: '&8Confirmar Pagamento'
  size: 27
  fine-slot: 13
  confirm-slot: 11
  cancel-slot: 15

Placeholders disponíveis na confirmação: {id}, {amount}, {provider}, {reason}.

Opções de configuração de menus

name

Define o título do menu exibido no topo.

name: '&8Multas - Menu'

size

Define o tamanho do menu.

size: 27

Valores válidos normalmente são múltiplos de 9, como 9, 18, 27, 36, 45 e 54.

slots

Define os slots onde os itens serão exibidos em menus paginados.

slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34]

previous-slot, next-slot e back-slot

Define os slots dos botões de página anterior, próxima página e voltar.

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

facing

Define itens decorativos usados para preencher o menu.

facing:
  glass1: {slot: 0, material: 'STAINED_GLASS_PANE:15', name: ' '}

Os slots começam em 0 no canto superior esquerdo do inventário.

Nesta página