用途:把一句话创意(如“a cheerful corgi”)做成带骨骼、含 13 段动画片段的体素生物,导出 glTF。分四个阶段,每阶段有 QA 门;必须按顺序执行,只有第 1 阶段的概念选择是需要用户手动挑选的门,其余自动。
目录与工具:资产放在 assets/<Name>/(PascalCase 名称),含 concept、网格、.vox、previews、layout.json、<name>_rules.py、<Name>_rigged.blend、<Name>_animated.glb、report.json 与 run.log。工具在 tools/pipeline/concept.py、tools/pipeline/run_creature.py、tools/voxelizer/(需用 CMake 构建一次)、tools/rig/。要求 Blender 5.2 LTS 在 PATH(或设 BLENDER=/path)、fal API key(FAL_KEY 或 ~/.fal/key)、Python 3.10+ 与 Pillow。
第 1 阶段(fal 文生图)使用模型 bytedance/seedream/v5/pro/text-to-image,可用 fal-ai MCP 工具,或运行:python tools/pipeline/concept.py <Name> --idea "a cheerful corgi" --len-m 0.9 --anatomy "..." --colors "..."。提示需描述为体素艺术、侧三分之四视角、四肢分离、浅灰背景、整体入框,细长部件需加厚或省略。自动 QA 后必须让用户从 concept_sheet.png 中挑选,并保留所选候选的 fal CDN URL。
第 2–4 阶段一条命令完成:python tools/pipeline/run_creature.py <Name> --image-url <picked CDN url> --len-m 0.9。依次调用 fal-ai/hunyuan-3d/v3.1/pro/image-to-3d(generate_type: Normal,PBR 开,face_count: 100000,约 2.5 分钟,背面不对可用 back_image_url)、5 cm 体素化(--long-axis = 2 × 米数 × 10,检测朝向,必要时用 --yaw 和 --vox 修正)、绑定(由网格推导身体计划并生成规则,构建 14 骨骼四足骨架,编写 Idle/Walk/Gallop/Graze/Alert 并执行 tools/rig/clips/ 下的全部模块,导出 glTF)。QA 门为数值检查:report.json 的 stages.rig.guards 中 DIRECTION GUARD: OK 表示行走时着地脚向后扫并触地,suspension: YES 表示疾驰有腾空帧。可选 --video 输出每段动画的 3/4 视角 MP4。
第 5 阶段:<Name>_animated.glb 可导入 Godot、Unity、Unreal 和 three.js,动画片段名称各动物一致,便于状态机引用。
限制:仅支持四足动物;双足、鸟类、蛇类及有活动尾巴的动物需自行编写构建脚本;不适用于有机角色。费用、平台细节等资料未提供。