gameobject-modify

GameObject / Modify

Three modification surfaces

Per GameObject — parallel arrays must have the same length as gameObjectRefs:

1. gameObjectDiffs — full SerializedMember diff per GameObject (legacy, backwards compatible).
2. pathPatchesPerGameObject — list of {path, value} patches per GameObject routed through Reflector.TryModifyAt; atomic per-path modification.
3. jsonPatchesPerGameObject — JSON Merge Patch per GameObject routed through Reflector.TryPatch.

When more than one is supplied for the same GameObject they run in this order: jsonPatch → pathPatches → diff. At least one of the three is required.

Path syntax

fieldName, nested/field, arrayField/[i], dictField/[key].

How to Call

unity-mcp-cli run-tool gameobject-modify --input '{
  "gameObjectRefs": "string_value",
  "gameObjectDiffs": "string_value",
  "pathPatchesPerGameObject": "string_value",
  "jsonPatchesPerGameObject": "string_value"
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool gameobject-modify --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool gameobject-modify --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Name	Type	Required	Description
gameObjectRefs	any	Yes	Array of GameObjects in opened Prefab or in the active Scene.
gameObjectDiffs	any	No	Optional. Each item in the array represents a GameObject modification of the 'gameObjectRefs' at the same index. Usually a GameObject is a container for components. Each component may have fields and properties for modification. If you need to modify components of a GameObject, please use 'gameobject-component-modify' tool. Ignore values that should not be modified. Any unknown or wrong located fields and properties will be ignored. Check the result of this command to see what was changed. The ignored fields and properties will be listed.
pathPatchesPerGameObject	any	No	Optional. Per-GameObject list of path-scoped patches routed through Reflector.TryModifyAt. Outer index aligns with 'gameObjectRefs'; inner list contains {path, value} entries. Pass null or omit for GameObjects that should not receive path patches.
jsonPatchesPerGameObject	any	No	Optional. Per-GameObject JSON Merge Patch (RFC 7396, extended with [i]/[key] keys) routed through Reflector.TryPatch. Outer index aligns with 'gameObjectRefs'. Pass null or omit for GameObjects that should not receive a JSON patch.