rocketbox-avatars-glb:140个开箱即用的绑定3D角色终极指南
rocketbox-avatars-glb:140个开箱即用的绑定3D角色终极指南
rocketbox-avatars-glb 是一个开箱即用的绑定 3D 角色资源库:它把微软 Rocketbox Avatar Library 的 140 个绑定角色(职业人物、成人、儿童与农场动物)完整重建为 GLB 格式,全部人类角色共享同一套 Bip01 骨骼并携带 175 个面部 blendshape(visemes、FACS、ARKit),一套动画就能驱动全部角色,且采用 MIT 授权。无论你是做 Web 游戏、移动端项目还是 Blender 桌面开发,都能在这里直接找到对应层级的现成文件。
💡 为什么这套角色库值得收藏
大多数免费角色库的痛点是:每个角色骨骼不同,动画无法复用。而本仓库给出的 140 个绑定 3D 角色解决了这个问题:
- 🦴 统一骨骼:所有人类角色使用相同的 Bip01 骨骼(80 根骨骼),一个走路动画可以驱动全部 140 个角色
- 🗣️ 175 个面部 blendshape:覆盖 visemes(口型)、FACS(面部动作编码)和 ARKit,做虚拟人、数字人、语音口型都够用
- 📦 多档位文件:从 Web 游戏到移动端、再到桌面引擎,6 个文件夹对应 6 种使用场景,无需自己减面压纹理
- ⚖️ MIT 授权:商业项目可放心使用,授权文本随仓库提供(见 LICENSES.md)
📊 140 个角色都有谁
角色按分组共 140 个,平均每角色约 7,400 个三角形,属于典型的"高模质量、低面数成本":
| 分组 | 数量 | 示例 |
|---|---|---|
| 职业人物 Professions | 71 | 商务、医护、警察、消防员、军人、建筑工人、飞行员、体育、厨师、园丁等 |
| 成人 Adults | 40 | male-adult-01 ~ 21、female-adult-01 ~ 17 等通用角色 |
| 儿童 Children | 4 | male-child-01/02、female-child-01/02 |
| 动物 Animals | 25 | 牛、马、骆驼、羊、猪、驴、鸡、鸭、鹅、狗、鹿等农场动物 |
每个角色的元信息(标题、分组、三角形数、骨骼数、各层级文件路径与大小)都记录在 metadata.jsonl 中,一行一个角色,方便程序化筛选和下载。
🗂️ 六个文件夹怎么选:一图对照
仓库把 243.8 MB 源文件拆成 6 个用途明确的档位,选对文件夹是性能优化的第一步:
| 文件夹 | 体积 | 内容 | 适用场景 |
|---|---|---|---|
| objects/ | 268.4 MB | meshopt 几何 + WebP 纹理 | three.js、Babylon.js 等 Web 场景 |
| objects_ktx2/ | 379.3 MB | meshopt + KTX2 纹理(带 mipmap) | WebGPU / WebGL 游戏,纹理在 GPU 上保持压缩 |
| lods/ | 254.6 MB | 3 档简化(原三角面的 50% / 20% / 6%) | 距离 LOD、人群、远景 |
| mobile/ | 78.9 MB | 25% 三角面 + 纹理最大 512px | 手机与低配笔记本 |
| engine/ | 3.97 GB | 无 meshopt、无量化 | Blender 及不支持 meshopt 的桌面引擎 |
| collision/ | 0.4 MB | 凸包碰撞体(纯 glTF) | Rapier、Jolt、PhysX、Unity 碰撞器 |
新手建议:Web 项目先跑 objects/;做游戏追求显存效率换 objects_ktx2/;手机项目直接用 mobile/;进 Blender 就用 engine/,零配置。
🚀 三步上手:下载并加载第一个角色
第 1 步,克隆仓库(约 4.5 GB,engine 档体积最大):
git clone https://gitcode.com/hf_mirrors/codepawl/rocketbox-avatars-glb
第 2 步,按场景选文件。每个角色一个目录,比如商务女性 1 号:objects/business-female-01/business-female-01.glb。
第 3 步,交给你的引擎或库加载。以 three.js(WebGPU)为例,只需挂上 KTX2 与 meshopt 解码器:
const ktx2 = new KTX2Loader().setTranscoderPath('.../basis/').detectSupport(renderer);
const gltf = await new GLTFLoader()
.setKTX2Loader(ktx2)
.setMeshoptDecoder(MeshoptDecoder)
.loadAsync('objects_ktx2/business-female-01/business-female-01.glb');
各档位用到的 glTF 扩展(也可在 metadata.jsonl 的 extensions 字段逐行查看):
- web / ktx2 / mobile:
EXT_meshopt_compression+KHR_mesh_quantization,纹理分别为 WebP / KTX2 - engine:无扩展,纯标准 glTF,导入 Blender 等工具零门槛
⚡ 性能实测:手机加载只要零点几秒
官方在"Fast 4G + 4 倍 CPU 节流"的手机模拟环境下实测(完整数据见 README.md):
| 档位 | 单角色文件(中位数) | 显存占用 | 手机 4G 加载 |
|---|---|---|---|
| web | 2.4 MB | 106.9 MiB | 约 2.4 s |
| ktx2 | 3.2 MB | 18.9 MiB | 约 3.0 s |
| lod2 | 0.6 MB | 1.2 MiB | 约 0.68 s |
| mobile | 0.6 MB | 1.3 MiB | 约 0.75 s |
可以看到:ktx2 档把显存压缩到 web 档的约 1/5;而 LOD2 或 mobile 档只花 0.6 MB 就能在手机上亚秒级加载——做"百人同屏"类场景时,这套分级几乎是必需品。所有文件均在 three.js 0.187.0 与 Blender 5.2 中做过 140/140 全量加载绘制验证(详见 README 的 Tested 表格)。
📋 用数据工具直接读取:parquet 数据集
除了直接下载文件,仓库还提供 data/ 下的 4 个 parquet 分片(如 train-00000-of-00004.parquet),与 metadata.jsonl 同构,但额外嵌入了 mesh 数据(trimesh 可解码的 engine 档 GLB)和缩略图(Image),可以直接用 Hugging Face Dataset Viewer 或 load_dataset 做批量分析、筛选与训练。构建统计信息见 viewer_build.json(140 行、4 分片、约 3.6 GB)。
每个角色还配有缩略图 thumbs/(140 张 webp)与一份轻量预览副本 preview/(15 个角色,加载更快)。
📜 授权与引用说明
- 全部文件 MIT License,源自 Microsoft Rocketbox Avatar Library(Copyright (c) 2020 Microsoft),授权文本见 LICENSES.md,分发副本时须一并携带
- 用于研究时请引用:Gonzalez-Franco et al., The Rocketbox library and the utility of freely available rigged avatars, Frontiers in Virtual Reality 2020
- 本仓库的转换工作(FBX/TGA → GLB/PNG、PBR 材质重建、LOD 与压缩)在 Blender 5.2 中完成,骨骼与 blendshape 均原样保留
🧭 快速选型 FAQ
- 问:Web 项目用哪档? 答:一般场景用
objects/;WebGPU 或追求显存效率用objects_ktx2/ - 问:手机上同时显示很多角色? 答:
mobile/打底,远处换lods/的 lod2/lod3 - 问:要做物理碰撞? 答:直接用
collision/下的凸包文件,Rapier、Jolt、PhysX 均可 - 问:Blender 导入报错或体积敏感? 答:用
engine/档(无压缩),保证 100% 兼容性 - 问:能商用吗? 答:MIT 授权可以商用,保留许可证文件并在研究场景按上述格式引用即可
结语
rocketbox-avatars-glb 的价值不在于"又一套角色模型",而在于统一骨骼 + 175 面部 blendshape + 六档位文件的组合:一次下载,从手机 H5 到桌面 Blender 全链路覆盖。把 140 个角色拉进你的项目,让它们共享同一套动画系统吧 🎬