uloop-execute-dynamic-code

hatayama 的头像作者 hatayama

通过 uloop CLI 在 Unity 编辑器中动态执行 C# 代码。用于编辑器自动化:1)预制体/材质连接和 AddComponent 操作,2)使用 SerializedObject 进行引用连接,3)场景/层次结构编辑和批量操作。不适用于文件 I/O 或脚本编写。

📖 中文导读:通过 uloop CLI 在 Unity 编辑器中动态执行 C# 代码。用于编辑器自动化:1)预制体/材质连接和 AddComponent 操作,2)使用 SerializedObject 进行引用连接,3)场景/层次结构编辑和批量操作。不适用于文件 I/O 或脚本编写。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: uloop-execute-dynamic-code description: "Execute C# code dynamically in Unity Editor via uloop CLI. Use for editor automation: (1) Prefab/material wiring and AddComponent operations, (2) Reference wiring with SerializedObject, (3) 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 Description
--code string C# code to execute (direct statements, no class wrapper)
--compile-only boolean Compile without execution
--auto-qualify-unity-types-once boolean Auto-qualify Unity types

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/MINGW64/Git Bash '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

Examples

bash / zsh / MINGW64 / Git Bash

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: