本页由英文机器翻译而成。阅读英文原文。

SkinTokens(本地自动绑定)

官方工具GPUv1.0.4aigd.model3d-skintokens
安装 还没安装应用?免费下载
或从终端安装
gamedev pkg add aigd.model3d-skintokens
在你的电脑上运行。 只需下载一次模型,之后即可在这台电脑的 GPU 上生成。

概览

本地自动绑定:VAST-AI 的 SkinTokens 为角色或生物网格(GLB、OBJ 或 FBX)添加骨骼和蒙皮权重,并输出一个保留原始材质和 UV 的已绑定 GLB。在 Asset Studio 中用你的 NVIDIA GPU 运行,需要 14 GB 显存。MIT 许可,允许商用。

NVIDIA 14 GB 及以上

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 中运行,而不是在聊天智能体里:

  1. 打开 Asset Studio,选择 3D → SkinTokens → Rig。
  2. 添加要绑定的网格:GLB、OBJ 或 FBX 文件,例如 Assets/Models/goblin.glb。
  3. 检查绑定好的 GLB。如果骨骼不适合这个模型,就再运行一次:每次运行都会采样一套新的骨骼。

亮点

模型 idaigd.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.ckpt0.49 GBMIT文件
articulation_xl_quantization_256_token_4-grpo_1400.ckpt1.13 GBMIT文件
Qwen3-0.6B-config.json0.00 GBApache-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(bpy 4.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 版权声明。

版本

SkinTokens(本地自动绑定) 的发布版本
版本发布时间需要应用
1.0.4最新0.32.0-beta.6 或更高版本
1.0.30.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