unity-gameobject-edit

GameObject & Component Editing

Modify existing GameObjects and their components. Read references/component-edit-safety.md when the task involves destructive edits, nested field paths, or tag/layer changes.

Use When

• The user wants to change an existing object's properties or hierarchy.
• The user wants to inspect, modify, or remove components on an existing object.
• The user needs tag or layer management in the current project.

Do Not Use When

• The task is to create a brand new scene layout from scratch.
• The task is specifically about prefab asset editing rather than scene objects.

Recommended Flow

1. Identify the exact gameObjectPath and current components before changing anything.
2. Apply one mutation at a time with modify_gameobject, modify_component, or field-level edits.
3. Use destructive commands like delete_gameobject or remove_component only after confirming scope.
4. Save the scene after destructive or bulk updates.

Commands

# Modify GameObject properties
unity-cli raw modify_gameobject --json '{"path":"/Player","name":"Hero","active":true}'
unity-cli raw delete_gameobject --json '{"path":"/OldObject"}'

# Component operations
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"}'
unity-cli raw list_components --json '{"gameObjectPath":"/Player"}'
unity-cli raw get_component_types --json '{}'

# Tags & layers
unity-cli raw manage_tags --json '{"action":"add","tagName":"Enemy"}'
unity-cli raw manage_layers --json '{"action":"get"}'

Examples

• "Deactivate /Player and rename it to Hero."
• "Change the Rigidbody mass on /Player and move it to a new position."
• "Remove the old collider from /Obstacle after checking its components."

Common Issues

• gameObjectPath is wrong: inspect the hierarchy first and use the full path.
• set_component_field fails: use dot-separated fieldPath values and verify the target component exists.
• Destructive edits removed too much: prefer listing components or inspecting the object before delete operations.
• Save the scene after destructive edits so changes do not vanish on reload.