anyCreature icon

anyCreature

anyCreature 是一个 GitHub 项目,可将简短文本指令转为可直接用于游戏的 3D 生物。它将单个 JSON 规格编译为带动画、顶点色、环境光遮蔽烘焙和离线展示浏览器的蒙皮 GLB。

anyCreature

anyCreature 的功能

anyCreature 是一个 GitHub 托管项目,可在单次会话中把简短文本指令转为可直接用于游戏的 3D 生物。仓库描述了一种 AI 辅助工作流:它可以提出最多两个问题,然后将一个 JSON 规格编译为带动画、顶点色、环境光遮蔽烘焙和离线展示浏览器的蒙皮 GLB。

该项目定位为文本转生物流水线,而不是网格建模工具。README 强调它不依赖下载的美术包或摄影测量,并且引擎接口刻意保持简洁:`node engine/cli.js spec.json out.glb`。文档还包含手册、阶段卡、校准资源,以及用于测量轮廓并强制执行输出检查的 harness 工具。

仓库中的示例是 `example/wolf.json`,被描述为一种由纯文本生成、由引擎输出的轻型四足动物。仓库说明该示例附带两个动画,并且某些特性,例如 `build: "rigid"`,更适合非有机主体,而不是动物。

核心能力

单规格生物编译

引擎将一个 JSON 规格编译为带蒙皮的 GLB,因此生物是用文本描述的,而不是由网格文件或外部美术包组装而成。

结构化的多阶段生成

所述工作流支持一条指令、最多两个访谈问题、轮廓设计轮次,以及最终的交付阶段,用于盖章并分发结果。

开箱即用的交付包

根据仓库 README,输出包含动画、顶点色、环境光遮蔽烘焙,以及一个离线展示浏览器。

内置校准检查

仓库包含必须通过、且在合适情况下会被拦截的校准内容,因此检查器可以区分在特定机器上可接受与不可接受的输出。

可检查的生成控制

README 暴露了可调的规格选项,例如 `smooth_angle`、`shading`、`build: "rigid"` 和 `ao`,可让作者调整轮廓柔和度、颜色处理、刚性以及 AO 烘焙。

基于角色的质量预设

文档在 `harness/presets/` 下列出了预设 QC 角色:minion、npc 和 boss,表明不同生物角色可以使用不同的预算与阈值。

典型使用场景

  • 根据简短说明生成 3D 生物

    当你希望把用散文描述的生物变成可直接用于游戏的 GLB,而无需手工组装网格时,可以把这个仓库当作文本到资产流水线使用。

  • 构建并验证受控工作流

    当你需要一个可复现的流程,并且在发布前可以检查轮廓可读性和失败拦截时,可以使用手册、卡片和校准资源。

  • 将文档示例适配为新的生物角色

    当你需要为不同的生物角色调整系统时,可以参考示例狼和角色预设,将系统适配为更轻的四足动物、NPC 风格生物、杂兵或 boss,并使用不同的 QC 阈值。

  • 直接运行编译器

    当你只需要编译步骤时,可以使用引擎 CLI:从命令行把 JSON 规格转换为输出 GLB,而无需采用完整的代理驱动会话。

  • 检查并打包输出

    当你想测量遮罩、缩略图和声明,或者围绕已编译资产生成离线展示和交付包时,可以使用 harness 工具。

Pros and Cons

Pros

  • 能够从单个 JSON 规格生成一个具体的 3D 资产,并且文档明确说明了预期输出路径和文件类型。
  • 将生成与质量控制结合在一起:仓库内置了校准文件、轮廓门槛和拦截案例。
  • 核心引擎接口保持简单,只需一条命令即可将规格编译为 GLB。
  • 文档提供了可编辑的规格控制和角色预设,使工作流比黑箱式的纯提示系统更易于检查。
  • 包含手册和分阶段卡片,逐步解释生成过程。

Cons

  • 文档说明,渲染和测量工具依赖 Playwright 和无头 Chromium,尽管引擎本身没有运行时依赖。
  • 现有文本对某些能力的描述仍停留在较高层面,因此关于集成、除 GLB 之外支持的导出目标,以及更广泛的运行时要求,并没有完全说明。
  • README 警告说,对孤立部件的盲读对某些头部形状可能会出错,并且在 1.2.0 版本中,像 `part_attachment` 和 `mirror_distortion` 这样的破坏性检查器变更之后,旧规格可能会被拦截。

FAQ

anyCreature 会生成什么?

该仓库描述的是一种从一句简短指令开始的文本转生物工作流,可能会提出最多两个问题,然后基于单个 JSON 规格生成生物。README 说明输出内容包括带动画、顶点色、环境光遮蔽烘焙的蒙皮 GLB,以及一个离线展示浏览器。

如何开始使用它?

README 说明先运行 `bash setup.sh` 进行依赖安装和红/绿标尺校准,然后使用 `node engine/cli.js example/wolf.json out/wolf.glb` 作为基本编译命令。它还指出,`setup.sh` 必须输出 `calibrate OK`,输出结果才可被信任。

它需要额外依赖吗?

README 表示引擎本身没有运行时依赖,而 `node engine/cli.js spec.json out.glb` 就是完整接口。更大的 harness 会使用 Playwright 进行渲染和测量,因此工具链部分还有额外依赖。

哪些文件记录了工作流?

来源说明中提到,示例 `example/wolf.json` 有 2,211 个顶点和 31 个关节,并包含两个动画,而不是三个。还说明 `cards/` 目录包含执行会话按顺序读取的五张阶段卡。

anyCreature 有定价吗?

仓库包含 LICENSE 文件和 SECURITY.md,但所提供的页面文本并未给出该项目作为服务的定价方案。作为一个开源 GitHub 仓库,仓库页面上没有显示产品订阅价格。

Quick Facts

类别
开发者工具
仓库托管
GitHub
主要输出
蒙皮 GLB 生物文件
工作流
文本指令 → 访谈 → 轮廓轮次 → 编译 → 交付
运行时说明
引擎没有运行时依赖
定价
开源仓库;未显示产品定价