Referência de Tags e Chaves para Menus

Autor: Allaya.studios | Versão: 1.2

📁 Lista de Tags e Chaves do Menu .yml

Esta página serve como referência para os administradores que desejam configurar menus de lojas com o plugin AllayaLojas. Aqui estão listadas todas as chaves reconhecidas pelo sistema, com seus tipos e funções.

---

Nível de menu

Tag	Tipo	Função
nome	String	Título do menu, suporta cores e placeholders
linhas	Int	Número de linhas do inventário (1 a 6)
requer-permissao	Boolean	Se true, exige permissão para abrir via comando
som_ao_abrir	String	Nome do som a tocar ao abrir o menu
som_ao_comprar	String	Som ao realizar compra
som_ao_vender	String	Som ao realizar venda
bloco	Função	Dentro desse bloco de código, estará todas as funções relacionadas aos blocos.
abrir-com-item	Função	Configura item que permite abrir o menu.
filler	Função	Item que preencherá os espaços vazio do menu. Confira itens para entender como configurar!
itens	Função	Lista dos itens do menu.

Dentro de blocos:

Tag	Tipo	Função
coords	List	Coordenadas de blocos que abrem o menu. (É adicionado automaticamente pelo comando /lojas vincularbloco
bloco-requer-permissao	Boolean	Se true, exige permissão para abrir via bloco
holograma	Lista de String	*Requer DecentHolograms para funcionar.* Uma lista das linhas do textos que vão estar em hologramas.

---

Dentro de abrir-com-item

Funciona da mesma forma que o bloco itens: . Segue agora, tag exclusivas de abrir-com-item:

Tag	Tipo	Função
permission	Permissão	Permissão para usar o item.

---

Dentro de itens:

Cada item no menu usa um ID como chave. As tags abaixo são suportadas dentro de cada item:

Tag	Tipo	Função
slot	Int	Posição do item no inventário (0 a 53)
material	String	Nome do material ou ID salvo com /lojas adicionaritem <id>
nome	String	Nome do item, suporta PlaceholderAPI
lore	List	Descrição do item (linhas de lore), suporta PlaceholderAPI
preco_compra	Double	Valor para comprar o item
preco_venda	Double	Valor para vender o item
quantidade	Int	Quantidade de itens comprados/vendidos
tipo	String	"normal" (padrão) ou "abrir_gui" para abrir outro menu
destino	String	ID de outro menu a ser aberto se tipo for abrir_gui
match-type	Boolean	Se true, compara com item salvo exatamente (NBT, etc.)
permission-to-buy	Permissão	Permissão que será adquirida na compra.
permission-price	Double	Valor de compra da permissão.
run-command-buy	String List	Uma lista de comandos para roda quando um item for comprado com sucesso!

---

🔹 Condições (variavelXX)

No sistema de menus do plugin AllayaLojas, usamos múltiplas condições como compare01, compare02, valor01, valor02, etc., para permitir que um mesmo item tenha diferentes comportamentos ou aparências dependendo da situação do jogador.

Cada compareXX define o que será verificado (ex: nome do jogador, permissão, saldo), e o correspondente valorXX define o valor esperado.

Exemplo prático:

compare01: "%player_name%"  
valor01: "Steve"  
compare02: "player.hasperm"  
valor02: "vip.acesso"

Tag interna	Tipo	Função
compare01	String	Placeholder ou palavra-chave (player.hasperm) a ser avaliada
valor01	String	Valor esperado para que a condição seja verdadeira

Nesse caso, o item pode aparecer se o jogador se chama Steve e tem a permissão vip.acesso. O plugin testa essas condições em ordem, e se todas for verdadeira, a configuração será aplicada. Isso permite menus dinâmicos e personalizados para diferentes grupos de jogadores.

Tag internas no compare01

Tag interna	Função
player.hasperm	Verifica se o jogador tem a permissao.
MAIORQUE:0	Verifica se o valor é maior que zero. (Zero pode ser substituído por qualquer outro valor.)
MENORQUE:0	Verifica se o valor é menor que zero. (Zero pode ser substituído por qualquer outro valor.)