object-modify

Modify fields and properties of UnityEngine.Object instances via the unity-mcp-cli tool.

Updated May 28, 2026
One-click install
npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill object-modify-ishaansingh-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: object-modify
Source: https://github.com/ishaansingh-ai/Mechanical-2D/tree/main/.claude/skills/object-modify
Command: npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill object-modify-ishaansingh-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Editing Unity objects programmatically requires knowing their exact serialized structure, and manual edits through the editor are slow to automate. This Skill lets you apply targeted changes to any UnityEngine.Object (GameObject, Component, Asset) by sending a diff of only the fields and properties you want to change. ## Core Features & Use Cases - Targeted Object Modification: Apply partial updates to fields and properties of any UnityEngine.Object referenced by instanceID, without resending the entire object. - Structured Diff Input: Uses a SerializedMember schema with 'fields' and 'props' arrays so nested values can be changed precisely, with unknown or invalid members reported back. - Result Feedback: Returns success status, the updated object data, and a log of modifications and warnings for verification. - Use Case: After inspecting a GameObject's Transform with object-get-data, change only its position property by sending a diff containing the new Vector3 value. ## Quick Start Ask the AI to modify a Unity object by its instanceID, for example: change the position property of the object with instanceID 12345 to (0, 5, 0) using object-modify.

Frequently Asked Questions about object-modify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I modify a Unity object property from the command line?▼

Run unity-mcp-cli run-tool object-modify with a JSON input containing objectRef (the instanceID) and objectDiff (the fields or props to change). Only include the members you want to modify; the response reports the updated data and any warnings.

How do I find the structure of a Unity object before modifying it?▼

Use the object-get-data skill first to inspect the object's serialized fields and properties. The object-modify documentation explicitly recommends inspecting the structure before sending a diff, so your typeName and member names match.

What types of Unity objects can object-modify change?▼

It works with anything derived from UnityEngine.Object, including GameObjects, Components, and Assets. The object is referenced by its instanceID, where a value of 0 is treated as null.

What happens if I send invalid fields in objectDiff?▼

Unknown or invalid fields and properties are reported in the response Logs array rather than silently ignored. The response also includes a Success flag and the updated object data so you can verify what was applied.

Why is unity-mcp-cli not found when running object-modify?▼

The CLI is either not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli or prefix commands with npx, and see the unity-initial-setup skill for detailed installation instructions.