Permissões
O GreatCosmetics usa a API de permissões do Fabric (fornecida pelo LuckPerms). Um jogador passa numa checagem se for operador de verdade (ops.json) ou tiver o node. Sem um mod de permissões, só operadores passam e todas as Tags de grupo viram só prévia.
Nodes de Comando
| Node | Comando |
|---|---|
gc.command.wardrobe.self |
/wardrobe |
gc.command.wardrobe.other |
/wardrobe <jogador> |
gc.command.wardrobe.setbackground |
/gc wardrobe setbackground |
gc.command.give |
/gc give |
gc.command.giveitem |
/gc giveitem |
gc.command.remove |
/gc remove |
gc.command.cosmetics.equip / .unequip |
/gc cosmetics equip / unequip |
gc.command.giveskin / gc.command.removeskin |
/gc giveskin / removeskin |
gc.command.tags.give / gc.command.tags.remove |
/gc tags give / remove |
gc.command.npc.equip / gc.command.npc.remove |
/gc npc equip / remove |
gc.command.display |
/gc display / remove / clear |
gc.command.uuid |
/gc uuid |
gc.command.extraslot |
/gc extraslot |
gc.command.extratypeslot |
/gc extratypeslot |
gc.command.reload / gc.command.debug / gc.command.inspect |
/gc reload / debug / inspect |
gc.command.activation |
/gc activation |
Acesso ao Dev Studio
| Node | Concede |
|---|---|
gc.dev |
Dev Studio completo: criar/editar/apagar cosméticos, efeitos, tipos, slots e config do servidor. Também deixa o jogador ligar o Dev Mode no guarda-roupa (previsualizar todo cosmético/tag sem possuir). |
gc.perm.devmode |
Só o bypass de Dev Mode — equipar qualquer cosmético pra teste sem possuir. O nome do node é configurável via devModePermission no mainconfig.conf. |
Warning
A aba Dev Studio exige, além disso, que o jogador seja operador de verdade. Só o gc.dev revela os controles de admin dentro das abas Tags / Party, mas não o painel completo do Dev Studio.
Possuindo Cosméticos
- Um cosmético com o campo
permissionpreenchido só aparece/equipa pra quem tem esse node exato (ou quem desbloqueou via/gc give, ou quem tem Dev Mode). - Fora isso, os jogadores desbloqueiam cosméticos por
/gc give, pelo item físico (/gc giveitem), ou pela conversão automática de armadura.
Auto-Unlock
Um cosmético também pode ter uma Unlock Permission e/ou uma Unlock Tag (Dev Studio → editor de cosmético → seção Auto-Unlock). Quem tiver esse node de permissão ou essa scoreboard tag vanilla ganha o cosmético automaticamente — sem /gc give, sem linha no banco. É dinâmico: no instante em que o jogador deixa de ter um dos dois (grupo do LuckPerms mudou, /tag remove…), ele perde o acesso, e o cosmético é desequipado à força se estava vestido.
Isso é diferente do gate permission acima: permission só decide visibilidade/equipabilidade de um cosmético que o jogador ainda precisa possuir separadamente; Unlock Permission / Unlock Tag concedem a posse em si, ao vivo.
Permissões e Tags concedidas POR um cosmético
Independente do gate permission, um cosmético (inclusive um cosmético de armadura) pode ter seus próprios campos Granted Permissions e Minecraft Tags (separados por vírgula no editor do Dev Studio):
- Todo node em Granted Permissions é adicionado ao jogador como uma permissão transient do LuckPerms (nunca gravada na storage do LuckPerms) enquanto o cosmético está equipado e o gate
permissiondele passa. - Toda tag em Minecraft Tags é aplicada como uma scoreboard tag estilo
/tagvanilla, na mesma condição — útil pra datapacks ou/execute if entity @s[tag=...].
Os dois são removidos no instante em que o cosmético é desequipado, e reaplicados automaticamente ao relogar se ele ainda estiver vestido. Bônus de vários cosméticos equipados se somam (a união de tudo que é concedido).
Limites de Slot
Cada slot virtual tem um limite base (defaultLimit no mainconfig.conf). Os jogadores aumentam com nodes em tiers a partir da base permission do slot (padrão gc.slot.<slot>):
| Padrão de node | Efeito |
|---|---|
gc.slot.<slot>.<N> |
Define o limite absoluto do slot como N (vale o tier mais alto de 1 a 20 que o jogador tiver). |
gc.slot.<slot>.bypass |
Ilimitado (99) nesse slot. |
gc.extraslot.<slot>.<N> |
Soma N itens extras em cima do limite normal. |
gc.extraslot.all.<N> |
Soma N itens extras a todo slot. |
<slot> é minúsculo: head, face, neck, chest, back, waist, legs, feet, hand.
Limites de Tipo
Os tipos de acessório (ex: necklace, scarf) também têm limitPerPlayer e uma base permission (padrão gc.type.<type>):
| Padrão de node | Efeito |
|---|---|
gc.type.<type>.<N> |
Aumenta o limite por jogador desse tipo pra N. |
gc.type.<type>.bypass |
Ilimitado (99) pra esse tipo. |
gc.extratypeslot.<type>.<N> |
Soma N itens extras em cima do limite normal desse tipo. |
gc.extratypeslot.all.<N> |
Soma N itens extras a todo tipo. |
Nodes de Tag
- Cada Tag lista o seu próprio array
permissions— um jogador "possui" uma Tag personalizada se tiver qualquer node dessa lista (ou recebeu via/gc tags give). - Tags de Grupo são possuídas automaticamente por estar no grupo do LuckPerms correspondente.
Ver Tags.