SkinTokens (rig automático local)
gamedev pkg add aigd.model3d-skintokensVisão geral
Rig automático local: o SkinTokens da VAST-AI adiciona esqueleto e pesos de skin a uma malha de personagem ou criatura (GLB, OBJ ou FBX) e grava um GLB com rig que mantém os materiais e UVs originais. Roda no Asset Studio na sua GPU NVIDIA com 14 GB de VRAM. MIT, uso comercial permitido.
O SkinTokens faz o rig de um modelo 3D na sua GPU NVIDIA (14 GB de VRAM ou mais) com SkinTokens da VAST-AI. Ele prevê um esqueleto e pesos de skin para uma malha de personagem ou criatura e os grava no seu arquivo original, de modo que seus materiais e UVs são mantidos. O resultado é um GLB com rig. No AI Game Dev ele roda localmente pelo Local Python models runtime (aigd.python). Serve para desenvolvedores que precisam de um primeiro rig para um personagem gerado ou feito à mão antes de animá-lo.
O que você pode criar
- Personagens e criaturas com rig a partir de uma malha GLB, OBJ ou FBX, prontos para animar na sua engine ou ferramenta DCC.
- Esqueletos e pesos de skin de primeira passada para malhas feitas pelos modelos locais de imagem para 3D.
- Vários candidatos de rig para uma mesma malha: cada execução amostra um novo esqueleto.
Como usar
O rig roda no Asset Studio, e não pelo agente do chat:
- Abra o Asset Studio e escolha 3D → SkinTokens → Rig.
- Adicione a malha a rigar: um arquivo GLB, OBJ ou FBX, como
Assets/Models/goblin.glb. - Confira o GLB com rig. Se o esqueleto não servir para o modelo, rode de novo: cada execução amostra um novo esqueleto.
Destaques
| Id do modelo | aigd.model3d-skintokens.v1 |
| Operação | fazer o rig de um modelo 3D (uma malha de entrada: GLB, OBJ ou FBX) |
| Saída | GLB com rig, com esqueleto e pesos de skin; materiais e UVs originais mantidos |
| Roda em | GPU NVIDIA (CUDA) com 14 GB de VRAM ou mais |
| Download | cerca de 1,6 GB, mais o ambiente Python do runtime (com o Blender como módulo Python) no primeiro carregamento |
| Licença | MIT, uso comercial do modelo e dos rigs gerados permitido |
As malhas para rigar podem vir do TripoSG, do Hunyuan3D-2.1 Shape, do Step1X-3D Geometry, do TRELLIS.2 ou das suas próprias ferramentas.
Como ele roda
Este pacote é apenas dados. Ele precisa do Local Python models runtime (aigd.python). O primeiro carregamento monta um ambiente Python 3.11 privado com PyTorch e Blender como módulo Python (bpy 4.5 LTS, cerca de 330 MB). O Blender lê e grava as malhas. O FlashAttention não é instalado: a atenção roda nos kernels nativos do PyTorch. O Open3D também não é instalado: a grade de voxels para a suavização dos pesos de skin é construída em NumPy com a mesma matemática da do Open3D. Os checkpoints são carregados apenas como tensores, nunca como código. Os modelos rodam offline; seus pesos vêm apenas dos arquivos abaixo, baixados do Hugging Face depois da sua confirmação. O AI Game Dev não os hospeda.
O que é baixado
Cerca de 1,6 GB, fixados por revisão e sha256 do Hugging Face:
| Arquivo | Tamanho | Licença | Origem |
|---|---|---|---|
skin_vae_2_10_32768-last.ckpt | 0.49 GB | MIT | arquivo |
articulation_xl_quantization_256_token_4-grpo_1400.ckpt | 1.13 GB | MIT | arquivo |
Qwen3-0.6B-config.json | 0.00 GB | Apache-2.0 | arquivo |
O código Python do modelo (src/, configs/skeleton/) é baixado do GitHub no commit 273b691, com cada arquivo verificado por sha256.
Licença
- Pesos e código: MIT, © 2025 VAST-AI-Research (licença, card do modelo).
- Arquivo de configuração do Qwen3-0.6B: Apache-2.0, © Alibaba Cloud (card do modelo). Só o
config.jsondele é baixado; os pesos do modelo de linguagem fazem parte do SkinTokens. - Blender como módulo Python (
bpy4.5.16): GPL-3.0-or-later, © Blender Foundation (PyPI). O runtime o instala do PyPI no ambiente privado do modelo, onde o handler de rig do app o importa para ler e gravar malhas. O AI Game Dev não distribui o bpy. - O handler de rig (
skintokens/handler.pyno runtime Python do app): GPL-3.0-or-later, porque importa o bpy. Ele roda como um programa separado, no processo worker Python do próprio modelo, que o app inicia e com o qual se comunica apenas por mensagens JSON via stdio. Seu código-fonte acompanha o app; vejaTHIRD_PARTY_NOTICES.md.
Atribuição exigida: "SkinTokens © 2025 VAST-AI-Research (MIT)".
Restrições: o uso comercial do modelo e dos rigs que ele gera é permitido. Redistribuir os pesos exige o aviso de copyright do MIT.
Versões
| Versão | Lançamento | Requer o app |
|---|---|---|
| 1.0.4Mais recente | 0.32.0-beta.6 ou mais recente | |
| 1.0.3 | 0.32.0-beta.6 ou mais recente |
Instalar
No app para desktop
Abra a janela Pacotes (o ícone de pacote na barra de status), selecione Explorar, pesquise aigd.model3d-skintokens e clique em Adicionar ao projeto.
Ainda sem o app? Baixe o AI Game Dev grátis para Windows, macOS ou Linux.
Pelo terminal
Com a CLI gamedev, na pasta do seu projeto:
gamedev pkg add aigd.model3d-skintokensRequisitos
- AI Game Dev 0.32.0-beta.6 ou mais recente
- Uma GPU NVIDIA com 14 GB ou mais
gamedev pkg add aigd.model3d-skintokens