Partes & Modelos
Um cosmético renderiza como uma ou mais partes. Cada parte é ou um ícone chapado (um modelo de item flutuante) ou um modelo 3D GeckoLib, ancorado a um ponto do corpo e transformado com offset / rotação / escala.
Criando os arquivos
Esta página é a referência dos campos. Pra um passo a passo de como criar os modelos e texturas — caminhos das pastas, Blockbench, desenhar a textura — veja Criando Modelos & Texturas.
Os dois modos de renderização
1. Ícone chapado / modelo vanilla
Defina customModelData_or_ID com um nome. O mod procura, nesta ordem:
assets/greatcosmetics/textures/icons/<nome>.png— um ícone chapado simples (o mais comum).assets/greatcosmetics/models/<nome>.json— um modelo de item vanilla personalizado.
A parte é desenhada como esse modelo de item flutuando na âncora.
2. Modelo GeckoLib
Defina geoModelId com um nome. Isso tem prioridade sobre o ícone chapado. O mod procura, em qualquer namespace:
geo/item/<nome>.geo.json— obrigatóriotextures/item/<nome>.png— obrigatório (o mod também tenta a pasta que espelha o caminho do.geo)animations/item/<nome>.animation.json— opcional (ver Animações por estado)
Modo Caminho Exato
Com useExactPath ligado, os dois campos acima deixam de ser "só o nome do arquivo" e viram um caminho relativo completo resolvido por igualdade exata em qualquer namespace:
| Modo | Valor do campo | Resolve pra |
|---|---|---|
| Off | wizard_hat |
.../models/wizard_hat.json (namespace greatcosmetics pra modelos vanilla) |
| On | hats/wizard_hat |
.../models/hats/wizard_hat.json em qualquer namespace |
| On (Geo) | item/wizard_hat |
.../geo/item/wizard_hat.geo.json em qualquer namespace |
Use quando seus arquivos estão em subpastas ou no namespace de outro mod, ou quando dois arquivos têm o mesmo nome.
Âncoras
Onde a parte se prende:
HEAD, BODY, RIGHT_ARM, LEFT_ARM, RIGHT_LEG, LEFT_LEG
A âncora segue a animação da parte do corpo (a cabeça vira, os braços balançam), aí o offset/rotação/escala da parte são aplicados por cima.
Transforms
| Grupo | Campos | Usado |
|---|---|---|
| Escala | scaleX/Y/Z (padrão 1.0) |
Sempre |
| Valores normais | offsetX/Y/Z, rotationX/Y/Z |
Em pé |
| Valores de Sneak | shiftOffsetX/Y/Z, shiftRotationX/Y/Z |
Enquanto o jogador está agachado |
Os valores de Sneak existem porque a pose de agachar do vanilla dobra o corpo — um chapéu que fica certo em pé pode clipar agachado, então você ajusta uma posição separada pra ele.
O gizmo 3D
No Dev Studio, selecione uma parte (clique nela no outliner ou abra >> Config Part). Aí, em qualquer lugar fora do painel:
- Segure
X,YouZ— trava o eixo. - Arraste o mouse — a parte move, gira ou escala ao vivo (escolha o modo com os botões Mover / Girar / Escala no popup).
Os campos de texto atualizam enquanto você arrasta, e vice-versa. Alterne o botão S da barra lateral pra editar a pose de Sneak do mesmo jeito.
Sempre que uma parte (ou um efeito) está selecionada, também aparecem três botões coloridos no centro-direita da tela: X (vermelho), Y (verde), Z (azul) — seguindo a mesma convenção de cores dos eixos do gizmo. Clicar em um deles zera na hora o Offset daquele eixo — ou, enquanto você tá pré-visualizando a pose de Sneak com o toggle S da barra lateral, zera o Sneak/Shift Offset daquele eixo. Um jeito rápido de encaixar uma parte de volta bem no centro da âncora dela sem arrastar o gizmo na mão ou digitar 0 num campo.
Várias partes
Adicione partes com + Add Part. Um único cosmético pode combinar, por exemplo, um chapéu GeckoLib no HEAD mais um ícone chapado de pena deslocado pro lado — cada um com o seu próprio transform. Não há limite rígido; mantenha razoável pra performance.
Animações por estado
(Só partes GeckoLib — ícone chapado nunca anima.)
Um modelo GeckoLib toca uma animação do .animation.json dele conforme o que quem veste está fazendo — parado, andando, voando, etc. Não tem código de controlador pra escrever nem nada pra configurar: o mod escolhe o clip só pelo nome. Dê a um clip um dos nomes fixos abaixo e ele toca naquele estado; um modelo cujo .animation.json não tem nenhum desses nomes fica 100% estático (o comportamento antigo).
Os nomes fixos
| Nome | Toca quando | Cai pra |
|---|---|---|
idle |
Parado (estado padrão / de descanso) | — |
walk |
Andando no chão | idle |
run |
Correndo (sprint) no chão | walk → idle |
fly |
Voando (creative / voo cosmético) ou planando com elytra | idle |
swim |
Na água e fora do chão | walk → idle |
fall |
No ar, sem voar (pulo / queda) | idle |
sneak |
Agachado | (nada — ver abaixo) |
Prioridade (ganha o primeiro cujo clip existir de verdade): sneak → fly → swim → fall → run → walk → idle.
O sneak é especial: se o model não tem um clip de sneak, agachar é transparente — a animação não muda (quem tá andando continua no walk, quem tá parado continua no idle). Todos os outros nomes caem pela cadeia até o idle.
Você só precisa dos clips que interessam. Uma capa só com idle e fly funciona — andar, agachar, etc. tudo desce até o idle (ou, no caso do sneak, simplesmente não muda nada).
Nomeando no Blockbench
Você não precisa renomear pra palavra pura. O mod casa um clip cujo nome termina com o nome fixo depois de um separador — então tudo isso conta como idle:
idleanimation.asa_dragao.idle— o padrão do Blockbenchanimation.<modelo>.<ação>ground_idle/animation.charizard.ground_idle— a convenção do Cobblemon (animações rippadas de Pokémon)battle_idle,air_idle, … — qualquer coisa terminando em_idle/-idle
Mesma coisa pros outros: ground_walk → walk, ground_run → run, air_fly → fly. Quando vários clips poderiam casar, o mais específico ganha (.idle > ground_idle > battle_idle). Clips com ride ou test no nome são ignorados.
Quer uma animação sempre ligada?
Um modelo que deve sempre fazer a mesma coisa (um halo girando devagar, uma chama tremendo) — é só nomear esse clip de idle. Ele fica em loop em todos os estados porque tudo cai pro idle.
Notas
- Todo clip fica em loop. Animação de uma vez só (one-shot) não é suportada aqui.
- Cada um que veste anima independente — dois jogadores com o mesmo cosmético não sincronizam.
- O blend entre estados é suavizado em ~5 ticks.
- No Dev Studio o jogador do preview só fica parado, então você só vai ver o
idle(ou nada). Teste as animações de movimento no mundo.
Checklist pra um modelo novo
- Coloque os arquivos no seu resource pack (ícone ou
.geo+ textura). /gc reload(ou reinicie o cliente) pra ele escanear o pack.- Dev Studio → + Cosmetic → defina Slot, Type, Display Name.
- Em 3D Models, digite o nome do arquivo em Model/ID (chapado) ou GeckoLib Model ID (3D). Ligue Exact Path se o arquivo estiver numa subpasta/namespace.
>> Config Part→ posicione com o gizmo.Spra salvar. Já está no ar pra todo mundo.