SuperAPI AI 工具集

building-3d-objects

智能体与模型

查看项目

更新于 10-16 09:47

技能介绍

用途:该技能用于在 Roblox Studio 中生成可靠、高质量的单体 3D 物体、道具和房间尺度结构,依赖 mcp__roblox__run_code 工具执行 Lua 代码。

主要能力与流程:采用四阶段顺序构建,不鼓励单次调用完成复杂物体。第一阶段评估需求是否包含具体组件、大致尺度、静态或含运动部件;任一缺失则停止并要求用户提供更多细节,建议改用 roblox-design-consultant 技能收集需求。第二阶段规划坐标系,多调用构建或部件数超过 5 时必须使用具名变量和几何清单头,并将尺寸对齐到统一网格。第三阶段生成几何与 CSG,负部件需加 EPSILON(如 0.01)防止 Z-fighting,需从基础部件复制完整 CFrame,并重设 UsePartColor 与颜色。第四阶段执行验证脚本。

必要用法与限制:工具以无状态方式执行 Lua,每次调用都是空白状态,变量与对象引用不会保留;必须在每次 run_code 调用开头用 workspace:FindFirstChild("ModelName") 重新获取引用,否则需新建 Model。禁止猜测坐标、尺寸或朝向,应显式打印当前 CFrame 与 Size 作为依据。除非明确要求物理模拟,所有部件设 Anchored 为 true。子部件位置须相对父部件或模型的 CFrame,避免硬编码世界坐标。有机形状应使用 CSG、圆柱或球体,而非纯方块。SubtractAsync 与 UnionAsync 可能静默失败,须用 pcall 包裹并验证结果为 BasePart。构建后读取并适配 scripts/validate.luau 的 TARGET_MODEL_NAME 执行验证,出现 [ERROR] 或 [WARN] 须返回第三阶段修复后重新验证。补充文档仅按触发条件阅读:docs/spatial-patterns.md、docs/csg-patterns.md、docs/platform-rules.md。