unreal-engine-mcp-server 0.4.6 → 0.5.0

package/docs/editor-plugin-extension.md

@@ -0,0 +1,370 @@
+# MCP Automation Bridge Plugin
+
+The MCP Automation Bridge is a production-ready Unreal Editor plugin that enables direct communication between the MCP server and Unreal Engine, providing **100% native C++ implementations** for all automation tasks. This document describes the current implementation and future roadmap.
+
+## Goals
+- **Direct SCS Access** – expose Blueprint SimpleConstructionScript mutations through a curated C++ API that the MCP server can call.
+- **Typed Property Marshaling** – relay incoming JSON payloads through Unreal's `FProperty` system so class/enum/soft object references resolve without manual string coercion.
+- **Asset Lifecycle Helpers** – wrap save/move/delete flows with redirector fix-up, source control hooks, and safety prompts suppressed via automation policies.
+- **Modal Dialog Mediation** – surface blocking dialogs to the MCP server with explicit continue/cancel channels instead of stalling automation.
+- **Native-Only Architecture** – all operations implemented in C++ without Python dependencies for maximum reliability and performance.
+
+## Architecture Sketch
+- Editor plugin registers a `UMcpAutomationBridge` subsystem.
+- Subsystem subscribes to a local WebSocket or named pipe opened by the Node MCP server when it needs elevated actions.
+- Each elevated command includes a capability token so the plugin can enforce an allow-list (exposed through project settings) and fail gracefully if disabled.
+- Results are serialized back to the MCP server with structured warnings so the client can still prompt the user when manual intervention is required.
+
+## Plugin Architecture (Current: v0.6.0)
+
+### Core Components
+- **Plugin Location**: `plugins/McpAutomationBridge/` (source) and `Public/McpAutomationBridge/` (distribution)
+- **Module Type**: Editor-only subsystem (`UEditorSubsystem`)
+- **Main Class**: `UMcpAutomationBridgeSubsystem` - manages WebSocket connections, request routing, and automation execution
+- **WebSocket Implementation**: `FMcpBridgeWebSocket` - custom lightweight WebSocket client (no external dependencies)
+- **Settings**: `UMcpAutomationBridgeSettings` - configurable via **Project Settings ▸ Plugins ▸ MCP Automation Bridge**
+
+### Connection Management
+- **WebSocket Server Mode**: Plugin connects TO the MCP server's WebSocket listener (default: `ws://127.0.0.1:8091`)
+- **Handshake Protocol**: `bridge_hello` → capability token validation → `bridge_ack`
+- **Reconnection**: Automatic with exponential backoff (configurable delay, 5s default)
+- **Heartbeat**: Optional heartbeat tracking for connection health monitoring
+- **Capability Token**: Optional security layer for authentication
+- **Multi-Port Support**: Can connect to multiple server ports simultaneously
+
+### Request Processing
+- **Thread-Safe Queue**: Incoming requests queued and processed sequentially on game thread
+- **Telemetry**: Tracks success/failure rates, execution times, and action statistics
+- **Error Handling**: Structured error responses with error codes and retry flags
+- **Timeout Management**: Configurable timeouts for long-running operations
+
+## Server Integration (0.1.0)
+- `src/automation-bridge.ts` spins up a lightweight WebSocket server (default `ws://127.0.0.1:8091`) guarded by an optional capability token.
+- Handshake flow: editor sends `bridge_hello` → server validates capability token → server responds with `bridge_ack` and caches the socket for future elevated commands.
+- Environment flags: `MCP_AUTOMATION_HOST`, `MCP_AUTOMATION_PORT`, `MCP_AUTOMATION_CAPABILITY_TOKEN`, and `MCP_AUTOMATION_CLIENT_MODE` allow operators to relocate or disable the listener without code changes.
+- Health endpoint (`ue://health`) now surfaces bridge connectivity status so MCP clients can confirm when the plugin is online.
+
+## Implemented Actions (Current)
+
+### 1. Asset Operations (`HandleAssetAction`)
+✅ **Fully Implemented** - Native C++ using UE Asset Tools
+- `import_asset_deferred` - Native `UAssetImportTask` with FBX/texture support
+- `create_material` - `UMaterialFactoryNew` for material creation
+- `create_material_instance` - Material instance creation with parameter overrides
+- `duplicate_asset` - Asset duplication with overwrite control
+- `rename_asset` - Asset renaming with conflict detection
+- `move_asset` - Asset moving with optional redirector fixup
+- `delete_assets` - Bulk asset deletion with dependency handling
+- `list` - Asset Registry directory listing with filtering
+- `create_folder` - Content folder creation
+- `get_dependencies` - Asset dependency graph traversal
+- `create_thumbnail` - Thumbnail generation
+- `set_tags` - Asset metadata tagging
+- `generate_report` - Asset reports
+- `validate` - Asset existence validation
+- `get_source_control_state` - Check checkout/revision status
+- `analyze_graph` - Deep dependency analysis (WASM-accelerated)
+
+### 2. Editor Function Execution (`HandleExecuteEditorFunction`)
+✅ **Fully Implemented** - Native subsystem operations
+- `execute_console_command` - Direct `GEditor->Exec()` console command execution
+- `GET_ALL_ACTORS` - `UEditorActorSubsystem::GetAllLevelActors()`
+- `SPAWN_ACTOR` - `UEditorActorSubsystem::SpawnActorFromClass()`
+- `DELETE_ACTOR` - `UEditorActorSubsystem::DestroyActor()`
+- `ASSET_EXISTS` - `UEditorAssetLibrary::DoesAssetExist()`
+- `SET_VIEWPORT_CAMERA` - `UUnrealEditorSubsystem::SetLevelViewportCameraInfo()`
+- `CREATE_LEVEL` - Level creation via subsystem
+- `LOAD_LEVEL` - Level loading
+- `SAVE_LEVEL` - Level saving
+- `BUILD_LIGHTING` - `ULevelEditorSubsystem::BuildLightMaps()`
+- `LIST_ACTOR_COMPONENTS` - Enumerate components for any editor actor via `UEditorActorSubsystem`
+- `RESOLVE_OBJECT` - Resolve assets or classes and surface best-effort metadata for inspection tools
+- `SAVE_DIRTY_PACKAGES` / `SAVE_ALL_DIRTY_PACKAGES` - Trigger native dirty-package saves through `UEditorLoadingAndSavingUtils`
+- `SAVE_ASSET` - Persist a specific asset path using throttled `UEditorAssetLibrary` helpers
+- `SET_BLUEPRINT_DEFAULT` - Routes to native blueprint default editing without Python fallbacks
+
+### 3. Property Operations (`HandleSetObjectProperty`, `HandleGetObjectProperty`)
+✅ **Fully Implemented** - Typed `FProperty` marshaling
+- **set_object_property** - JSON → `FProperty` conversion with type safety
+- **get_object_property** - `FProperty` → JSON serialization
+- **Array Operations**: append, remove, insert, get_element, set_element, clear
+- **Map Operations**: set_value, get_value, remove_key, has_key, get_keys, clear
+- **Set Operations**: add, remove, contains, clear
+- **Supported Types**: primitives, enums, objects, soft object paths, structs (Vector/Rotator), arrays, maps, sets
+
+### 4. Blueprint Operations (`HandleBlueprintAction`)
+⚠️ **Partially Implemented** - SCS modification in progress
+- Blueprint asset creation ✅
+- SimpleConstructionScript (SCS) node manipulation ⚠️
+- Component addition to blueprints ⚠️
+- Blueprint compilation and saving ✅
+- CDO (Class Default Object) property modification ✅
+- Blueprint default overrides via `SET_BLUEPRINT_DEFAULT` requests ✅
+
+### 5. Sequence/Sequencer Operations
+✅ **Fully Implemented** - Level Sequence Editor integration
+- **HandleSequenceAction** - Sequence creation and management
+- **HandleAddSequencerKeyframe** - Keyframe operations
+- **HandleManageSequencerTrack** - Track management
+- **HandleAddCameraTrack** - Camera track addition
+- **HandleAddAnimationTrack** - Animation track addition
+- **HandleAddTransformTrack** - Transform track addition
+
+### 6. Effect Operations (`HandleEffectAction`)
+✅ **Fully Implemented** - Niagara and debug visualization
+- Niagara system creation (`UNiagaraSystemFactoryNew`)
+- Niagara emitter creation
+- Spawn Niagara actors in level
+- Modify Niagara user parameters
+- Debug shape drawing (lines, boxes, spheres, arrows)
+- Dynamic light spawning
+- Effect cleanup operations
+
+### 7. Animation & Physics (`HandleAnimationPhysicsAction`)
+✅ **Fully Implemented** - Animation blueprint and physics setup
+- **HandleCreateAnimBlueprint** - Animation blueprint creation
+- **HandlePlayAnimMontage** - Montage playback control
+- **HandleSetupRagdoll** - Ragdoll physics configuration
+- Physics asset manipulation
+- Skeletal mesh animation control
+
+### 8. Environment Building (`HandleBuildEnvironmentAction`)
+✅ **Fully Implemented** - Landscape and foliage tools
+- **HandleCreateLandscape** - Landscape actor creation
+- **HandleEditLandscape** - Landscape editing dispatcher
+- **HandleModifyHeightmap** - Heightmap sculpting
+- **HandlePaintLandscapeLayer** - Layer painting
+- **HandlePaintFoliage** - Foliage painting with density control
+- **HandleRemoveFoliage** - Foliage removal
+- **HandleGetFoliageInstances** - Foliage instance queries
+
+### 9. Material Graph Operations (`HandleCreateMaterialNodes`)
+✅ **Fully Implemented** - Material editor graph manipulation
+- **HandleAddMaterialTextureSample** - Add texture sample nodes
+- **HandleAddMaterialExpression** - Add material expression nodes
+- Material graph node connections
+- Material parameter setup
+
+### 10. Asset Workflow (`HandleSourceControl*`, `HandleFixupRedirectors`, etc.)
+✅ **Fully Implemented** - Production asset pipeline support
+- **HandleSourceControlCheckout** - Perforce/SVN checkout
+- **HandleSourceControlSubmit** - Perforce/SVN submit
+- **HandleFixupRedirectors** - Redirector cleanup after moves
+- **HandleBulkRenameAssets** - Batch asset renaming
+- **HandleBulkDeleteAssets** - Batch asset deletion
+- **HandleGenerateThumbnail** - Thumbnail generation
+
+### 11. Actor & Editor Control
+✅ **Fully Implemented** - Viewport and actor manipulation
+- PIE (Play In Editor) control - `ULevelEditorSubsystem::EditorPlaySimulate()`
+- Camera positioning and rotation - `UUnrealEditorSubsystem::SetLevelViewportCameraInfo()`
+- View mode changes - Native `GEditor->Exec()` with safety validation
+- Actor spawning with class resolution
+- Actor deletion with label matching
+- Actor property modification
+
+### 12. Python Execution (`HandleExecuteEditorPython`)
+❌ **REMOVED** - Python execution is no longer supported
+- All automation is now implemented natively in C++
+- `execute_editor_python` action returns error: "Python execution is no longer supported"
+- Improves security, reliability, and performance
+- **Migration**: Use native automation actions instead
+
+## Tool Coverage Matrix (Updated)
+
+| Consolidated Tool | Actions | Bridge Status | Notes |
+|-------------------|---------|---------------|-------|
+| **manage_asset** | `list` | ✅ Native | Asset Registry native listing |
+| | `import` | ✅ Native | `UAssetImportTask` FBX/texture import |
+| | `create_material` | ✅ Native | `UMaterialFactoryNew` native creation |
+| | `create_material_instance` | ✅ Native | Native material instance factory |
+| | `duplicate` / `rename` / `move` | ✅ Native | `UEditorAssetLibrary` + `AssetTools` |
+| | `delete` | ✅ Native | Bulk deletion with dependency handling |
+| **control_actor** | `spawn` | ✅ Native | `UEditorActorSubsystem::SpawnActorFromClass()` |
+| | `delete` | ✅ Native | `UEditorActorSubsystem::DestroyActor()` |
+| | `apply_force` | 🔧 Planned | Physics forces native implementation pending |
+| **control_editor** | `play` / `stop` / `pause` | ✅ Native | `ULevelEditorSubsystem` PIE control |
+| | `set_camera` | ✅ Native | `UUnrealEditorSubsystem::SetLevelViewportCameraInfo()` |
+| | `set_view_mode` | ✅ Native | Safe viewmode validation + `GEditor->Exec()` |
+| | `console_command` | ✅ Native | `GEditor->Exec()` direct execution |
+| **manage_level** | `load` / `save` / `stream` | ✅ Native | Editor function handlers for level ops |
+| | `create_level` | ✅ Native | Native `CREATE_LEVEL` function |
+| | `create_light` | ✅ Native | `SPAWN_ACTOR` with light class |
+| | `build_lighting` | ✅ Native | `ULevelEditorSubsystem::BuildLightMaps()` |
+| **animation_physics** | `create_animation_bp` | ✅ Native | Animation blueprint factory |
+| | `play_montage` | ✅ Native | Native montage playback control |
+| | `setup_ragdoll` | ✅ Native | Ragdoll physics configuration |
+| | `configure_vehicle` | ⚠️ Partial | Complex vehicle setup in progress |
+| **create_effect** | `niagara` | ✅ Native | `UNiagaraSystemFactoryNew` native creation |
+| | `spawn_niagara` | ✅ Native | Native Niagara actor spawning |
+| | `debug_shape` | ✅ Native | Debug line/box/sphere drawing |
+| | `dynamic_light` | ✅ Native | Dynamic light spawning |
+| **manage_blueprint** | `create` | ✅ Native | Blueprint asset creation |
+| | `add_component` | ✅ Native | SCS manipulation via native APIs; UE 5.7+ SubobjectDataInterface support added |
+| | `edit_defaults` | ✅ Native | CDO property modification |
+| **build_environment** | `create_landscape` | ✅ Native | Landscape actor creation |
+| | `sculpt` / `paint` | ✅ Native | Heightmap/layer editing |
+| | `add_foliage` | ✅ Native | Foliage painting with density control |
+| **system_control** | `profile` / `show_fps` | ✅ Native | Console command execution |
+| | `set_quality` | ✅ Native | Quality settings via console |
+| | `screenshot` | ✅ Native | Screenshot capture commands |
+| **console_command** | (all) | ✅ Native | Direct `GEditor->Exec()` with safety filtering |
+| **execute_python** | (all) | ❌ Removed | Python execution removed; use native actions |
+| **manage_sequence** | `create` / `add_track` | ✅ Native | Level Sequence Editor native operations |
+| | `keyframe` | ✅ Native | Native keyframe manipulation |
+| **inspect** | `get_property` | ✅ Native | `FProperty` → JSON serialization |
+| | `set_property` | ✅ Native | JSON → `FProperty` typed marshaling |
+| | `list` | ✅ Native | Actor/asset listing via subsystems |
+| **manage_audio** | `create_sound_cue` | ✅ Native | Sound Cue asset creation |
+| | `play_sound_at_location` | ✅ Native | 3D spatial sound playback |
+| | `create_audio_component` | ✅ Native | Audio component creation |
+| **manage_behavior_tree** | `add_node` | ✅ Native | Behavior Tree node creation |
+| | `connect_nodes` | ✅ Native | Node connection management |
+| | `set_node_properties` | ✅ Native | Node property editing |
+
+**Legend:**
+- ✅ **Native** = Fully implemented in C++ plugin
+- ⚠️ **Partial** = Some operations implemented; work in progress
+- 🔧 **Planned** = Designed but not yet implemented
+- ❌ **Removed** = Feature removed (Python execution)
+
+## Current Version Status (v0.6.0)
+
+### ✅ Completed Features
+1. ✔️ **WebSocket Transport** - Custom lightweight WebSocket client with no external dependencies
+2. ✔️ **Asset Operations** - Complete native asset pipeline (import, create, modify, delete)
+3. ✔️ **Property Marshaling** - Full `FProperty` system integration with type safety
+4. ✔️ **Editor Functions** - Native implementations of common editor operations
+5. ✔️ **Sequence/Animation** - Level Sequence Editor and animation blueprint integration
+6. ✔️ **Environment Tools** - Landscape and foliage manipulation
+7. ✔️ **Material Graph** - Material node creation and editing
+8. ✔️ **Source Control** - Perforce/SVN integration
+9. ✔️ **Telemetry** - Request tracking and performance metrics
+10. ✔️ **Security** - Capability token authentication
+11. ✔️ **Camera Control** - Native viewport camera positioning via `SetLevelViewportCameraInfo()`
+12. ✔️ **Python-Free Architecture** - 100% native C++ implementation
+
+### ⚠️ In Progress
+1. **Blueprint SCS Enhancements** - Improving UE 5.6+ SubobjectData subsystem compatibility
+   - Native component addition and modification (UE 5.7+ supported)
+   - Full SCS tree manipulation
+2. **Modal Dialog Interception** - Handling blocking editor dialogs
+   - Asset save prompts
+   - Package checkout dialogs
+
+### 📅 Roadmap (v0.7.0+)
+
+#### High Priority
+1. **Complete Blueprint SCS API** - Finalize SimpleConstructionScript manipulation for UE 5.6+
+   - Leverage `SubobjectData` subsystem when available
+   - Fallback to legacy reflection-based approach for older engines
+   - Native component property editing
+
+2. **Physics System Integration** - Native physics force application
+   - `UPrimitiveComponent::AddForce()` wrappers
+   - Physics constraint manipulation
+   - Impulse and torque application
+   - Vehicle physics configuration
+
+3. **Modal Dialog Mediation** - Intercept blocking dialogs
+   - Asset save prompts
+   - Package checkout dialogs
+   - Build lighting confirmation
+   - Timeout-based fallback responses
+
+#### Medium Priority
+4. **Hot Reload Support** - Update plugin without editor restart
+   - Dynamic handler registration
+   - State preservation across reloads
+
+5. **Enhanced Telemetry** - Expanded metrics and diagnostics
+   - Per-action success/failure rates
+   - Performance profiling data
+   - Connection health history
+
+6. **Batch Operations** - Multi-operation transactions
+   - Transactional asset workflows
+   - Undo/redo support
+   - Rollback on failure
+
+7. **Advanced Security** - Enhanced authentication
+   - Session token support
+   - Per-action capability tokens
+   - Client certificate validation
+
+#### Low Priority
+8. **Marketplace Distribution** - Packaged plugin distribution
+   - Pre-compiled binaries for multiple UE versions
+   - Simplified installation process
+   - Documentation and samples
+
+9. **Blueprint Visual Editing** - Direct Blueprint graph manipulation
+   - Node creation and connection
+   - Function/macro creation
+   - Event graph editing
+
+## Dependencies
+
+### Required Unreal Engine Modules
+- **Core** - Base engine functionality
+- **CoreUObject** - UObject system
+- **Engine** - Runtime engine
+- **UnrealEd** - Editor subsystems
+- **EditorScriptingUtilities** - Editor scripting APIs
+- **AssetTools** - Asset manipulation
+- **AssetRegistry** - Asset database
+- **LevelEditor** - Level editing subsystems
+- **BlueprintGraph** - Blueprint editing
+- **LevelSequence** / **LevelSequenceEditor** - Sequencer
+- **Landscape** / **LandscapeEditor** - Terrain tools
+- **Niagara** / **NiagaraEditor** - VFX system
+- **MaterialEditor** - Material editing
+
+### Optional Modules (Auto-Detected)
+- **SubobjectDataInterface** - UE 5.7+ Blueprint SCS subsystem
+- **ControlRig** - Animation and physics tools
+- **SourceControl** - Version control integration
+
+## Installation & Configuration
+
+### Plugin Installation
+1. Copy `Public/McpAutomationBridge/` to your project's `Plugins/` directory
+2. Regenerate project files
+3. Enable plugin via **Edit ▸ Plugins ▸ MCP Automation Bridge**
+4. Restart editor
+
+### Configuration (Project Settings ▸ Plugins ▸ MCP Automation Bridge)
+- **Server Host**: MCP server address (default: `127.0.0.1`)
+- **Server Port**: WebSocket port (default: `8091`)
+- **Capability Token**: Optional security token
+- **Reconnect Enabled**: Auto-reconnect on disconnect
+- **Reconnect Delay**: Delay between reconnection attempts (default: 5s)
+- **Heartbeat Timeout**: Connection health timeout
+- **Ticker Interval**: Subsystem tick frequency (default: 0.25s)
+
+### Environment Variables (Override Settings)
+- `MCP_AUTOMATION_HOST` - Server host override
+- `MCP_AUTOMATION_PORT` - Server port override
+- `MCP_AUTOMATION_CAPABILITY_TOKEN` - Security token
+- `MCP_IGNORE_SUBOBJECTDATA` - Disable SubobjectData detection
+- `MCP_FORCE_SUBOBJECTDATA` - Force SubobjectData module linkage
+
+### Deprecated Settings (Removed)
+- ~~`MCP_ALLOW_PYTHON_FALLBACKS`~~ - Python execution has been removed
+- ~~`Allow Python Fallbacks`~~ - Setting removed from project settings
+- ~~`bAllowPythonFallbacks`~~ - Configuration property removed
+- ~~`bAllowAllPythonFallbacks`~~ - Configuration property removed
+
+## Contributions
+
+Contributions welcome! Please open an issue or discussion before starting major work to ensure alignment with the roadmap.
+
+### Development Guidelines
+- Follow Unreal Engine C++ coding standards
+- Add handler functions to appropriate `McpAutomationBridge_*Handlers.cpp` files
+- Register new handlers in `ProcessAutomationRequest()`
+- Update `McpAutomationBridgeSubsystem.h` with handler declarations
+- Add comprehensive error handling with structured error codes
+- Test across multiple UE versions (5.0-5.7)
+- Document new actions in this file
+- **No Python dependencies** - All new features must be native C++

package/docs/handler-mapping.md

@@ -0,0 +1,242 @@
+# Handler Mappings
+
+This document maps the TypeScript tool definitions to their corresponding C++ handlers in the Unreal Engine plugin.
+
+## 1. Asset Manager (`manage_asset`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `list` | `McpAutomationBridge_AssetQueryHandlers.cpp` | `HandleAssetQueryAction` | |
+| `search_assets` | `McpAutomationBridge_AssetQueryHandlers.cpp` | `HandleAssetQueryAction` | |
+| `import` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `duplicate` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `rename` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `move` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `delete` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `delete_assets` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleBulkDeleteAssets` | |
+| `create_folder` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `get_asset` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleGetAsset` | |
+| `get_dependencies` | `McpAutomationBridge_AssetQueryHandlers.cpp` | `HandleGetAssetDependencies` | |
+| `get_source_control_state` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleSourceControlCheckout` | |
+| `analyze_graph` | `McpAutomationBridge_AssetQueryHandlers.cpp` | `HandleGetAssetReferences` | |
+| `create_thumbnail` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleGenerateThumbnail` | |
+| `set_tags` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `validate` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `fixup_redirectors` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleFixupRedirectors` | |
+| `generate_report` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `create_material` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `create_material_instance` | `McpAutomationBridge_AssetWorkflowHandlers.cpp` | `HandleAssetAction` | |
+| `create_render_target` | `McpAutomationBridge_RenderHandlers.cpp` | `HandleRenderAction` | |
+| `nanite_rebuild_mesh` | `McpAutomationBridge_RenderHandlers.cpp` | `HandleRenderAction` | |
+| `add_material_node` | `McpAutomationBridge_MaterialGraphHandlers.cpp` | `HandleAddMaterialExpression` | |
+| `connect_material_pins` | `McpAutomationBridge_MaterialGraphHandlers.cpp` | `HandleCreateMaterialNodes` | |
+| `remove_material_node` | `McpAutomationBridge_MaterialGraphHandlers.cpp` | `HandleCreateMaterialNodes` | |
+| `add_bt_node` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+| `connect_bt_nodes` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+
+## 2. Blueprint Manager (`manage_blueprint`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create` | `McpAutomationBridge_BlueprintCreationHandlers.cpp` | `HandleBlueprintAction` | |
+| `get_blueprint` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | |
+| `compile` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | |
+| `add_component` | `McpAutomationBridge_SCSHandlers.cpp` | `HandleBlueprintAction` | Uses `SubobjectData` in UE 5.7+ |
+| `set_default` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | |
+| `modify_scs` | `McpAutomationBridge_SCSHandlers.cpp` | `HandleBlueprintAction` | |
+| `get_scs` | `McpAutomationBridge_SCSHandlers.cpp` | `HandleBlueprintAction` | |
+| `create_node` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `delete_node` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `connect_pins` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `break_pin_links` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `set_node_property` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+
+## 17. Input Manager (`manage_input`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create_input_action` | `McpAutomationBridge_InputHandlers.cpp` | `HandleInputAction` | |
+| `create_input_mapping_context` | `McpAutomationBridge_InputHandlers.cpp` | `HandleInputAction` | |
+| `add_mapping` | `McpAutomationBridge_InputHandlers.cpp` | `HandleInputAction` | |
+| `remove_mapping` | `McpAutomationBridge_InputHandlers.cpp` | `HandleInputAction` | |
+| `add_variable` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | |
+| `add_function` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | |
+| `add_event` | `McpAutomationBridge_BlueprintHandlers.cpp` | `HandleBlueprintAction` | Supports custom & standard events |
+
+## 3. Actor Control (`control_actor`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `spawn` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `spawn_blueprint` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `delete` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `delete_by_tag` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `duplicate` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `apply_force` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `set_transform` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `get_transform` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `set_visibility` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `add_component` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | Runtime component addition |
+| `add_tag` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `find_by_tag` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `list` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `attach` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `detach` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+
+## 4. Editor Control (`control_editor`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `play` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleControlEditorAction` | |
+| `stop` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleControlEditorAction` | |
+| `set_camera` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleControlEditorAction` | |
+| `console_command` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleConsoleCommandAction` | |
+| `screenshot` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleControlEditorAction` | |
+| `simulate_input` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | |
+| `create_bookmark` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleControlEditorAction` | |
+
+## 5. Level Manager (`manage_level`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `load` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleLevelAction` | |
+| `save` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleLevelAction` | |
+| `create_level` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleLevelAction` | |
+| `export_level` | `McpAutomationBridge_LevelHandlers.cpp` | `HandleLevelAction` | |
+| `import_level` | `McpAutomationBridge_LevelHandlers.cpp` | `HandleLevelAction` | |
+| `load_cells` | `McpAutomationBridge_WorldPartitionHandlers.cpp` | `HandleWorldPartitionAction` | |
+| `set_datalayer` | `McpAutomationBridge_WorldPartitionHandlers.cpp` | `HandleWorldPartitionAction` | |
+
+## 6. Lighting Manager (`manage_lighting`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `spawn_light` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `spawn_sky_light` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `build_lighting` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `ensure_single_sky_light` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `create_lightmass_volume` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `setup_volumetric_fog` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `create_lighting_enabled_level` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `setup_global_illumination` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `configure_shadows` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `set_exposure` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+| `set_ambient_occlusion` | `McpAutomationBridge_LightingHandlers.cpp` | `HandleLightingAction` | |
+
+## 7. Performance Manager (`manage_performance`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `generate_memory_report` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `configure_texture_streaming` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `merge_actors` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `start_profiling` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `stop_profiling` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `show_fps` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `show_stats` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `set_scalability` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `set_resolution_scale` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `set_vsync` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `set_frame_rate_limit` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `configure_nanite` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+| `configure_lod` | `McpAutomationBridge_PerformanceHandlers.cpp` | `HandlePerformanceAction` | |
+
+## 8. Animation & Physics (`animation_physics`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create_animation_bp` | `McpAutomationBridge_AnimationHandlers.cpp` | `HandleCreateAnimBlueprint` | |
+| `play_montage` | `McpAutomationBridge_AnimationHandlers.cpp` | `HandlePlayAnimMontage` | |
+| `setup_ragdoll` | `McpAutomationBridge_AnimationHandlers.cpp` | `HandleSetupRagdoll` | |
+| `configure_vehicle` | `McpAutomationBridge_AnimationHandlers.cpp` | `HandleAnimationPhysicsAction` | |
+
+## 9. Effects Manager (`manage_effect`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `niagara` | `McpAutomationBridge_EffectHandlers.cpp` | `HandleEffectAction` | |
+| `spawn_niagara` | `McpAutomationBridge_EffectHandlers.cpp` | `HandleSpawnNiagaraActor` | |
+| `debug_shape` | `McpAutomationBridge_EffectHandlers.cpp` | `HandleEffectAction` | |
+| `create_niagara_system` | `McpAutomationBridge_EffectHandlers.cpp` | `HandleCreateNiagaraSystem` | |
+| `create_niagara_emitter` | `McpAutomationBridge_EffectHandlers.cpp` | `HandleCreateNiagaraEmitter` | |
+| `add_niagara_module` | `McpAutomationBridge_NiagaraGraphHandlers.cpp` | `HandleNiagaraGraphAction` | |
+
+## 10. Environment Builder (`build_environment`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create_landscape` | `McpAutomationBridge_LandscapeHandlers.cpp` | `HandleCreateLandscape` | |
+| `sculpt` | `McpAutomationBridge_LandscapeHandlers.cpp` | `HandleSculptLandscape` | |
+| `paint_foliage` | `McpAutomationBridge_FoliageHandlers.cpp` | `HandlePaintFoliage` | |
+| `add_foliage_instances` | `McpAutomationBridge_FoliageHandlers.cpp` | `HandleAddFoliageInstances` | |
+| `get_foliage_instances` | `McpAutomationBridge_FoliageHandlers.cpp` | `HandleGetFoliageInstances` | |
+| `remove_foliage` | `McpAutomationBridge_FoliageHandlers.cpp` | `HandleRemoveFoliage` | |
+| `create_procedural_terrain` | `McpAutomationBridge_EnvironmentHandlers.cpp` | `HandleCreateProceduralTerrain` | |
+
+## 11. System Control (`system_control`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `execute_command` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleExecuteEditorFunction` | |
+| `console_command` | `McpAutomationBridge_EditorFunctionHandlers.cpp` | `HandleConsoleCommandAction` | |
+| `run_ubt` | *None* | *None* | Handled in TypeScript (`child_process`) |
+| `run_tests` | `McpAutomationBridge_TestHandlers.cpp` | `HandleTestAction` | |
+| `subscribe` | `McpAutomationBridge_LogHandlers.cpp` | `HandleLogAction` | |
+| `unsubscribe` | `McpAutomationBridge_LogHandlers.cpp` | `HandleLogAction` | |
+| `spawn_category` | `McpAutomationBridge_DebugHandlers.cpp` | `HandleDebugAction` | |
+| `start_session` | `McpAutomationBridge_InsightsHandlers.cpp` | `HandleInsightsAction` | |
+| `lumen_update_scene` | `McpAutomationBridge_RenderHandlers.cpp` | `HandleRenderAction` | |
+| `set_project_setting` | `McpAutomationBridge_EnvironmentHandlers.cpp` | `HandleSystemControlAction` | |
+| `create_hud` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | Sub-action of `system_control` |
+| `set_widget_text` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | Sub-action of `system_control` |
+| `set_widget_image` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | Sub-action of `system_control` |
+| `set_widget_visibility` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | Sub-action of `system_control` |
+| `remove_widget_from_viewport` | `McpAutomationBridge_UiHandlers.cpp` | `HandleUiAction` | Sub-action of `system_control` |
+
+## 12. Sequencer (`manage_sequence`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create` | `McpAutomationBridge_SequenceHandlers.cpp` | `HandleSequenceAction` | |
+| `add_actor` | `McpAutomationBridge_SequenceHandlers.cpp` | `HandleSequenceAction` | |
+| `play` | `McpAutomationBridge_SequenceHandlers.cpp` | `HandleSequenceAction` | |
+| `add_keyframe` | `McpAutomationBridge_SequencerHandlers.cpp` | `HandleAddSequencerKeyframe` | |
+| `add_camera` | `McpAutomationBridge_SequenceHandlers.cpp` | `HandleAddCameraTrack` | |
+
+## 13. Introspection (`inspect`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `inspect_object` | `McpAutomationBridge_PropertyHandlers.cpp` | `HandleInspectAction` | |
+| `set_property` | `McpAutomationBridge_PropertyHandlers.cpp` | `HandleSetObjectProperty` | |
+| `get_property` | `McpAutomationBridge_PropertyHandlers.cpp` | `HandleGetObjectProperty` | |
+| `get_components` | `McpAutomationBridge_ControlHandlers.cpp` | `HandleControlActorAction` | |
+| `list_objects` | `McpAutomationBridge_PropertyHandlers.cpp` | `HandleInspectAction` | |
+
+## 14. Audio Manager (`manage_audio`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create_sound_cue` | `McpAutomationBridge_AudioHandlers.cpp` | `HandleAudioAction` | |
+| `play_sound_at_location` | `McpAutomationBridge_AudioHandlers.cpp` | `HandleAudioAction` | |
+| `create_audio_component` | `McpAutomationBridge_AudioHandlers.cpp` | `HandleAudioAction` | |
+
+## 15. Behavior Tree Manager (`manage_behavior_tree`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `add_node` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+| `connect_nodes` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+| `remove_node` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+| `break_connections` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+| `set_node_properties` | `McpAutomationBridge_BehaviorTreeHandlers.cpp` | `HandleBehaviorTreeAction` | |
+
+## 16. Blueprint Graph Manager (`manage_blueprint_graph`)
+
+| Action | C++ Handler File | C++ Function | Notes |
+| :--- | :--- | :--- | :--- |
+| `create_node` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `delete_node` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `connect_pins` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `break_pin_links` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |
+| `set_node_property` | `McpAutomationBridge_BlueprintGraphHandlers.cpp` | `HandleBlueprintGraphAction` | |