uloop compile

Execute Unity project compilation.

Usage

uloop compile [--force-recompile] [--wait-for-domain-reload]

Parameters

Parameter	Type	Description
--force-recompile	boolean	Force full recompilation (triggers Domain Reload)
--wait-for-domain-reload	boolean	Wait until Domain Reload completes before returning

Global Options

Option	Description
--project-path <path>	Target a specific Unity project (mutually exclusive with --port). Path resolution follows the same rules as cd — absolute paths are used as-is, relative paths are resolved from cwd.
-p, --port <port>	Specify Unity TCP port directly (mutually exclusive with --project-path).

Examples

# 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

Output

Returns JSON:

• Success: boolean
• ErrorCount: number
• WarningCount: number

Troubleshooting

If CLI hangs or shows "Unity is busy" errors after compilation, stale lock files may be preventing connection. Run the following to clean them up:

uloop fix

This removes any leftover lock files (compiling.lock, domainreload.lock, serverstarting.lock) from the Unity project's Temp directory.