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:
# 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 de pré-visualização
preview:
name: '&8Caixa'
size: 54
slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 43 ]
previous-slot: 9
next-slot: 17
lore:
- ''
- '&fChance: &b{chance}%'
- '&fRaridade: &7{rarity}&f.'
- ''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 de preview (preview)
Menu exibido quando os jogadores usam Shift + Botão Direito na caixa ou executam /mbox ver <caixa>.
Estrutura básica
preview:
name: '&8Caixa'
size: 54
slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 43 ]
previous-slot: 9
next-slot: 17
lore:
- ''
- '&fChance: &b{chance}%'
- '&fRaridade: &7{rarity}&f.'
- ''Placeholders disponíveis na lore: {chance}, {rarity}
Menu de confirmação (confirm)
Menu de confirmação exibido antes de abrir uma caixa.
confirm:
name: '&8Caixa'
size: 36
items:
box-slot: 13
confirm-slot: 20
cancel-slot: 24
confirm:
material: 'WOOL:5'
name: '&aConfirmar (Leia abaixo)'
lore:
- '&7Você receberá as recompensas desta caixa.'
- ''
- '&7Clique para confirmar a abertura da caixa.'
cancel:
material: 'WOOL:14'
name: '&cCancelar'
lore: [ '&7Clique para cancelar a abertura da caixa.' ]Itens do menu
confirm
Botão para confirmar a abertura da caixa.
Exemplo:
items:
confirm:
material: 'WOOL:5'
name: '&aConfirmar (Leia abaixo)'
lore:
- '&7Você receberá as recompensas desta caixa.'
- ''
- '&7Clique para confirmar a abertura da caixa.'cancel
Botão para cancelar a abertura da caixa.
Exemplo:
items:
cancel:
material: 'WOOL:14'
name: '&cCancelar'
lore: [ '&7Clique para cancelar a abertura da caixa.' ]Menu principal de edição (settings)
Menu principal de edição de caixas para administradores.
settings:
name: '&8Caixa'
size: 27
items:
box-slot: 13
items-slot: 11
commands-slot: 15
items:
material: 'CHEST'
name: '&aEditar Itens'
lore:
- '&7Clique para editar as recompensas'
- '&7em forma de itens desta caixa.'
- ''
- '&aClique para abrir'
commands:
material: 'PAPER'
name: '&aEditar Comandos'
lore:
- '&7Clique para editar as recompensas'
- '&7em forma de comandos desta caixa.'
- ''
- '&aClique para abrir'Itens do menu
items
Botão para editar recompensas em forma de itens.
Exemplo:
items:
items:
material: 'CHEST'
name: '&aEditar Itens'
lore:
- '&7Clique para editar as recompensas'
- '&7em forma de itens desta caixa.'
- ''
- '&aClique para abrir'commands
Botão para editar recompensas em forma de comandos.
Exemplo:
items:
commands:
material: 'PAPER'
name: '&aEditar Comandos'
lore:
- '&7Clique para editar as recompensas'
- '&7em forma de comandos desta caixa.'
- ''
- '&aClique para abrir'Menu de edição de itens (settings-items)
Menu para editar as recompensas em forma de itens.
settings-items:
name: '&8Caixa'
size: 54
slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 43 ]
previous-slot: 18
next-slot: 26
back-slot: 48
items:
add-slot: 50
lore:
- ''
- '&fChance: &b{chance}%'
- '&fRaridade: &7{rarity}&f.'
- ''
- '&aBotão &fESQUERDO&a para editar.'
- '&aBotão &fDIREITO&a para deletar.'
add:
material: '924757bc9a3171f9d0fdfbd209ac42e15f7744eb5f2db31920ff8af8d94567c6'
name: '&aAdicionar Item'
lore: [ '&7Clique para adicionar mais', '&7um item como recompensa.' ]Placeholders disponíveis na lore: {chance}, {rarity}
Menu de edição de comandos (settings-commands)
Menu para editar as recompensas em forma de comandos.
settings-commands:
name: '&8Caixa'
size: 54
slots: [ 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34, 37, 38, 39, 40, 41, 42, 43 ]
previous-slot: 18
next-slot: 26
back-slot: 48
items:
add-slot: 50
lore:
- ''
- '&fChance: &b{chance}%'
- '&fRaridade: &7{rarity}&f.'
- ''
- '&aBotão &fESQUERDO&a para editar.'
- '&aBotão &fDIREITO&a para deletar.'
add:
material: '924757bc9a3171f9d0fdfbd209ac42e15f7744eb5f2db31920ff8af8d94567c6'
name: '&aAdicionar Comando'
lore: [ '&7Clique para adicionar mais', '&7um comando como recompensa.' ]Menu de adicionar item (add-item)
Menu para adicionar um novo item como recompensa.
add-item:
name: '&8Caixa'
size: 27
items:
input-slot: 13
cancel-slot: 18
confirm-slot: 26
cancel:
material: ARROW
name: '&cCANCELAR'
lore:
- '&7Clique para cancelar e voltar'
- '&7ao menu de gerenciamento.'
confirm:
material: ARROW
name: '&aCONFIRMAR'
lore:
- '&7Clique para confirmar e adicionar'
- '&7este item como recompensa.'
facing:
e1:
slot: 3
material: 'STAINED_GLASS_PANE:15'O jogador coloca o item no slot 13 e clica em confirmar para adicionar.
Menu de editar item (edit-item)
Menu para editar um item existente (chance e raridade).
edit-item:
name: '&8Caixa'
size: 27
back-slot: 9
items:
item-slot: 13
chance-slot: 11
rarity-slot: 15
chance:
material: GOLD_INGOT
name: '&aChance'
lore:
- '&7Altere a chance para ganhar esse'
- '&7item na caixa.'
- ''
- '&fChance atual: &a{chance}%'
- ''
- '&aClique para alterar.'
rarity:
material: PAPER
name: '&aRaridade'
lore:
- '&7Altere a raridade desse'
- '&7item da caixa.'
- ''
- '&fRaridade atual: &a{rarity}'
- ''
- '&aClique para alterar.'Placeholders disponíveis: {chance}, {rarity}
Menu de editar comando (edit-command)
Menu para editar um comando existente (chance, raridade e comando).
edit-command:
name: '&8Caixa'
size: 27
back-slot: 9
items:
item-slot: 14
chance-slot: 11
rarity-slot: 12
command-slot: 16
chance:
material: GOLD_INGOT
name: '&aChance'
lore:
- '&7Altere a chance para ganhar esse'
- '&7comando na caixa.'
- ''
- '&fChance atual: &a{chance}%'
- ''
- '&aClique para alterar.'
rarity:
material: NETHER_STAR
name: '&aRaridade'
lore:
- '&7Altere a raridade desse'
- '&7comando da caixa.'
- ''
- '&fRaridade atual: &a{rarity}'
- ''
- '&aClique para alterar.'
command:
material: PAPER
name: '&aComando'
lore:
- '&7Altere o comando dessa recompensa'
- ''
- '&fComando atual: &a{command}'
- ''
- '&aClique para alterar.'Placeholders disponíveis: {chance}, {rarity}, {command}
Menu de seleção de raridade (rarities)
Menu para selecionar a raridade de uma recompensa.
rarities:
name: '&8Caixa'
size: 27
previous: 9
next: 17
back: 18
slots: [ 10, 11, 12, 13, 14, 15, 16 ]Os ícones das raridades são definidos no arquivo rarities.yml
Opções de configuração de menus
name
Define o título do menu exibido no topo.
Exemplo:
name: '&8Caixa'size
Define o tamanho do menu (deve ser múltiplo de 9, máximo 54).
Exemplo:
size: 54Valores válidos: 9, 18, 27, 36, 45, 54
slots
Define os slots onde os itens principais serão exibidos.
Exemplo:
slots: [ 10, 11, 12, 13, 14, 15, 16 ]back-slot
Define o slot onde o botão de voltar será exibido.
Exemplo:
back-slot: 48previous-slot
Define o slot onde o botão de página anterior será exibido.
Exemplo:
previous-slot: 18next-slot
Define o slot onde o botão de próxima página será exibido.
Exemplo:
next-slot: 26facing
Define itens decorativos para preencher o menu (geralmente vidros coloridos).
Exemplo:
facing:
e1:
slot: 3
material: 'STAINED_GLASS_PANE:15'
e2:
slot: 4
material: 'STAINED_GLASS_PANE:15'Personalizando os menus
Escolha o menu
Identifique qual menu você deseja personalizar.
Ajuste o tamanho
Altere o valor de size se necessário (deve ser múltiplo de 9).
Configure os slots
Defina onde os itens aparecerão usando slots.
Adicione decoração
Use facing para adicionar itens decorativos nos slots vazios.
Teste no servidor
Recarregue o plugin com /mbox reload e verifique o resultado.
Os slots começam em 0 (canto superior esquerdo) e vão até 53 (canto inferior direito em um menu de tamanho 54).