ultimate-unreal-engine-mcp 0.1.14 → 0.1.16

package/README.md

@@ -1,12 +1,12 @@
 # Ultimate Unreal Engine MCP
 
-**129 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.**
+**132 tools. 26 domains. Full read/write access to Unreal Engine 5.7 — including live editor APIs, Blueprint graphs, and viewport screenshots.**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![Node 22+](https://img.shields.io/badge/Node.js-22%2B-brightgreen.svg)](https://nodejs.org/)
 [![UE 5.7](https://img.shields.io/badge/Unreal%20Engine-5.7-orange.svg)](https://www.unrealengine.com/)
 [![Tests](https://img.shields.io/badge/tests-1021%20passing-success.svg)](#development)
-[![Tools](https://img.shields.io/badge/tools-129-informational.svg)](#tool-catalog)
+[![Tools](https://img.shields.io/badge/tools-132-informational.svg)](#tool-catalog)
 
 MCP (Model Context Protocol) is a standard that lets AI assistants call tools on external systems — this server exposes Unreal Engine as those tools.
 
@@ -296,14 +296,17 @@ graph TD
 </details>
 
 <details>
-<summary><strong>Editor</strong> — 7 tools</summary>
+<summary><strong>Editor</strong> — 10 tools</summary>
 
 | Tool | Description |
 |------|-------------|
 | `ue_list_actors` | List actors in the current level with transforms and class info |
-| `ue_spawn_actor` | Spawn an actor by class into the current level |
+| `ue_spawn_actor` | Spawn an actor by class with optional label |
 | `ue_transform_actor` | Move, rotate, scale, or set properties on an actor |
 | `ue_delete_actor` | Delete an actor from the current level |
+| `ue_set_actor_property` | Set any UPROPERTY on an actor or component by label (bool, int, float, string, name, actor ref, asset ref) |
+| `ue_create_data_asset` | Create a UPrimaryDataAsset with reflection-set properties |
+| `ue_create_curve` | Create a UCurveFloat asset with keyframes |
 | `ue_query_assets` | Query the asset registry — search by class, path, or name |
 | `ue_trace_references` | Trace all assets that reference or are referenced by an asset |
 | `ue_read_level_layout` | Read the current level's actor graph and spatial layout |

package/dist/tools/editor/index.js

@@ -120,20 +120,25 @@ export function registerEditorTools(server, bridge) {
             property_name: z.string().describe('The UPROPERTY name to set (e.g., RoomID, RoomDoor, DoorCurve)'),
             value: z.union([z.string(), z.number(), z.boolean()]).describe('The value to set — string for name/text/actor label/asset path, number for int/float, boolean for bool'),
             value_type: z.enum(['bool', 'int', 'float', 'string', 'name', 'text', 'actor', 'asset']).describe('Type of the value'),
+            component_name: z.string().optional().describe('Optional subcomponent name (e.g. DoorMesh) to set the property on instead of the actor'),
         }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
         },
     }, withKnownIssues('ue_set_actor_property', async (args) => {
+        const payload = {
+            actor_label: args.actor_label,
+            property_name: args.property_name,
+            value: args.value,
+            value_type: args.value_type,
+        };
+        if (args.component_name) {
+            payload['component_name'] = args.component_name;
+        }
         return sendOrDisconnect(_bridge, {
             type: 'actor.setProperty',
-            payload: {
-                actor_label: args.actor_label,
-                property_name: args.property_name,
-                value: args.value,
-                value_type: args.value_type,
-            },
+            payload,
         });
     }));
     // --------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-unreal-engine-mcp",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "MCP server giving AI assistants full access to Unreal Engine 5.7 projects",
   "type": "module",
   "engines": {

package/unreal-plugin/MCPBridge/Source/MCPBridgeEditor/Private/MCPViewportCommands.cpp

@@ -24,6 +24,8 @@
 #include "Editor.h"
 #include "EditorViewportClient.h"
 #include "LevelEditorViewport.h"
+#include "LevelEditor.h"
+#include "SLevelViewport.h"
 #include "UnrealClient.h"
 #include "HighResScreenshot.h"
 #include "Misc/Paths.h"
@@ -74,10 +76,10 @@ static FString BuildViewportErrorResponse(const FString& CorrId, const FString&
 }
 
 /**
- * Returns the first visible level editor viewport client, or nullptr if none is open.
- * A static_cast is safe here because MCPBridgeEditor only runs inside the editor and
- * GetAllViewportClients() in the level editor context returns FLevelEditorViewportClient
- * instances.
+ * Returns the first level editor viewport client.
+ * Uses FLevelEditorModule::GetFirstActiveLevelViewport() which reliably
+ * returns the docked viewport even when it doesn't have focus.
+ * Falls back to GEditor->GetAllViewportClients() scan if the module approach fails.
  */
 static FLevelEditorViewportClient* GetActiveViewportClient()
 {
@@ -86,14 +88,24 @@ static FLevelEditorViewportClient* GetActiveViewportClient()
 		return nullptr;
 	}
 
-	for (FEditorViewportClient* VC : GEditor->GetAllViewportClients())
+	// Primary path: use the LevelEditor module API (works for docked viewports).
+	if (FModuleManager::Get().IsModuleLoaded(TEXT("LevelEditor")))
 	{
-		if (!VC)
+		FLevelEditorModule& LevelEditorModule =
+			FModuleManager::GetModuleChecked<FLevelEditorModule>(TEXT("LevelEditor"));
+		TSharedPtr<SLevelViewport> ActiveViewport = LevelEditorModule.GetFirstActiveLevelViewport();
+		if (ActiveViewport.IsValid())
 		{
-			continue;
+			return &ActiveViewport->GetLevelViewportClient();
 		}
+	}
+
+	// Fallback: iterate all viewport clients.
+	for (FEditorViewportClient* VC : GEditor->GetAllViewportClients())
+	{
+		if (!VC) continue;
 		FLevelEditorViewportClient* LVC = static_cast<FLevelEditorViewportClient*>(VC);
-		if (LVC && LVC->IsVisible())
+		if (LVC)
 		{
 			return LVC;
 		}