unreal-actor-operations

Unreal Actor Operations

Version: 2.0.2 Last Updated: 2026-09-08 Dependencies: Unreal Engine 5.8+, UE 5.8 native MCP (HTTP, port 8000), VibeUE plugin (optional) Context7 Validation: ACTOR_API_VALIDATION_REPORT.md (18/20 APIs validated)

Preflight first (2026-09-08): before the first build step of any approved plan, run the unreal-project-preflight skill (ue_preflight.py --live --features <list> --plan-block) so plugins and project settings this skill depends on are enabled in ONE restart. Mid-task "class not found / plugin not enabled" errors go back to that Step 0, never to a runtime toggle.

CRITICAL: MCP Connection Required

BEFORE any actor operations:

1. Verify UE editor is open with project loaded (MCP server runs inside the editor)
2. Native MCP auto-starts on port 8000 when bAutoStartServer=True in project config
3. All Python execution happens on game thread (synchronous)

Connection Test:

# Via mcp__ue58-mcp__execute_python_code
import unreal
print("Unreal Python API ready")
print(f"Editor world: {unreal.EditorLevelLibrary.get_editor_world()}")

---

QUICK START: Spawn Static Mesh Actor

Most common use case - copy and execute:

# Via mcp__ue58-mcp__execute_python_code
import unreal

# Spawn actor at world location
actor = unreal.EditorLevelLibrary.spawn_actor_from_class(
    unreal.StaticMeshActor,
    unreal.Vector(0, 0, 100),  # X, Y, Z
    unreal.Rotator(0, 0, 0)    # Pitch, Yaw, Roll
)

# Validate spawn succeeded
if actor is None:
    print("ERROR: Failed to spawn actor")
else:
    # Set mesh component
    mesh_comp = actor.static_mesh_component
    mesh = unreal.load_asset("/Engine/BasicShapes/Cube")
    mesh_comp.set_static_mesh(mesh)

    # Set actor label
    actor.set_actor_label("MyCube")

    # Set scale
    unreal.EditorLevelLibrary.set_actor_scale3d(
        actor,
        unreal.Vector(2.0, 2.0, 2.0)
    )

    print(f"SUCCESS: Spawned {actor.get_actor_label()}")

Expected Output:

SUCCESS: Spawned MyCube