SkinTokens (lokales Auto-Rigging)
gamedev pkg add aigd.model3d-skintokensÜbersicht
Lokales Auto-Rigging: SkinTokens von VAST-AI fügt einem Charakter- oder Kreatur-Mesh (GLB, OBJ oder FBX) ein Skelett und Skin-Gewichte hinzu und schreibt eine geriggte GLB, die die ursprünglichen Materialien und UVs behält. Läuft in Asset Studio auf deiner NVIDIA GPU mit 14 GB VRAM. MIT, kommerzielle Nutzung erlaubt.
SkinTokens riggt ein 3D-Modell auf deiner NVIDIA GPU (14 GB VRAM oder mehr) mit SkinTokens von VAST-AI. Es sagt ein Skelett und Skin-Gewichte für ein Charakter- oder Kreatur-Mesh voraus und schreibt sie in deine Originaldatei, sodass Materialien und UVs erhalten bleiben. Das Ergebnis ist eine geriggte GLB. In AI Game Dev läuft es lokal über die Local Python models runtime (aigd.python). Es eignet sich für Entwickler, die ein erstes Rig für einen generierten oder handgebauten Charakter brauchen, bevor sie ihn animieren.
Was du erstellen kannst
- Geriggte Charaktere und Kreaturen aus einem GLB-, OBJ- oder FBX-Mesh, bereit zur Animation in deiner Engine oder deinem DCC-Tool.
- Erste Skelette und Skin-Gewichte für Meshes, die von den lokalen Image-to-3D-Modellen erzeugt wurden.
- Mehrere Rig-Kandidaten für ein Mesh: bei jedem Lauf wird ein neues Skelett gesampelt.
So verwendest du es
Das Rigging läuft über Asset Studio, nicht über den Chat-Agenten:
- Öffne Asset Studio und wähle 3D → SkinTokens → Rig.
- Füge das zu riggende Mesh hinzu: eine GLB-, OBJ- oder FBX-Datei, zum Beispiel
Assets/Models/goblin.glb. - Prüfe die geriggte GLB. Wenn das Skelett nicht zum Modell passt, starte erneut: bei jedem Lauf wird ein neues Skelett gesampelt.
Highlights
| Modell-ID | aigd.model3d-skintokens.v1 |
| Operation | ein 3D-Modell riggen (ein Eingabe-Mesh: GLB, OBJ oder FBX) |
| Ausgabe | geriggte GLB mit Skelett und Skin-Gewichten; ursprüngliche Materialien und UVs bleiben erhalten |
| Läuft auf | NVIDIA GPU (CUDA) mit 14 GB VRAM oder mehr |
| Download | etwa 1,6 GB, plus die Python-Umgebung der Runtime (mit Blender als Python-Modul) beim ersten Laden |
| Lizenz | MIT, kommerzielle Nutzung des Modells und seiner Rigs erlaubt |
Meshes zum Riggen können von TripoSG, Hunyuan3D-2.1 Shape, Step1X-3D Geometry, TRELLIS.2 oder deinen eigenen Tools stammen.
So läuft es
Dieses Paket enthält nur Daten. Es benötigt die Local Python models runtime (aigd.python). Beim ersten Laden wird eine private Python-3.11-Umgebung mit PyTorch und Blender als Python-Modul aufgebaut (bpy 4.5 LTS, etwa 330 MB). Blender liest und schreibt die Meshes. FlashAttention wird nicht installiert: Die Attention läuft über die in PyTorch eingebauten Kernel. Open3D wird ebenfalls nicht installiert: Das Voxelgitter für die Glättung der Skin-Gewichte wird in NumPy mit derselben Mathematik wie bei Open3D aufgebaut. Die Checkpoints werden nur als Tensoren geladen, nie als Code. Die Modelle laufen offline; ihre Gewichte stammen ausschließlich aus den unten aufgeführten Dateien, die nach deiner Bestätigung von Hugging Face heruntergeladen werden. AI Game Dev hostet sie nicht.
Was heruntergeladen wird
Etwa 1,6 GB, festgelegt über Hugging Face Revision und sha256:
| Datei | Größe | Lizenz | Quelle |
|---|---|---|---|
skin_vae_2_10_32768-last.ckpt | 0.49 GB | MIT | Datei |
articulation_xl_quantization_256_token_4-grpo_1400.ckpt | 1.13 GB | MIT | Datei |
Qwen3-0.6B-config.json | 0.00 GB | Apache-2.0 | Datei |
Der Python-Code des Modells (src/, configs/skeleton/) wird von GitHub beim Commit 273b691 heruntergeladen, jede Datei per sha256 geprüft.
Lizenz
- Gewichte und Code: MIT, © 2025 VAST-AI-Research (Lizenz, Modellkarte).
- Qwen3-0.6B-Konfigurationsdatei: Apache-2.0, © Alibaba Cloud (Modellkarte). Es wird nur ihre
config.jsonheruntergeladen; die Gewichte des Sprachmodells sind Teil von SkinTokens. - Blender als Python-Modul (
bpy4.5.16): GPL-3.0-or-later, © Blender Foundation (PyPI). Die Runtime installiert es von PyPI in die private Umgebung des Modells, wo der Rigging-Handler der App es importiert, um Meshes zu lesen und zu schreiben. AI Game Dev liefert bpy nicht mit. - Der Rigging-Handler (
skintokens/handler.pyin der Python-Runtime der App): GPL-3.0-or-later, weil er bpy importiert. Er läuft als eigenständiges Programm im eigenen Python-Worker-Prozess des Modells, den die App startet und mit dem sie ausschließlich über JSON-Nachrichten über stdio kommuniziert. Sein Quellcode wird mit der App ausgeliefert; sieheTHIRD_PARTY_NOTICES.md.
Erforderliche Namensnennung: "SkinTokens © 2025 VAST-AI-Research (MIT)".
Einschränkungen: Die kommerzielle Nutzung des Modells und der davon erzeugten Rigs ist erlaubt. Eine Weitergabe der Gewichte erfordert den MIT-Copyright-Hinweis.
Versionen
| Version | Veröffentlicht | Benötigt die App |
|---|---|---|
| 1.0.4Neueste | 0.32.0-beta.6 oder neuer | |
| 1.0.3 | 0.32.0-beta.6 oder neuer |
Installieren
In der Desktop-App
Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle Browse, suche aigd.model3d-skintokens und klicke auf Add to Project.
Noch keine App? Lade AI Game Dev kostenlos herunter für Windows, macOS oder Linux.
Im Terminal
Mit der gamedev CLI in deinem Projektordner:
gamedev pkg add aigd.model3d-skintokensVoraussetzungen
- AI Game Dev 0.32.0-beta.6 oder neuer
- Eine NVIDIA GPU mit mindestens 14 GB
gamedev pkg add aigd.model3d-skintokens