| name | unreal-live-coding |
| description | Trigger Live Coding compilation via UCP. Use when the user asks to recompile C++ code, trigger live coding, hot reload C++ changes, or check compilation status in Unreal Engine. |
Unreal Live Coding
Trigger and manage Live Coding (runtime C++ recompilation) through UCP's call command. The Compile function uses deferred response — UCP.py will automatically wait for compilation to finish without blocking the UE editor or requiring polling.
Prerequisite: The unreal-client-protocol skill must be available, the UE editor must be running with UCP enabled, and Live Coding must be enabled in Editor Preferences (Windows only).
Custom Function Library
ULiveCodingOperationLibrary
CDO Path: /Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary
| Function | Params | Returns | Description |
|---|
Compile | (none) | FUCPDeferredResponse | Trigger Live Coding compile. Response is deferred — UCP.py waits until compilation finishes, then receives the result. |
IsCompiling | (none) | bool | Whether a Live Coding compile is in progress |
IsLiveCodingEnabled | (none) | bool | Whether Live Coding is enabled for the current session |
EnableLiveCoding | bEnable (bool) | bool | Enable or disable Live Coding for the current session |
Deferred Response
Compile returns FUCPDeferredResponse — a special UCP return type that enables non-blocking async execution:
- UCP.py sends the
Compile request
- UE starts compilation and immediately frees the game thread (no blocking)
- UCP.py keeps the TCP connection open, waiting for the response (no polling needed)
- When compilation finishes, UE pushes the result back to UCP.py
- UCP.py receives the result and returns it to the caller
Important: Set UE_TIMEOUT environment variable to a larger value (e.g. 120) before calling Compile, as compilation may take longer than the default 30-second timeout:
$env:UE_TIMEOUT = "120"
Examples
Trigger compilation (waits for completion):
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"Compile"}
Check if currently compiling:
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"IsCompiling"}
Check if Live Coding is enabled:
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"IsLiveCodingEnabled"}
Enable Live Coding:
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"EnableLiveCoding","params":{"bEnable":true}}
Common Patterns
Edit C++ and recompile
After modifying .cpp files, trigger Live Coding to apply changes without restarting the editor:
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"Compile"}
The response will contain {"status": "success"} when compilation succeeds.
Check availability before compiling
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"IsLiveCodingEnabled"}
If false, enable it first:
{"object":"/Script/UnrealClientProtocolEditor.Default__LiveCodingOperationLibrary","function":"EnableLiveCoding","params":{"bEnable":true}}
Live Coding Limitations
- Windows only — Live Coding is not available on other platforms
- Header file changes not supported — changes to
UCLASS, USTRUCT, UENUM, UFUNCTION declarations, or any changes in header files require a full editor restart
- Data layout changes — modifying struct/class member variables can cause crashes; only function body changes are safe
- New classes — adding entirely new C++ classes may require a full rebuild
.cpp body changes only — the safest use case is modifying function implementations in .cpp files
