Pular para o conteúdo principal

Entenda um menu GUI

Uma entry Open GUI reúne tudo o que um menu precisa: o tipo de janela, o título, um pool de layouts e as opções da sessão. Esta página explica o vocabulário e a ordem em que construir um menu.

Vocabulário​

TermoSignificado
layoutPoolOs layouts nomeados do menu.
mainLayoutIdO id do layout desenhado primeiro (a raiz).
LayoutUma regra que posiciona slots: grade, linhas, páginas, área de rolagem, frames ou camadas.
ItemA descrição de um slot: item, nome, lore, posição, permissões e ações de clique.
InteractionO que acontece para um tipo de clique: comandos, triggers, fechar ou voltar.
SessãoO estado de um menu aberto para um jogador: histórico, página atual, posição de rolagem e view ativa.
ViewportA parte de um layout rolável que está visível no momento.

Ordem de construção​

  1. Crie a entry Open GUI e depois escolha guiType, size e title.
  2. Adicione um layout simple com um id e escreva esse id em mainLayoutId.
  3. Adicione primeiro os itens decorativos (bordas, fundos) e depois os botões.
  4. Adicione entradas de interactionList aos botões.
  5. Só então adicione frame, scrollable, paginated ou views.

Repetição de slots​

count, direction, gap e repeatY repetem um item. Um único item com count 9 e direction right preenche uma linha. Esses campos posicionam slots; eles nunca alteram o tamanho da pilha do item. gap é um passo: 1 posiciona slots adjacentes e 2 deixa um slot vazio entre as cópias. Sem um direction, os três campos são ignorados e um único slot é posicionado.

Os slots que cairiam fora da grade são descartados e listados no console com o id do layout e as coordenadas.

Visibilidade e cliques​

  • criteria oculta o slot para os jogadores que não correspondem.
  • viewPermission oculta o slot para os jogadores sem a permissão.
  • clickPermission desenha o slot, mas o torna inerte.
  • allowPickup permite que o jogador retire o item do menu; vem desativado por padrão.

Todos são opcionais, e uma permissão em branco não restringe nada.

Abrir, voltar e fechar​

  • Qualquer entry capaz de disparar uma action pode disparar o Open GUI.
  • executeReturn em uma interaction volta ao menu anterior da sessão.
  • closeMenu em uma interaction fecha a janela.
  • Fechar com Esc encerra a sessão.

Próximos passos​