ue-mcp 1.0.9 → 1.0.10

package/dist/tool-counts.json

@@ -25,6 +25,6 @@
     "feedback": 1,
     "statetree": 35
   },
-  "generatedAt": "2026-05-18T03:38:46.726Z",
-  "version": "1.0.9"
+  "generatedAt": "2026-05-18T20:52:21.686Z",
+  "version": "1.0.10"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ue-mcp",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Unreal Engine MCP server - 20 tools, 522+ actions for AI-driven editor control",
   "type": "module",
   "main": "dist/index.js",

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/HandlerUtils.h

@@ -1,6 +1,7 @@
 #pragma once
 
 #include "CoreMinimal.h"
+#include "Runtime/Launch/Resources/Version.h"
 #include "Dom/JsonValue.h"
 #include "Dom/JsonObject.h"
 #include "UObject/UObjectIterator.h"
@@ -12,6 +13,12 @@
 #include "EngineUtils.h"
 #include "GameFramework/Actor.h"
 
+// True on UE 5.5+ (and any future 6.x). Used to gate APIs introduced in 5.5
+// that don't exist in 5.4: StateTreeEditingSubsystem, FExpressionInputIterator,
+// AActor::Get/SetNetUpdateFrequency, UWidgetBlueprint::WidgetVariableNameToGuidMap,
+// UPCGEditorGraphNodeBase, UIKRetargeterController::AssignIKRigToAllOps, etc.
+#define UE_MCP_HAS_5_5_API ((ENGINE_MAJOR_VERSION > 5) || (ENGINE_MAJOR_VERSION == 5 && ENGINE_MINOR_VERSION >= 5))
+
 // ── Quick result builders ────────────────────────────────────────────────────
 
 /** Return an error response: { success: false, error: "..." } */

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AnimationHandlers.cpp

@@ -19,7 +19,11 @@
 #include "Animation/AnimNotifies/AnimNotify.h"
 #include "PhysicsEngine/PhysicsAsset.h"
 #include "Engine/SkeletalMeshSocket.h"
+// PhysicsEngine/SkeletalBodySetup.h is unavailable as a public include on
+// UE 5.4. USkeletalBodySetup is still defined transitively via PhysicsAsset.h.
+#if __has_include("PhysicsEngine/SkeletalBodySetup.h")
 #include "PhysicsEngine/SkeletalBodySetup.h"
+#endif
 #include "EditorScriptingUtilities/Public/EditorAssetLibrary.h"
 #include "Factories/AnimBlueprintFactory.h"
 #include "Factories/AnimMontageFactory.h"

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AnimationHandlers_StateMachine.cpp

@@ -47,6 +47,19 @@
 #include "Dom/JsonValue.h"
 
 
+// UPoseSearchDatabase's "asset count" accessor was renamed between 5.4 and 5.5:
+//   5.4: GetAnimationAssets().Num()
+//   5.5+: GetNumAnimationAssets()
+// Use one helper so the call sites stay readable.
+static int32 GetPoseSearchAssetCount(const UPoseSearchDatabase* Database)
+{
+#if UE_MCP_HAS_5_5_API
+	return Database->GetNumAnimationAssets();
+#else
+	return GetPoseSearchAssetCount(Database);
+#endif
+}
+
 // ─── State Machine Helpers ────────────────────────────────────────
 
 static UAnimBlueprint* LoadAnimBP(const FString& Path)
@@ -966,6 +979,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::CreateIKRetargeter(const TSharedPtr<F
 			UIKRetargeterController* Controller = UIKRetargeterController::GetController(Retargeter);
 			if (Controller)
 			{
+#if UE_MCP_HAS_5_5_API
 				if (!SourceRigPath.IsEmpty())
 				{
 					if (UIKRigDefinition* SrcRig = Cast<UIKRigDefinition>(LoadObject<UObject>(nullptr, *SourceRigPath)))
@@ -989,10 +1003,16 @@ TSharedPtr<FJsonValue> FAnimationHandlers::CreateIKRetargeter(const TSharedPtr<F
 						if (!Controller->GetSourceChain(C.ChainName).IsNone()) ChainsMapped++;
 					}
 				}
+#else
+				// 5.4 has no ops-stack: per-op rig assignment + AutoMapChains(EAutoMapChainType,bool)
+				// don't exist. The retargeter still works from SourceIKRigAsset/TargetIKRigAsset
+				// properties; chain auto-mapping must be triggered manually in the IK Retargeter editor.
+				OpsWarning = TEXT("autoMapChains requires UE 5.5+; open the IK Retargeter and auto-map chains manually.");
+#endif
 			}
 			else
 			{
-				OpsWarning = TEXT("IKRetargeterController unavailable — chains not mapped (call autoMapChains=false to suppress)");
+				OpsWarning = TEXT("IKRetargeterController unavailable - chains not mapped (call autoMapChains=false to suppress)");
 			}
 		}
 	}
@@ -1150,7 +1170,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::AddPoseSearchSequence(const TSharedPt
 		return MCPError(FString::Printf(TEXT("Animation asset type not supported by PoseSearch: %s"), *AnimAsset->GetClass()->GetName()));
 	}
 
-	const int32 PrevCount = Database->GetNumAnimationAssets();
+	const int32 PrevCount = GetPoseSearchAssetCount(Database);
 	FPoseSearchDatabaseAnimationAsset NewEntry;
 	NewEntry.AnimAsset = AnimAsset;
 	Database->Modify();
@@ -1158,7 +1178,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::AddPoseSearchSequence(const TSharedPt
 	Database->PostEditChange();
 	UEditorAssetLibrary::SaveLoadedAsset(Database);
 
-	const int32 NewCount = Database->GetNumAnimationAssets();
+	const int32 NewCount = GetPoseSearchAssetCount(Database);
 
 	TSharedPtr<FJsonObject> Res = MCPSuccess();
 	MCPSetUpdated(Res);
@@ -1180,7 +1200,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::BuildPoseSearchIndex(const TSharedPtr
 	UPoseSearchDatabase* Database = Cast<UPoseSearchDatabase>(UEditorAssetLibrary::LoadAsset(AssetPath));
 	if (!Database) return MCPError(FString::Printf(TEXT("PoseSearchDatabase not found: %s"), *AssetPath));
 	if (!Database->Schema) return MCPError(TEXT("Database has no Schema set — call set_pose_search_schema first"));
-	if (Database->GetNumAnimationAssets() == 0) return MCPError(TEXT("Database has no animation assets — call add_pose_search_sequence first"));
+	if (GetPoseSearchAssetCount(Database) == 0) return MCPError(TEXT("Database has no animation assets — call add_pose_search_sequence first"));
 
 	using namespace UE::PoseSearch;
 	const ERequestAsyncBuildFlag Flag = bWait
@@ -1205,7 +1225,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::BuildPoseSearchIndex(const TSharedPtr
 	Res->SetStringField(TEXT("path"), AssetPath);
 	Res->SetStringField(TEXT("result"), ResultStr);
 	Res->SetBoolField(TEXT("waitedForCompletion"), bWait);
-	Res->SetNumberField(TEXT("animationAssetCount"), Database->GetNumAnimationAssets());
+	Res->SetNumberField(TEXT("animationAssetCount"), GetPoseSearchAssetCount(Database));
 	return MCPResult(Res);
 }
 
@@ -1227,7 +1247,7 @@ TSharedPtr<FJsonValue> FAnimationHandlers::ReadPoseSearchDatabase(const TSharedP
 	Res->SetNumberField(TEXT("loopingCostBias"), Database->LoopingCostBias);
 	Res->SetNumberField(TEXT("kdTreeQueryNumNeighbors"), Database->KDTreeQueryNumNeighbors);
 
-	const int32 AssetCount = Database->GetNumAnimationAssets();
+	const int32 AssetCount = GetPoseSearchAssetCount(Database);
 	Res->SetNumberField(TEXT("animationAssetCount"), AssetCount);
 
 	TArray<TSharedPtr<FJsonValue>> Animations;

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/AssetHandlers_Mesh.cpp

@@ -6,6 +6,11 @@
 #include "AssetHandlers.h"
 #include "HandlerRegistry.h"
 #include "HandlerUtils.h"
+// FSkeletalMaterial moved out of Engine/SkeletalMesh.h in later UE versions.
+// Pull it explicitly via SkinnedAssetCommon when available.
+#if __has_include("Engine/SkinnedAssetCommon.h")
+#include "Engine/SkinnedAssetCommon.h"
+#endif
 #include "HandlerJsonProperty.h"
 #include "AssetRegistry/AssetRegistryModule.h"
 #include "AssetRegistry/IAssetRegistry.h"

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/EditorHandlers_Build.cpp

@@ -19,7 +19,9 @@
 #include "HAL/PlatformFileManager.h"
 #include "HAL/PlatformFile.h"
 #include "Modules/ModuleManager.h"
+#if PLATFORM_WINDOWS
 #include "ILiveCodingModule.h"
+#endif
 #include "Kismet/KismetSystemLibrary.h"
 #include "EditorValidatorSubsystem.h"
 #include "Dom/JsonObject.h"

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/LandscapeHandlers.cpp

@@ -574,7 +574,13 @@ TSharedPtr<FJsonValue> FLandscapeHandlers::CreateLandscape(const TSharedPtr<FJso
 		nullptr,
 		ImportLayerInfo,
 		ELandscapeImportAlphamapType::Additive,
-		MakeArrayView(EmptyLayers));
+#if UE_MCP_HAS_5_5_API
+		MakeArrayView(EmptyLayers)
+#else
+		// 5.4: last arg is const TArray<FLandscapeLayer>* (TArrayView signature added in 5.5).
+		&EmptyLayers
+#endif
+	);
 
 	if (!Label.IsEmpty())
 	{

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/MaterialHandlers_Advanced.cpp

@@ -96,6 +96,7 @@ TSharedPtr<FJsonValue> FMaterialHandlers::ValidateMaterial(const TSharedPtr<FJso
 	while (Stack.Num() > 0)
 	{
 		UMaterialExpression* Expr = Stack.Pop();
+#if UE_MCP_HAS_5_5_API
 		for (FExpressionInputIterator It{ Expr }; It; ++It)
 		{
 			if (It->Expression && !Referenced.Contains(It->Expression))
@@ -104,6 +105,18 @@ TSharedPtr<FJsonValue> FMaterialHandlers::ValidateMaterial(const TSharedPtr<FJso
 				Stack.Add(It->Expression);
 			}
 		}
+#else
+		// FExpressionInputIterator was added in 5.5; on 5.4 use the legacy GetInput(i) loop.
+		for (int32 InputIdx = 0, InputCount = Expr->GetInputs().Num(); InputIdx < InputCount; ++InputIdx)
+		{
+			FExpressionInput* In = Expr->GetInput(InputIdx);
+			if (In && In->Expression && !Referenced.Contains(In->Expression))
+			{
+				Referenced.Add(In->Expression);
+				Stack.Add(In->Expression);
+			}
+		}
+#endif
 	}
 
 	auto AllExpressions = Material->GetExpressions();

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/NetworkingHandlers.cpp

@@ -71,8 +71,13 @@ TSharedPtr<FJsonValue> FNetworkingHandlers::GetNetworkingInfo(const TSharedPtr<F
 
 	Result->SetStringField(TEXT("blueprintPath"), BlueprintPath);
 	Result->SetBoolField(TEXT("replicates"), CDO->GetIsReplicated());
+#if UE_MCP_HAS_5_5_API
 	Result->SetNumberField(TEXT("netUpdateFrequency"), CDO->GetNetUpdateFrequency());
 	Result->SetNumberField(TEXT("minNetUpdateFrequency"), CDO->GetMinNetUpdateFrequency());
+#else
+	Result->SetNumberField(TEXT("netUpdateFrequency"), CDO->NetUpdateFrequency);
+	Result->SetNumberField(TEXT("minNetUpdateFrequency"), CDO->MinNetUpdateFrequency);
+#endif
 	Result->SetNumberField(TEXT("netPriority"), CDO->NetPriority);
 	Result->SetBoolField(TEXT("alwaysRelevant"), CDO->bAlwaysRelevant);
 	Result->SetBoolField(TEXT("replicateMovement"), CDO->IsReplicatingMovement());
@@ -129,20 +134,33 @@ TSharedPtr<FJsonValue> FNetworkingHandlers::ConfigureNetUpdateFrequency(const TS
 	double NetUpdateFrequency = 0;
 	if (Params->TryGetNumberField(TEXT("netUpdateFrequency"), NetUpdateFrequency))
 	{
+#if UE_MCP_HAS_5_5_API
 		CDO->SetNetUpdateFrequency((float)NetUpdateFrequency);
+#else
+		CDO->NetUpdateFrequency = (float)NetUpdateFrequency;
+#endif
 	}
 	double MinNetUpdateFrequency = 0;
 	if (Params->TryGetNumberField(TEXT("minNetUpdateFrequency"), MinNetUpdateFrequency))
 	{
+#if UE_MCP_HAS_5_5_API
 		CDO->SetMinNetUpdateFrequency((float)MinNetUpdateFrequency);
+#else
+		CDO->MinNetUpdateFrequency = (float)MinNetUpdateFrequency;
+#endif
 	}
 
 	UBlueprint* Blueprint = LoadObject<UBlueprint>(nullptr, *BlueprintPath);
 	SaveBlueprint(Blueprint);
 
 	Result->SetStringField(TEXT("blueprintPath"), BlueprintPath);
+#if UE_MCP_HAS_5_5_API
 	Result->SetNumberField(TEXT("netUpdateFrequency"), CDO->GetNetUpdateFrequency());
 	Result->SetNumberField(TEXT("minNetUpdateFrequency"), CDO->GetMinNetUpdateFrequency());
+#else
+	Result->SetNumberField(TEXT("netUpdateFrequency"), CDO->NetUpdateFrequency);
+	Result->SetNumberField(TEXT("minNetUpdateFrequency"), CDO->MinNetUpdateFrequency);
+#endif
 	Result->SetBoolField(TEXT("success"), true);
 	return MCPResult(Result);
 }

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/PCGHandlers.cpp

@@ -24,7 +24,13 @@
 #include "PCGVolume.h"
 #include "Elements/PCGStaticMeshSpawner.h"
 #include "MeshSelectors/PCGMeshSelectorWeighted.h"
+// UPCGEditorGraphNodeBase ships in the PCGEditor module starting in UE 5.5.
+// On 5.4 the editor-node-position round-trip is unavailable; we fall back to
+// the runtime UPCGNode::PositionX/Y instead (only populated when this bridge
+// authored the node).
+#if UE_MCP_HAS_5_5_API
 #include "Nodes/PCGEditorGraphNodeBase.h"
+#endif
 #include "UObject/UObjectIterator.h"
 #include "Engine/StaticMesh.h"
 #include "Engine/Brush.h"
@@ -1909,6 +1915,8 @@ TSharedPtr<FJsonValue> FPCGHandlers::ExportGraph(const TSharedPtr<FJsonObject>&
 	// only populated when the node was authored through this bridge - the PCG
 	// editor never writes back to it. Build a lookup so editor-authored
 	// graphs round-trip their hand-laid-out positions.
+	// (5.4 lacks UPCGEditorGraphNodeBase; falls back to runtime PositionX/Y below.)
+#if UE_MCP_HAS_5_5_API
 	TMap<const UPCGNode*, const UPCGEditorGraphNodeBase*> EditorNodeByPCGNode;
 	for (TObjectIterator<UPCGEditorGraphNodeBase> It; It; ++It)
 	{
@@ -1921,6 +1929,7 @@ TSharedPtr<FJsonValue> FPCGHandlers::ExportGraph(const TSharedPtr<FJsonObject>&
 			EditorNodeByPCGNode.Add(PCGN, EdNode);
 		}
 	}
+#endif
 
 	TArray<TSharedPtr<FJsonValue>> NodesArr;
 	for (const UPCGNode* Node : Graph->GetNodes())
@@ -1932,11 +1941,13 @@ TSharedPtr<FJsonValue> FPCGHandlers::ExportGraph(const TSharedPtr<FJsonObject>&
 
 		double PosX = Node->PositionX;
 		double PosY = Node->PositionY;
+#if UE_MCP_HAS_5_5_API
 		if (const UPCGEditorGraphNodeBase* const* EdNodePtr = EditorNodeByPCGNode.Find(Node); EdNodePtr && *EdNodePtr)
 		{
 			PosX = (*EdNodePtr)->NodePosX;
 			PosY = (*EdNodePtr)->NodePosY;
 		}
+#endif
 		NodeObj->SetNumberField(TEXT("posX"), PosX);
 		NodeObj->SetNumberField(TEXT("posY"), PosY);
 

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/StateTreeHandlers.cpp

@@ -2,6 +2,12 @@
 #include "HandlerRegistry.h"
 #include "HandlerUtils.h"
 
+// StateTree authoring depends on UStateTreeEditingSubsystem (compile +
+// validate entry points) and the generic FPropertyBindingPath system, both
+// introduced in UE 5.5. On 5.4 we register no handlers and emit a one-line
+// log so the rest of the plugin still loads.
+#if UE_MCP_HAS_5_5_API
+
 #include "StateTree.h"
 #include "StateTreeEditorData.h"
 #include "StateTreeState.h"
@@ -23,8 +29,14 @@
 #include "StateTreeTaskBase.h"
 #include "StateTreeEditorTypes.h"
 
+#endif // UE_MCP_HAS_5_5_API
+
 void FStateTreeHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 {
+#if !UE_MCP_HAS_5_5_API
+	UE_LOG(LogTemp, Warning, TEXT("[UE_MCP_Bridge] StateTree handlers require UE 5.5+; skipped on this engine version."));
+	return;
+#else
 	Registry.RegisterHandler(TEXT("read_state_tree"), &ReadStateTree);
 	Registry.RegisterHandler(TEXT("list_state_tree_states"), &ListStates);
 	Registry.RegisterHandler(TEXT("add_state_tree_state"), &AddState);
@@ -60,8 +72,11 @@ void FStateTreeHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 	Registry.RegisterHandler(TEXT("set_state_tree_root_parameters"), &SetRootParameters);
 	Registry.RegisterHandler(TEXT("compile_state_tree"), &CompileStateTree);
 	Registry.RegisterHandler(TEXT("validate_state_tree"), &ValidateStateTree);
+#endif // UE_MCP_HAS_5_5_API
 }
 
+#if UE_MCP_HAS_5_5_API
+
 // ── Helpers ──────────────────────────────────────────────────────────────────
 
 UStateTree* FStateTreeHandlers::LoadStateTree(const FString& AssetPath)
@@ -2219,3 +2234,5 @@ TSharedPtr<FJsonValue> FStateTreeHandlers::ValidateStateTree(const TSharedPtr<FJ
 	Result->SetBoolField(TEXT("validated"), true);
 	return MCPResult(Result);
 }
+
+#endif // UE_MCP_HAS_5_5_API

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/WidgetHandlers.cpp

@@ -537,11 +537,15 @@ TSharedPtr<FJsonValue> FWidgetHandlers::AddWidget(const TSharedPtr<FJsonObject>&
 		}
 	}
 
-	// Register widget GUID so the compiler doesn't assert
+	// Register widget GUID so the compiler doesn't assert.
+	// WidgetVariableNameToGuidMap was added in UE 5.5; the assert it dodges
+	// only exists in 5.5+, so the registration is unnecessary on 5.4.
+#if UE_MCP_HAS_5_5_API
 	if (!WidgetBP->WidgetVariableNameToGuidMap.Contains(NewWidget->GetFName()))
 	{
 		WidgetBP->WidgetVariableNameToGuidMap.Add(NewWidget->GetFName(), FGuid::NewGuid());
 	}
+#endif
 
 	// ── Save ──
 	WidgetBP->MarkPackageDirty();