用途:在已经准备好的 Unity 场景中修改现有 GameObject 及其组件,是 unity-scene-inspect 的破坏性版本。
适用场景:需要变更现有对象的属性或层级结构;需要查看、修改或删除现有对象上的组件;需要管理当前项目的标签(tag)或图层(layer)。
不适用:从零创建新场景应使用 unity-scene-create;编辑预制体资产而非场景对象应使用 unity-prefab-workflow;只读取状态而不做修改应使用 unity-scene-inspect。
推荐流程:修改前先检查确切的 gameObjectPath 和当前组件;每次只应用一个修改,使用 modify_gameobject、modify_component 或 set_component_field;delete_gameobject 与 remove_component 仅在确认范围后使用;破坏性或批量更新后保存场景,以免重新加载丢失工作。
示例命令(保持原样): unity-cli raw modify_gameobject --json '{"path":"/Player","name":"Hero","active":true}' unity-cli raw modify_component --json '{"gameObjectPath":"/Player","componentType":"Rigidbody","properties":{"mass":2.0}}' unity-cli raw set_component_field --json '{"gameObjectPath":"/Player","componentType":"Transform","fieldPath":"position","value":{"x":0,"y":1,"z":0}}' unity-cli raw remove_component --json '{"gameObjectPath":"/Player","componentType":"BoxCollider"}'
使用示例:将 /Player 停用并重命名为 Hero;把 /Player 的 Rigidbody 质量改为 2.0 并移动到 (0,1,0);列出 /Obstacle 的组件后删除旧碰撞体。
限制:资料提及需要满足连接与实例前置条件(见 runtime-checklist.md),破坏性编辑安全、嵌套字段路径及标签/图层注意事项见 component-edit-safety.md。除上述内容外,具体版本、平台与收费信息暂未提供。