unreal-vfx-automation

Unreal VFX Automation

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.

Production-ready automation for VFX workflows in Unreal Engine 5.8

Automates the 23-step manual process for foreground plate setup, image sequence management, and multi-shot production pipelines. Built on production-validated patterns from real VFX workflows.

---

Quick Start

Basic Foreground Plate Setup

# Via mcp__ue58-mcp__execute_python_code
# Run the ForegroundPlateSetup script directly in UE Python
import unreal
import sys
sys.path.append("/Game/Scripts")  # Or wherever ForegroundPlateSetup.py lives

# Or execute the setup inline:
# 1. Create ImgMediaSource
asset_tools = unreal.AssetToolsHelpers.get_asset_tools()
media_source = asset_tools.create_asset(
    "MS_Shot001_FG", "/Game/Media",
    unreal.ImgMediaSource, unreal.ImgMediaSourceFactoryNew()
)
media_source.set_editor_property('sequence_path',
    unreal.DirectoryPath("D:/Plates/Shot001"))

# 2. Create MediaPlayer + MediaTexture
player = asset_tools.create_asset(
    "MP_Shot001_FG", "/Game/Media",
    unreal.MediaPlayer, unreal.MediaPlayerFactoryNew()
)

# 3. Configure and connect...
print("Foreground plate setup complete")

Result: Complete setup in ~500ms:

• ImgMediaSource created
• MediaPlayer + MediaTexture configured
• VFX-optimized material with alpha support
• ImagePlate component attached to camera
• MediaPlayer auto-plays for immediate preview

Multi-Shot Production (Master Material + Instances)

Pattern: One master material -> Many instances (scalable to 50+ shots)

# Shot 1 - Creates master material (via execute_python_code)
# Shot 2+ - Creates material instances referencing master