Ir para o conteúdo

Visão Geral dos Cosméticos


Um cosmético é uma entrada vestível no catálogo. Ele ocupa um slot virtual, renderiza uma ou mais partes 3D no jogador, e pode carregar stats, habilidades, efeitos, bônus de Lure e sons.

O catálogo fica em config/GreatCosmetics/cosmeticsconfig.conf (JSON apesar da extensão). Você raramente edita na mão — o Dev Studio grava pra você e transmite as mudanças ao vivo. Esta página explica o que cada campo significa.


Anatomia de um cosmético

Campo Significado
id (chave do mapa) Identificador único. Usado por /gc give, tags, equipar em NPC, e pra achar os arquivos de modelo.
DisplayName Nome MiniMessage mostrado nos menus e no item físico. Vazio → o id capitalizado.
slot Um de HEAD, FACE, NECK, CHEST, BACK, WAIST, LEGS, FEET, HAND. Controla em qual categoria aparece e qual limite de slot se aplica.
type Nome de tipo livre (ex: necklace). Precisa bater com uma chave no mainconfig.conf → types pra um limite de tipo valer. default = sem limite de tipo.
permission Se definido, só jogadores com esse node (ou que desbloquearam) veem e equipam o cosmético. Vazio = disponível pra todo mundo que desbloqueou.
iconId Opcional. Nome de um textures/icons/*.png diferente pra usar como ícone chapado, assim vários cosméticos podem compartilhar um arquivo de ícone. Vazio = usa o id.
cmd O número de Custom Model Data que o mod atribui ao ícone chapado. Gerenciado automaticamente — não defina na mão.
maxDurability Se > 0, o item físico mostra uma barra de durabilidade (puramente visual).
tooltipDescription Linhas opcionais em MiniMessage (separadas por \n) mostradas abaixo do Display Name no guarda-roupa. Vazio = nada a mais.
grantedPermissions / minecraftTags Separadas por vírgula no editor. Aplicadas ao jogador enquanto o cosmético está equipado e o gate permission passa; removidas ao desequipar. Ver Permissões.
unlockPermission / unlockTag Se definido, qualquer jogador com esse node ou scoreboard tag ganha o cosmético automaticamente — sem linha no banco, sem /gc give. Perdido no instante em que deixa de qualificar. Ver Permissões § Auto-Unlock.
variants Posicionamentos alternativos opcionais do mesmo model, cada um escolhível separadamente no guarda-roupa. Ver Dev Studio § Variants.
parts A lista de peças 3D — ver Partes & Modelos.

Mais os sistemas opcionais: armor / toughness, EnableFly + multiplicadores de velocidade, AutoFeed, effects (poção — também funciona em cosmético de armadura), effectVisual / flyParticle / shiftParticle, isBackpack, lure, sounds — cada um tem a sua página.

O mod em si não tem conteúdo de cosmético

O GreatCosmetics é o framework, não um pacote de models. Um cosmeticsconfig.conf novo não tem nenhum cosmético virtual de exemplo, e os poucos exemplos pequenos que o mod inclui (um cosmético de armadura — ver Cosméticos de Armadura — mais algumas models de teste chapadas/GeckoLib) podem ficar e ser usados no seu servidor numa boa, mas não são pra serem o seu conteúdo de verdade. Os cosméticos mostrados no vídeo de showcase do mod não vêm junto com o mod — você precisa trazer suas próprias models (feitas por você seguindo o padrão abaixo e Criando Modelos, compradas — ou em breve compráveis — no Discord oficial da SaSDevelopment, de qualquer outro lugar, ou reaproveitadas de armadura de outro mod). Ainda travado depois de ler a documentação? Entra no Discord e pergunta.


Como um jogador ganha um cosmético

Método Resultado
/gc give <id> [jogador] Desbloqueia no guarda-roupa.
/gc giveitem <id> [jogador] Dá o item físico; o jogador ainda equipa pelo guarda-roupa.
Segurar um item real correspondente no join Convertido automaticamente (ver Cosméticos de Armadura).
Ter o node permission Aparece automaticamente, sem precisar de /gc give.
Operador / Dev Mode Todo cosmético aparece como possuído.

Exemplo mínimo

"party_hat": {
  "DisplayName": "<light_purple>Chapéu de Festa",
  "slot": "HEAD",
  "type": "default",
  "permission": "",
  "parts": [
    { "customModelData_or_ID": "party_hat", "anchor": "HEAD" }
  ]
}

Com assets/greatcosmetics/textures/icons/party_hat.png no resource pack, /gc give party_hat <jogador> e ele aparece na categoria Cabeça do guarda-roupa.