Sand3D 来自 Sandflow,分两部分。sand3d 是一个 Python 库,用一段简短的程序来描述 3D 物体:轮廓、实体、编辑、关节和装配体,由 Blender 的 bpy 模块计算。Sand3D 数据集是 106,094 个现有 3D 物体,被重建成 sand3d 程序,发布在 Hugging Face 上,附带每个程序导出的 3D 文件和一张渲染图。

它的想法是让语言模型像写代码一样写和编辑 3D 物体。README 说整个 API 可以放进约 3,600 个 token 的提示词里,而且零件用名字来指代("门""顶面"),不用手算坐标。

谁做的

Sandflow,一家做代码驱动 3D 建模的公司。它的网站把第一个模型列为"coming soon",并提供候补名单。库的引用文件署名作者是 Thibault Neveu 和 Andréa Loy。公开发布的 1.6.3 版日期是 2026 年 11 月 6 日,Sandflow 宣布数据集的新闻稿日期是 2026 年 11 月 5 日。

我们在 2026 年 11 月 21 日查看时,GitHub 仓库有 2,202 个星标、241 个 fork,Sandflow 的页面显示数据集在 Hugging Face 上的下载量为 317,082 次。

数据集里有什么

五个数据集,来自 Hugging Face 上的数据集卡片:

数据集 物体数 带关节
sand3d-objaverse(来自 Objaverse 的日常物品) 66,887 14
sand3d-cad(来自公开 CAD 模型的机械零件) 24,495 0
sand3d-articraft(可活动的物体) 9,209 9,139
sand3d-simready(NVIDIA SimReady 素材) 2,334 434
sand3d-automate(机械装配体及其零件) 3,169 869
合计 106,094 10,456

每一行包含物体的 sand3d 程序、程序导出的 OpenUSD(.usda)文件(单位为米,Z 轴向上,带材质,可活动的物体还带关节)、一张渲染图、一个粗略的类别(如家具、手工工具),以及一个 f_score,用来衡量程序生成的形状与原物体的接近程度。你可以在 Sand3D explorer 里浏览。

这些是现有物体的重建版本,卡片把它们描述为日常物品、可活动的机构和机械 CAD 零件。关节被声明为零件之间的铰链、滑动和旋转;没有游戏角色用的那种骨骼或动画片段。

免费还是收费,以及许可证

目前发布的所有内容都是免费的。

  • 库使用 Apache License 2.0,仓库里有明确说明。
  • 数据集使用 CC BY 4.0(每张数据集卡片上写的是 cc-by-4.0)。每个物体都源自第三方物体,所以那个物体自己的许可证同样适用。每一行都有 source_license 和 attribution 列,卡片说所有来源都是 CC-BY-4.0、Apache-2.0 或 CC0,没有非商业或相同方式共享的。在 Objaverse 数据集中,66,275 个物体来自 CC-BY-4.0 来源,612 个来自 CC0。

所以你可以在商业游戏里使用这些物体,前提是保留每个物体的署名,以及"该物体经过修改"的说明。

怎么用

安装库(来自 README):

pip install sand3d

Blender 以 bpy 模块的形式一并安装:Python 3.13 上是 bpy 5.2,Python 3.11 上是 bpy 4.5。Python 3.12 没有 bpy 的 wheel,从 bpy 5.2 起 Intel Mac 也没有。

第一个程序,抄自 README。它构建一个安装支架,默认单位是毫米,并导出为 GLB:

import sand3d as s3d

def bracket(w=80, d=40, t=6, hole_d=6.6, pitch=50):
    plate = s3d.extrude("plate", s3d.rect(w, d, r=4), t)
    s3d.hole(plate, hole_d, on=s3d.grid(2, 1, pitch, 0))
    s3d.fillet(plate, 1, edges="top")
    return plate

s3d.export(bracket(), "bracket.glb")

文件扩展名决定格式:.glb、.urdf、.usda、.ifc、.obj 或 .stl。README 把 GLB 描述为"for the web, viewers, game engines"的格式,关节存放在每个节点的 extras 里。sand3d 导出的 .glb 可以用标准的 GLTFLoader 在 three.js 里加载,和其他 glTF 文件一样。

想让 AI 模型来写程序,README 说要把 docs/api.md 放进系统提示词。对于有多个零件的物体,文档里有编写装配体的八条规则。快速入门用代码和渲染图展示了每个函数。

README 里的洗衣机例子展示了关节的样子:门、滚筒、洗涤剂抽屉和旋钮都是有名字的零件,四行代码声明了它们怎么运动:

s3d.joint("door_hinge", door, hinge, axis="-Z", range=(0, 143))
s3d.joint("drum_spin", drum, front.move(0, 400), kind="continuous")
s3d.joint("drawer_slide", drawer, top_band.move(150), kind="prismatic", axis="+X", range=(0, 200))
s3d.joint("dial_turn", dial, top_band.move(-150), kind="continuous")

我们在一个文件里发现了什么

2026 年 11 月 21 日,我们下载了 sand3d-articraft 数据集卡片所链接的示例文件,一个小巧的相机闪光灯,没有登录 Hugging Face:

  • 这是一个纯文本的 OpenUSD 文件,50,778 字节,文件头写着 written by sand3d: compact_flash at rest, metres and degrees,Z 为向上轴。
  • 它有 12 个命名的网格,包括 main_body、shoe_plate、三个按钮、swivel_cylinder、tilt_pin、head_body 和 flash_window,合计 364 个三角形。
  • 它声明了 5 个带限位的关节:三个可滑动 3 毫米的按钮(body_to_button_0 到 _2),一个向两侧各转约 90 度的旋转座(body_to_swivel),以及一个从约 -11 度倾斜到 90 度的灯头(swivel_to_head)。
  • 材质是简单的命名颜色(plastic__555555、steel__444444),没有贴图。

我们没有为这篇指南安装这个库,所以没有运行支架程序。注意,数据集提供的是 .usda 文件:要得到可用于 three.js 游戏的 GLB,你需要用 sand3d 运行该物体的程序并导出,或者用自己的工具转换 USD 文件。

适合谁

  • 让 AI 智能体构建 3D 游戏的开发者,希望智能体写出可编辑、有名字、参数化的模型,而不是黑盒网格。我们的 Claude Fable 5.2 Three.js 指南要求模型用代码生成所有模型;sand3d 是用 Python 做这件事的一种结构化方式。
  • 训练或测试写 3D 代码的模型的研究人员(数据集有训练集和验证集划分)。
  • 需要机器和可活动道具的人:门、抽屉、拉杆、轮子、带真实关节限位的按钮。

如果你想要现成的、风格统一的游戏素材直接放进场景,游戏素材库是更短的路。

和其他资源比较

Kenney 和 Quaternius 以 CC0 发布可直接用于游戏的素材包,不需要署名;Quaternius 的 FAQ 列出了 Blender 和 FBX 文件。Poly Pizza 是一个搜索站,收录 10,700 多个来自许多作者的免费低多边形模型,每个模型有自己的许可证,通常是 CC0 或 CC BY。Poly Haven 提供写实的 HDRI、贴图和模型,全部是 CC0。Sand3D 是另一类资源:它的物体是 Python 程序加导出的 USD 文件,以 CC BY 4.0 授权并附每个物体的来源署名,为语言模型阅读、编辑和生成而做。它没有带骨骼的角色和动画片段,物体也不像 Kenney 或 Quaternius 的素材包那样被做成风格统一的一套。

来源

星标、fork 和下载数均于 2026 年 11 月 21 日核对。

做过用代码生成模型的游戏?提交到 VibeGamer。