SkinTokens(本地自动绑定)
gamedev pkg add aigd.model3d-skintokens概览
本地自动绑定:VAST-AI 的 SkinTokens 为角色或生物网格(GLB、OBJ 或 FBX)添加骨骼和蒙皮权重,并输出一个保留原始材质和 UV 的已绑定 GLB。在 Asset Studio 中用你的 NVIDIA GPU 运行,需要 14 GB 显存。MIT 许可,允许商用。
SkinTokens 借助 VAST-AI 的 SkinTokens 在你的 NVIDIA GPU(14 GB 显存或更多)上为 3D 模型做绑定。它预测角色或生物网格的骨骼和蒙皮权重,并写入你的原始文件,因此材质和 UV 都会保留。结果是已绑定的 GLB。在 AI Game Dev 中,它通过 Local Python models runtime(aigd.python)在本地运行。它适合需要先为生成的或手工制作的角色拿到第一版骨骼、再去做动画的开发者。
你可以做出什么
- 从 GLB、OBJ 或 FBX 网格得到已绑定的角色和生物,可直接在你的引擎或 DCC 工具中制作动画。
- 为本地图生 3D 模型生成的网格提供第一版骨骼和蒙皮权重。
- 为同一个网格生成多个绑定候选:每次运行都会采样一套新的骨骼。
如何使用
绑定在 Asset Studio 中运行,而不是在聊天智能体里:
- 打开 Asset Studio,选择 3D → SkinTokens → Rig。
- 添加要绑定的网格:GLB、OBJ 或 FBX 文件,例如
Assets/Models/goblin.glb。 - 检查绑定好的 GLB。如果骨骼不适合这个模型,就再运行一次:每次运行都会采样一套新的骨骼。
亮点
| 模型 id | aigd.model3d-skintokens.v1 |
| 操作 | 为 3D 模型做绑定(一个输入网格:GLB、OBJ 或 FBX) |
| 输出 | 带骨骼和蒙皮权重的已绑定 GLB;保留原始材质和 UV |
| 运行于 | 14 GB 显存或更多的 NVIDIA GPU(CUDA) |
| 下载 | 约 1.6 GB,外加首次加载时运行时的 Python 环境(其中包含作为 Python 模块的 Blender) |
| 许可证 | MIT,允许将模型及其生成的绑定用于商业用途 |
要绑定的网格可以来自 TripoSG、Hunyuan3D-2.1 Shape、Step1X-3D Geometry、TRELLIS.2 或你自己的工具。
运行方式
这个包只包含数据。它需要 Local Python models runtime(aigd.python)。首次加载时会构建一个私有的 Python 3.11 环境,其中包含 PyTorch 和作为 Python 模块的 Blender(bpy 4.5 LTS,约 330 MB)。Blender 负责读写网格。不安装 FlashAttention:注意力计算使用 PyTorch 内置的核函数。也不安装 Open3D:用于蒙皮权重平滑的体素网格用 NumPy 构建,数学上与 Open3D 的实现相同。检查点仅以张量形式加载,绝不作为代码执行。模型离线运行;其权重只来自下方这些文件,在你确认之后从 Hugging Face 下载。AI Game Dev 不托管这些文件。
会下载哪些内容
约 1.6 GB,按 Hugging Face 修订版本和 sha256 固定:
| 文件 | 大小 | 许可证 | 来源 |
|---|---|---|---|
skin_vae_2_10_32768-last.ckpt | 0.49 GB | MIT | 文件 |
articulation_xl_quantization_256_token_4-grpo_1400.ckpt | 1.13 GB | MIT | 文件 |
Qwen3-0.6B-config.json | 0.00 GB | Apache-2.0 | 文件 |
模型的 Python 代码(src/、configs/skeleton/)从 GitHub 按提交 273b691 下载,每个文件都用 sha256 校验。
许可证
- 权重与代码:MIT,© 2025 VAST-AI-Research(许可证、模型卡)。
- Qwen3-0.6B 配置文件:Apache-2.0,© Alibaba Cloud(模型卡)。只下载其中的
config.json;语言模型的权重已包含在 SkinTokens 中。 - 作为 Python 模块的 Blender(
bpy4.5.16):GPL-3.0-or-later,© Blender Foundation(PyPI)。运行时从 PyPI 把它安装到模型的私有环境中,应用的绑定处理器在该环境里导入它来读写网格。AI Game Dev 不分发 bpy。 - 绑定处理器(应用 Python 运行时中的
skintokens/handler.py):GPL-3.0-or-later,因为它会导入 bpy。它作为独立程序在模型自己的 Python 工作进程中运行,该进程由应用启动,双方只通过 stdio 上的 JSON 消息通信。其源代码随应用一同分发;参见THIRD_PARTY_NOTICES.md。
必须保留的署名:"SkinTokens © 2025 VAST-AI-Research (MIT)"。
限制: 允许将模型及其生成的绑定用于商业用途。再分发权重时必须附带 MIT 版权声明。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.4最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.3 | 0.32.0-beta.6 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.model3d-skintokens,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.model3d-skintokens环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
- NVIDIA GPU,14 GB 显存或以上
gamedev pkg add aigd.model3d-skintokens