Pular para o conteúdo principal

Cookbook

Quatro padrões para adaptar. Cada um lista os layouts envolvidos e os campos a definir na entry Open GUI.

1. Lista com rolagem e setas​

Layouts: composite, scrollable, dois simple.

  1. Crie um layout simple list_content contendo as linhas da lista. Ele pode ser mais alto que a janela: coloque itens de y 0 a 14.
  2. Crie um layout scrollable list_scroll com innerId list_content, virtualWidth 9 e virtualHeight 15.
  3. Em seus buttons, adicione um botão direction UP em x 8, y 0 e um botão DOWN em x 8, y 5, cada um com step 1 e um item de seta.
  4. Crie um layout simple border com um painel de vidro em x 8, y 1, count 4, direction down, displayName com um único espaço.
  5. Crie um layout composite main com children list_scroll e depois border, e defina mainLayoutId como main.

Os botões ficam ancorados à janela e desaparecem quando não há mais nada para rolar na direção deles.

2. Lista paginada​

Layouts: composite, simple, paginated.

  1. Crie um layout paginated shop com itemsPerPage 21 e slots 10 a 16, 19 a 25 e 28 a 34.
  2. Adicione um item por produto em items, com uma interação LEFT_CLICK que execute seu comando ou trigger.
  3. Em navigationButtons, adicione um botão PREVIOUS em x 0, y 5, um botão NEXT em x 8, y 5 e um INDICATOR em x 4, y 5 com o nome <gray>{page_indicator}.
  4. Coloque um layout simple com a borda em um composite abaixo dele.

Para uma loja de verdade, com preços e estoque, use Shops, que preenche um layout paginado para você.

3. Menu de confirmação​

Mostra closeMenu, executeReturn e o histórico da sessão.

  1. Abra a confirmação a partir do botão perigoso: adicione um comando gui:open <confirm menu entry id> à interação dele, ou ligue a entry Open GUI em triggers.
  2. Crie um Open GUI com guiType CUSTOM, size SIZE_27 e um layout simple.
  3. Adicione uma lã verde em x 2, y 1 com uma interação LEFT_CLICK que execute o comando e com closeMenu ativado.
  4. Adicione uma lã vermelha em x 6, y 1 com uma interação LEFT_CLICK e executeReturn ativado. Ela volta ao menu que abriu este.

4. Depósito de cota​

Mostra slots de armazenamento, um item exigido e um trigger.

  1. Crie um artifact GUI Storage.
  2. No storagePool do Open GUI, adicione uma configuração com um id como iron_bank, o artifact em entry, requiredItem um lingote de ferro, requiredAmount 32 e a entry de desbloqueio em onReachRequired. Defina placeholder como um painel de vidro cinza.
  3. Em um layout simple, adicione um item em x 4, y 1 com storageId iron_bank. O nome e a lore dele podem usar {stored_name}, {stored_amount} e {stored_max}.

Deixe group vazio para um armazenamento por jogador, ou escolha uma entry de grupo (uma ilha, uma guilda) para compartilhar o armazenamento.

Dicas​

  • A ordem das camadas em um composite é a ordem de desenho: fundo primeiro, botões por último.
  • Dê um id único a cada layout scrollable e paginated.
  • Use criteria nos itens para mostrar ou ocultar botões por jogador.
  • Defina o displayName dos painéis decorativos como um único espaço para ocultar o nome vanilla do item.