unreal-sequencer-automation

Unreal Sequencer Automation

Version: 3.1.1 Last Updated: 2026-10-09 Dependencies: Unreal Engine 5.8+, UE 5.8 native MCP (HTTP, port 8000) Major Updates: UE 5.8 migration, camera cuts, channel initialization, ImagePlate 100%

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 DISCOVERIES

1. Camera Cut Tracks - SOLVED

The API that doesn't exist: add_camera_cut_track() - Use generic add_track() instead!

2. Transform Channels - SOLVED

Empty channels are NORMAL! Channels don't exist until you add the first keyframe.

3. ImagePlate Python API - DISCOVERED

BREAKING: ImagePlate DOES have Python API (get_plate(), set_image_plate())

---

QUICK START: Complete Animated Sequence

# Via mcp__ue58-mcp__execute_python_code
import unreal

# 1. Create Level Sequence
factory = unreal.LevelSequenceFactoryNew()
asset_tools = unreal.AssetToolsHelpers.get_asset_tools()

sequence = asset_tools.create_asset(
    asset_name="LS_MyAnimation",
    package_path="/Game/Cinematics",
    asset_class=unreal.LevelSequence,
    factory=factory
)

# 2. Get actor using modern API (not deprecated EditorLevelLibrary)
world = unreal.EditorLevelLibrary.get_editor_world()
actors = unreal.GameplayStatics.get_all_actors_of_class(world, unreal.StaticMeshActor)
actor = actors[0]

# 3. Add actor as possessable
binding = unreal.MovieSceneSequenceExtensions.add_possessable(sequence, actor)

# 4. Add transform track
track = binding.add_track(unreal.MovieScene3DTransformTrack)

# 5. Add section
section = track.add_section()
section.set_range(0, 300)

# 6. CRITICAL: Initialize channels by adding first key!
# Channels don't exist until you do this
location_z_channel = unreal.MovieSceneSectionExtensions.get_channel_by_name(
    section,
    "Location.Z"
)
location_z_channel.add_key(unreal.FrameNumber(0), 0.0)

# 7. Add remaining keyframes
location_z_channel.add_key(unreal.FrameNumber(150), 500.0)
location_z_channel.add_key(unreal.FrameNumber(300), 0.0)

print(f"Created sequence with {location_z_channel.get_num_keys()} keyframes!")