// Compile the Unity project and report errors/warnings. Use after C# edits or when a full Domain Reload compile is needed.
| name | uloop-compile |
| description | Compile the Unity project and report errors/warnings. Use after C# edits or when a full Domain Reload compile is needed. |
Execute Unity project compilation.
uloop compile [--force-recompile] [--wait-for-domain-reload]
| Parameter | Type | Default | Description |
|---|---|---|---|
--force-recompile | boolean | false | Force full recompilation (triggers Domain Reload) |
--wait-for-domain-reload | boolean | false | Wait until Domain Reload completes before returning |
| Option | Description |
|---|---|
--project-path <path> | Optional. Use only when the target Unity project is not the current directory. |
# Check compilation
uloop compile
# Force full recompilation
uloop compile --force-recompile
# Force recompilation and wait for Domain Reload completion
uloop compile --force-recompile true --wait-for-domain-reload true
# Wait for Domain Reload completion even without force recompilation
uloop compile --force-recompile false --wait-for-domain-reload true
Returns JSON:
Success: booleanErrorCount: numberWarningCount: numberDiagnose the failure mode before retrying.
Stale lock files (CLI hangs or shows "Unity is busy" while Unity Editor is running):
uloop fix
This removes any leftover lock files (compiling.lock, domainreload.lock, serverstarting.lock) from the Unity project's Temp directory. Then retry uloop compile.
Unity Editor not running (CLI returns a connection failure and no Unity process is alive):
uloop launch
uloop launch auto-detects the project at the current working directory and opens it in the matching Unity Editor version. After Unity finishes launching, retry uloop compile.
Use when Unity Editor is not running or needs a clean restart.
Clear Unity Console entries. Use before compile, tests, or debugging when stale logs would hide the current result.
Control Unity Editor Play Mode. Use to start, stop, or pause Play Mode for runtime behavior checks and frame inspection.
Execute C# with Unity APIs when existing uloop tools cannot inspect or edit enough. Use for scene, prefab, SerializedObject, AssetDatabase refresh/.meta generation, menu, or PlayMode automation.
Find or inspect Unity GameObjects, especially objects the user currently selected in the Hierarchy. Use for details, components, tags, layers, or name/path searches.
Get the Unity scene hierarchy as a structured tree. Use for parent-child structure, descendants, roots, or subtrees under objects the user currently selected.