SuperAPI AI 工具集

unity-probuilder

通用与其它

查看项目

更新于 10-15 17:25

技能介绍

用途:面向 Unity 中可编辑的 ProBuilder 网格(ProBuilderMesh),用于关卡灰盒(blockout)、关卡几何体与程序化网格细化;普通无拓扑编辑需求的基础对象应改用 gameobject_create。

主要能力:创建与批量创建参数化形状,支持 Cube、Sphere、Cylinder、Cone、Torus、Prism、Arch、Pipe、Stairs、Door、Plane。面与边编辑包括挤出、删除、合并、翻转法线、分离面、倒角边、挤出边、桥接边。网格/顶点/UV/材质操作为细分、统一法线、移动或设置顶点、查询顶点、焊接顶点、盒式 UV 投影、按面或整体赋材质。查询与轴心包含获取面/顶点/材质统计、居中或重定位轴心。批量优先:创建 2 个及以上形状时优先使用 probuilder_create_batch。

使用方式:调用技能前需先读取本文件或通过 GET /skills/recommend?includeSchema=true 获取参数定义,不可凭名称或描述猜参数;若已从 recommend/schema 获得参数定义,可直接进入 dryRun。多数编辑/查询技能接受 name、instanceId 或 path 定位对象,重名时优先 instanceId。编辑面之前用 probuilder_get_info,编辑顶点之前用 probuilder_get_vertices。可直接调用 unity_skills.call_skill。

运行模式与限制:v1.9 三层模式。Approval(默认)下查询类技能直接执行,创建/修改类为 FullAuto,首次调用返回 MODE_RESTRICTED,需走 grant 协议,成功 /permission/grant 后服务端执行并在同一响应返回结果;Auto/Bypass 下 SemiAuto 与 FullAuto 直接运行。probuilder_combine_meshes 在本模块中禁止自动执行(含 Modify|Delete,Delete 触发 NeverInSemi),仅 Bypass 模式或用户加入 Allowlist 后可调用,grant 流程返回 MODE_FORBIDDEN;probuilder_delete_faces 仅为 Modify,在 Approval/Auto 下仍可授权。缺少 com.unity.probuilder 时所有技能返回 package-missing 诊断而不执行。常见误区:不存在 probuilder_create_mesh 与 probuilder_edit_face,应使用 probuilder_create_shape 及具体面技能;probuilder_set_material 与 probuilder_set_face_material 不同,前者整体对象、后者指定面;普通网格不会自动变为 ProBuilder 网格;网格重建(ToMesh() + Refresh())已由技能处理,无需手动加。建议流程:批量创建主体积,先验证通行与游玩尺度,再做面/边细化,用顶点编辑处理斜坡与不规则轮廓,布局稳定后再赋快速颜色或正式材质。物理驱动道具的 MeshCollider 必须为凸;快速颜色用于原型阶段,正式交付使用材质资产。精确签名、参数与返回值以 GET /skills/schema 或 unity_skills.get_skill_schema() 为准;场景设计经验可参考 MODELING_REFERENCE.md。其他未在资料中提供的收费、平台或效果信息暂未提供。