uloop-execute-dynamic-code

name	uloop-execute-dynamic-code
description	Execute C# code dynamically in Unity Editor. Use when you need to: (1) Wire prefab/material references and AddComponent operations, (2) Edit SerializedObject properties and reference wiring, (3) Perform scene/hierarchy edits and batch operations. NOT for file I/O or script authoring.

uloop execute-dynamic-code

Execute C# code dynamically in Unity Editor.

Usage

uloop execute-dynamic-code --code '<c# code>'

Parameters

Parameter	Type	Default	Description
--code	string	-	C# code to execute (direct statements, no class wrapper)
--compile-only	boolean	false	Compile without execution
--parameters	object	-	Runtime parameters passed to the snippet (advanced; usually unnecessary)

Code Format

Write direct statements only (no classes/namespaces/methods). Return is optional.

// Using directives at top are hoisted
using UnityEngine;
var x = Mathf.PI;
return x;

String Literals (Shell-specific)

Shell	Method
bash/zsh	'Debug.Log("Hello!");'
PowerShell	'Debug.Log(""Hello!"");'

Allowed Operations

• Prefab/material wiring (PrefabUtility)
• AddComponent + reference wiring (SerializedObject)
• Scene/hierarchy edits
• Inspector modifications

Forbidden Operations

• System.IO.* (File/Directory/Path)
• AssetDatabase.CreateFolder / file writes
• Create/edit .cs/.asmdef files

Global Options

Option	Description
--project-path <path>	Target a specific Unity project (mutually exclusive with --port)
-p, --port <port>	Specify Unity TCP port directly (mutually exclusive with --project-path)

Examples

bash / zsh

uloop execute-dynamic-code --code 'return Selection.activeGameObject?.name;'
uloop execute-dynamic-code --code 'new GameObject("MyObject");'
uloop execute-dynamic-code --code 'UnityEngine.Debug.Log("Hello from CLI!");'

PowerShell

uloop execute-dynamic-code --code 'return Selection.activeGameObject?.name;'
uloop execute-dynamic-code --code 'new GameObject(""MyObject"");'
uloop execute-dynamic-code --code 'UnityEngine.Debug.Log(""Hello from CLI!"");'

Output

Returns JSON with execution result or compile errors.

Notes

For file/directory operations, use terminal commands instead.

Code Examples by Category

For detailed code examples, refer to these files:

• Prefab operations: See references/prefab-operations.md
  • Create prefabs, instantiate, add components, modify properties
• Material operations: See references/material-operations.md
  • Create materials, set shaders/textures, modify properties
• Asset operations: See references/asset-operations.md
  • Find/search assets, duplicate, move, rename, load
• ScriptableObject: See references/scriptableobject.md
  • Create ScriptableObjects, modify with SerializedObject
• Scene operations: See references/scene-operations.md
  • Create/modify GameObjects, set parents, wire references, load scenes
• Batch operations: See references/batch-operations.md
  • Process multiple assets/objects in one execution
• Selection operations: See references/selection-operations.md
  • Read/set editor Selection, operate on selected objects
• Undo operations: See references/undo-operations.md
  • Register undo for editor modifications
• Cleanup operations: See references/cleanup-operations.md
  • Delete/revert temporary assets and objects safely