flockbay 0.10.15 → 0.10.17

package/tools/unreal-mcp/upstream/MCPGameProject/Plugins/UnrealMCP/Source/UnrealMCP/Private/Commands/UnrealMCPCommandSchema.cpp

@@ -0,0 +1,731 @@
+#include "Commands/UnrealMCPCommandSchema.h"
+#include "Commands/UnrealMCPCommonUtils.h"
+#include "Interfaces/IPluginManager.h"
+
+static constexpr int32 kUnrealMcpSchemaVersion = 2;
+
+TSharedPtr<FJsonObject> FUnrealMCPParamSchema::ToJson() const
+{
+	TSharedPtr<FJsonObject> Obj = MakeShared<FJsonObject>();
+	Obj->SetStringField(TEXT("name"), Name);
+	Obj->SetStringField(TEXT("type"), Type);
+	Obj->SetBoolField(TEXT("required"), bRequired);
+	if (!Description.IsEmpty()) Obj->SetStringField(TEXT("description"), Description);
+	if (Aliases.Num() > 0)
+	{
+		TArray<TSharedPtr<FJsonValue>> Arr;
+		for (const FString& A : Aliases) Arr.Add(MakeShared<FJsonValueString>(A));
+		Obj->SetArrayField(TEXT("aliases"), Arr);
+	}
+	if (EnumValues.Num() > 0)
+	{
+		TArray<TSharedPtr<FJsonValue>> Arr;
+		for (const FString& V : EnumValues) Arr.Add(MakeShared<FJsonValueString>(V));
+		Obj->SetArrayField(TEXT("enum"), Arr);
+	}
+	if (ValueAliases.Num() > 0)
+	{
+		TSharedPtr<FJsonObject> MapObj = MakeShared<FJsonObject>();
+		for (const TPair<FString, FString>& Pair : ValueAliases)
+		{
+			MapObj->SetStringField(Pair.Key, Pair.Value);
+		}
+		Obj->SetObjectField(TEXT("valueAliases"), MapObj);
+	}
+	return Obj;
+}
+
+TSharedPtr<FJsonObject> FUnrealMCPCommandSchema::ToJson() const
+{
+	TSharedPtr<FJsonObject> Obj = MakeShared<FJsonObject>();
+	Obj->SetStringField(TEXT("command"), Command);
+	if (!Title.IsEmpty()) Obj->SetStringField(TEXT("title"), Title);
+	if (!Description.IsEmpty()) Obj->SetStringField(TEXT("description"), Description);
+
+	TArray<TSharedPtr<FJsonValue>> ParamsArr;
+	for (const FUnrealMCPParamSchema& P : Params)
+	{
+		ParamsArr.Add(MakeShared<FJsonValueObject>(P.ToJson()));
+	}
+	Obj->SetArrayField(TEXT("params"), ParamsArr);
+
+	if (ExampleParams.IsValid())
+	{
+		Obj->SetObjectField(TEXT("exampleParams"), ExampleParams);
+	}
+
+	Obj->SetNumberField(TEXT("schemaVersion"), kUnrealMcpSchemaVersion);
+	return Obj;
+}
+
+static void AddStringParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("string");
+	P.bRequired = bRequired;
+	P.Description = Desc;
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddNumberParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("number");
+	P.bRequired = bRequired;
+	P.Description = Desc;
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddBoolParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("boolean");
+	P.bRequired = bRequired;
+	P.Description = Desc;
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddAnyParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("any");
+	P.bRequired = bRequired;
+	P.Description = Desc;
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddVectorParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("vector");
+	P.bRequired = bRequired;
+	P.Description = Desc + TEXT(" Accepts either [x,y,z] or {x,y,z}.");
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddRotatorParam(TArray<FUnrealMCPParamSchema>& Out, const FString& Name, bool bRequired, const FString& Desc, const TArray<FString>& Aliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("rotator");
+	P.bRequired = bRequired;
+	P.Description = Desc + TEXT(" Accepts either [pitch,yaw,roll] or {pitch,yaw,roll}.");
+	P.Aliases = Aliases;
+	Out.Add(MoveTemp(P));
+}
+
+static void AddEnumParam(
+	TArray<FUnrealMCPParamSchema>& Out,
+	const FString& Name,
+	bool bRequired,
+	const FString& Desc,
+	const TArray<FString>& EnumValues,
+	const TArray<FString>& Aliases = {},
+	const TMap<FString, FString>& ValueAliases = {})
+{
+	FUnrealMCPParamSchema P;
+	P.Name = Name;
+	P.Type = TEXT("string");
+	P.bRequired = bRequired;
+	P.Description = Desc;
+	P.Aliases = Aliases;
+	P.EnumValues = EnumValues;
+	P.ValueAliases = ValueAliases;
+	Out.Add(MoveTemp(P));
+}
+
+static TSharedPtr<FJsonObject> Example(std::initializer_list<TPair<FString, TSharedPtr<FJsonValue>>> Fields)
+{
+	TSharedPtr<FJsonObject> Obj = MakeShared<FJsonObject>();
+	for (const auto& Pair : Fields)
+	{
+		Obj->SetField(Pair.Key, Pair.Value);
+	}
+	return Obj;
+}
+
+static TMap<FString, FUnrealMCPCommandSchema> BuildSchemas()
+{
+	TMap<FString, FUnrealMCPCommandSchema> Schemas;
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("create_blueprint");
+		S.Title = TEXT("Create Blueprint");
+		S.Description = TEXT("Create a new Blueprint asset.");
+		AddStringParam(S.Params, TEXT("name"), true, TEXT("Blueprint asset name."), {TEXT("blueprint_name"), TEXT("assetName"), TEXT("asset_name")});
+		AddStringParam(S.Params, TEXT("path"), false, TEXT("Package path (e.g. /Game/Blueprints/). Defaults to /Game/Blueprints/."), {TEXT("packagePath"), TEXT("package_path"), TEXT("blueprint_path")});
+		AddStringParam(S.Params, TEXT("parent_class"), false, TEXT("Parent class name (e.g. Actor, Pawn)."), {TEXT("parentClass"), TEXT("parent")});
+		S.ExampleParams = Example({
+			{TEXT("name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("path"), MakeShared<FJsonValueString>(TEXT("/Game/Blueprints/"))},
+			{TEXT("parent_class"), MakeShared<FJsonValueString>(TEXT("Actor"))},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("create_landscape");
+		S.Title = TEXT("Create Landscape");
+		S.Description = TEXT("Create a new Landscape actor in the current editor level. Fails if PIE is running.");
+		AddStringParam(S.Params, TEXT("name"), true, TEXT("Landscape actor name (must be unique)."));
+		AddNumberParam(S.Params, TEXT("componentCountX"), false, TEXT("Number of components in X (default 8)."));
+		AddNumberParam(S.Params, TEXT("componentCountY"), false, TEXT("Number of components in Y (default 8)."));
+		AddNumberParam(S.Params, TEXT("sectionsPerComponent"), false, TEXT("Sections per component (1 or 2, default 1)."));
+		AddNumberParam(S.Params, TEXT("quadsPerSection"), false, TEXT("Quads per section (default 63)."));
+		AddVectorParam(S.Params, TEXT("location"), false, TEXT("Center location in cm."));
+		AddRotatorParam(S.Params, TEXT("rotation"), false, TEXT("Rotation in degrees."));
+		AddVectorParam(S.Params, TEXT("scale"), false, TEXT("Actor scale (default [100,100,100])."));
+		AddStringParam(S.Params, TEXT("materialPath"), false, TEXT("Optional landscape material object path."), {TEXT("material"), TEXT("landscapeMaterial")});
+		S.ExampleParams = Example({
+			{TEXT("name"), MakeShared<FJsonValueString>(TEXT("Landscape_01"))},
+			{TEXT("componentCountX"), MakeShared<FJsonValueNumber>(8)},
+			{TEXT("componentCountY"), MakeShared<FJsonValueNumber>(8)},
+			{TEXT("sectionsPerComponent"), MakeShared<FJsonValueNumber>(1)},
+			{TEXT("quadsPerSection"), MakeShared<FJsonValueNumber>(63)},
+			{TEXT("location"), MakeShared<FJsonValueArray>(TArray<TSharedPtr<FJsonValue>>{
+				MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0),
+			})},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("save_all");
+		S.Title = TEXT("Save All");
+		S.Description = TEXT("Save all dirty packages (maps + content) without prompting. Fails if PIE is running.");
+		S.ExampleParams = Example({});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("add_component_to_blueprint");
+		S.Title = TEXT("Add Component To Blueprint");
+		S.Description = TEXT("Add a component to a Blueprint's SimpleConstructionScript.");
+		AddStringParam(S.Params, TEXT("blueprint_name"), true, TEXT("Blueprint asset name."), {TEXT("name"), TEXT("blueprint"), TEXT("blueprintName")});
+		AddStringParam(S.Params, TEXT("component_type"), true, TEXT("Component type/class (e.g. StaticMesh, StaticMeshComponent, PointLightComponent)."), {TEXT("type"), TEXT("component_class"), TEXT("componentClass")});
+		AddStringParam(S.Params, TEXT("component_name"), true, TEXT("New component name."), {TEXT("name"), TEXT("componentName")});
+		AddStringParam(S.Params, TEXT("parent_component_name"), false, TEXT("Optional parent component name."), {TEXT("parentComponentName"), TEXT("parent_component")});
+		AddVectorParam(S.Params, TEXT("location"), false, TEXT("Relative location."), {TEXT("relative_location"), TEXT("RelativeLocation")});
+		AddRotatorParam(S.Params, TEXT("rotation"), false, TEXT("Relative rotation."), {TEXT("relative_rotation"), TEXT("RelativeRotation")});
+		AddVectorParam(S.Params, TEXT("scale"), false, TEXT("Relative scale."), {TEXT("relative_scale"), TEXT("RelativeScale3D")});
+		S.ExampleParams = Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("component_type"), MakeShared<FJsonValueString>(TEXT("StaticMeshComponent"))},
+			{TEXT("component_name"), MakeShared<FJsonValueString>(TEXT("Wall_01"))},
+			{TEXT("location"), MakeShared<FJsonValueArray>(TArray<TSharedPtr<FJsonValue>>{
+				MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0),
+			})},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("set_component_property");
+		S.Title = TEXT("Set Component Property (Blueprint)");
+		S.Description = TEXT("Set a property on a Blueprint's component template (SCS).");
+		AddStringParam(S.Params, TEXT("blueprint_name"), true, TEXT("Blueprint asset name or path."), {TEXT("blueprint"), TEXT("name"), TEXT("blueprintPath")});
+		AddStringParam(S.Params, TEXT("component_name"), true, TEXT("Component name in the blueprint."), {TEXT("component"), TEXT("name"), TEXT("componentName")});
+		AddStringParam(S.Params, TEXT("property_name"), true, TEXT("Property name to set."), {TEXT("property"), TEXT("prop"), TEXT("field"), TEXT("propertyName")});
+		AddAnyParam(S.Params, TEXT("property_value"), true, TEXT("JSON value for the property."), {TEXT("value"), TEXT("propertyValue")});
+		S.ExampleParams = Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("component_name"), MakeShared<FJsonValueString>(TEXT("Wall_01"))},
+			{TEXT("property_name"), MakeShared<FJsonValueString>(TEXT("RelativeScale3D"))},
+			{TEXT("property_value"), MakeShared<FJsonValueArray>(TArray<TSharedPtr<FJsonValue>>{
+				MakeShared<FJsonValueNumber>(35), MakeShared<FJsonValueNumber>(25), MakeShared<FJsonValueNumber>(0.2),
+			})},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("compile_blueprint");
+		S.Title = TEXT("Compile Blueprint");
+		S.Description = TEXT("Compile a single Blueprint.");
+		AddStringParam(S.Params, TEXT("blueprint_name"), true, TEXT("Blueprint asset name or path."), {TEXT("blueprint"), TEXT("name"), TEXT("blueprintPath")});
+		S.ExampleParams = Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("compile_blueprints_all");
+		S.Title = TEXT("Compile Blueprints (All)");
+		S.Description = TEXT("Compile all Blueprints in the project (bounded).");
+		AddNumberParam(S.Params, TEXT("limit"), false, TEXT("Optional max number of blueprints to compile."));
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("add_blueprint_variable");
+		S.Title = TEXT("Add Blueprint Variable");
+		S.Description = TEXT("Add a variable to a Blueprint.");
+		AddStringParam(S.Params, TEXT("blueprint_name"), true, TEXT("Blueprint asset name."), {TEXT("name"), TEXT("blueprint"), TEXT("blueprintName"), TEXT("blueprintPath")});
+		AddStringParam(S.Params, TEXT("variable_name"), true, TEXT("Variable name."), {TEXT("name"), TEXT("var_name"), TEXT("varName")});
+		AddStringParam(S.Params, TEXT("variable_type"), true, TEXT("Variable type (e.g. float, int, bool, vector, string)."), {TEXT("type"), TEXT("var_type"), TEXT("varType")});
+		AddStringParam(S.Params, TEXT("default_value"), false, TEXT("Optional default value (string form)."), {TEXT("defaultValue"), TEXT("default")});
+		S.ExampleParams = Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("variable_name"), MakeShared<FJsonValueString>(TEXT("WidthCm"))},
+			{TEXT("variable_type"), MakeShared<FJsonValueString>(TEXT("float"))},
+			{TEXT("default_value"), MakeShared<FJsonValueString>(TEXT("500"))},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	{
+		FUnrealMCPCommandSchema S;
+		S.Command = TEXT("spawn_blueprint_actor");
+		S.Title = TEXT("Spawn Blueprint Actor");
+		S.Description = TEXT("Spawn an actor from a Blueprint/Class into the editor world.");
+		AddStringParam(S.Params, TEXT("blueprint_name"), true, TEXT("Blueprint name or object path."), {TEXT("blueprint"), TEXT("blueprint_path"), TEXT("objectPath"), TEXT("object_path"), TEXT("objectPath")});
+		AddStringParam(S.Params, TEXT("actor_name"), true, TEXT("Desired actor name base."), {TEXT("name")});
+		AddVectorParam(S.Params, TEXT("location"), false, TEXT("World location."));
+		AddRotatorParam(S.Params, TEXT("rotation"), false, TEXT("World rotation."));
+		AddVectorParam(S.Params, TEXT("scale"), false, TEXT("World scale."));
+		AddBoolParam(S.Params, TEXT("include_details"), false, TEXT("If true, include detailed component/property info (larger response)."), {TEXT("detailed"), TEXT("includeProperties")});
+		S.ExampleParams = Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("/Game/Blueprints/BP_TwoStoryBuilding.BP_TwoStoryBuilding"))},
+			{TEXT("actor_name"), MakeShared<FJsonValueString>(TEXT("TwoStoryBuilding_01"))},
+			{TEXT("location"), MakeShared<FJsonValueArray>(TArray<TSharedPtr<FJsonValue>>{
+				MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0), MakeShared<FJsonValueNumber>(0),
+			})},
+			{TEXT("include_details"), MakeShared<FJsonValueBoolean>(false)},
+		});
+		Schemas.Add(S.Command, MoveTemp(S));
+	}
+
+	// NOTE: Schemas for other commands are intentionally minimal; they still help with required keys & common aliases.
+	const auto AddSimpleCommand = [&](const FString& Command, const FString& Title, const FString& Desc, const TArray<FUnrealMCPParamSchema>& Params, const TSharedPtr<FJsonObject>& ExampleParams) {
+		FUnrealMCPCommandSchema S;
+		S.Command = Command;
+		S.Title = Title;
+		S.Description = Desc;
+		S.Params = Params;
+		S.ExampleParams = ExampleParams;
+		Schemas.Add(S.Command, MoveTemp(S));
+	};
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("pattern"), true, TEXT("Fuzzy name/pattern to match."), {TEXT("name"), TEXT("query")});
+		AddNumberParam(P, TEXT("limit"), false, TEXT("Max results (default 25)."));
+		AddSimpleCommand(TEXT("find_actors_by_name"), TEXT("Find Actors By Name"), TEXT("Find actors by name substring."), P, Example({
+			{TEXT("pattern"), MakeShared<FJsonValueString>(TEXT("BP_"))},
+			{TEXT("limit"), MakeShared<FJsonValueNumber>(25)},
+		}));
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("type"), true, TEXT("Actor type/class name (e.g. StaticMeshActor, PointLight)."), {TEXT("class"), TEXT("actor_type"), TEXT("actorType")});
+		AddStringParam(P, TEXT("name"), true, TEXT("Actor name base."), {TEXT("actor_name"), TEXT("actorName")});
+		AddVectorParam(P, TEXT("location"), false, TEXT("World location."));
+		AddRotatorParam(P, TEXT("rotation"), false, TEXT("World rotation."));
+		AddVectorParam(P, TEXT("scale"), false, TEXT("World scale."));
+		AddStringParam(P, TEXT("static_mesh_path"), false, TEXT("Static mesh object path (for StaticMeshActor)."), {TEXT("staticMeshPath"), TEXT("static_mesh")});
+		AddSimpleCommand(TEXT("spawn_actor"), TEXT("Spawn Actor"), TEXT("Spawn an actor in the editor world."), P, Example({
+			{TEXT("type"), MakeShared<FJsonValueString>(TEXT("StaticMeshActor"))},
+			{TEXT("name"), MakeShared<FJsonValueString>(TEXT("MCP_Cube_01"))},
+			{TEXT("static_mesh_path"), MakeShared<FJsonValueString>(TEXT("/Engine/BasicShapes/Cube.Cube"))},
+		}));
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("actor_name"), true, TEXT("Actor name to modify."), {TEXT("name"), TEXT("actor")});
+		AddStringParam(P, TEXT("property_name"), true, TEXT("Property name or property path (best-effort)."), {TEXT("property"), TEXT("prop"), TEXT("field")});
+		AddAnyParam(P, TEXT("property_value"), true, TEXT("Property value (JSON; type depends on property)."), {TEXT("value"), TEXT("propertyValue")});
+		AddSimpleCommand(TEXT("set_actor_property"), TEXT("Set Actor Property"), TEXT("Set an editable property on an actor."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("filepath"), false, TEXT("Output path. If omitted, defaults to <Project>/Saved/Screenshots/Flockbay/."), {TEXT("path"), TEXT("file_path")});
+		AddStringParam(P, TEXT("filename"), false, TEXT("Optional file name (auto-generated if omitted)."));
+		AddSimpleCommand(TEXT("take_screenshot"), TEXT("Take Screenshot"), TEXT("Capture a screenshot from the editor or PIE."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("query"), false, TEXT("Fuzzy search string."));
+		AddStringParam(P, TEXT("root"), false, TEXT("Root path (default /Game/)."));
+		AddNumberParam(P, TEXT("limit"), false, TEXT("Max results."));
+		AddSimpleCommand(TEXT("search_assets"), TEXT("Search Assets"), TEXT("Search assets via AssetRegistry."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("object_path"), true, TEXT("Asset object path."), {TEXT("objectPath"), TEXT("asset_path"), TEXT("assetPath")});
+		AddSimpleCommand(TEXT("get_asset_info"), TEXT("Get Asset Info"), TEXT("Get basic info for an asset."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("object_path"), true, TEXT("Asset object path to place (e.g. /Game/.../BP_X.BP_X)."), {TEXT("objectPath"), TEXT("asset_path"), TEXT("assetPath")});
+		AddVectorParam(P, TEXT("location"), false, TEXT("World location (default 0,0,0)."));
+		AddRotatorParam(P, TEXT("rotation"), false, TEXT("World rotation (default 0,0,0)."));
+		AddVectorParam(P, TEXT("scale"), false, TEXT("World scale (default 1,1,1)."));
+		AddStringParam(P, TEXT("actor_name"), false, TEXT("Optional actor name base."), {TEXT("name")});
+		AddSimpleCommand(TEXT("place_asset"), TEXT("Place Asset"), TEXT("Place an asset (Blueprint, StaticMesh, etc.) into the level."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("blueprint_name"), true, TEXT("Blueprint asset name."), {TEXT("name"), TEXT("blueprint")});
+		AddStringParam(P, TEXT("component_name"), true, TEXT("Component name in blueprint."), {TEXT("name"), TEXT("component")});
+		AddStringParam(P, TEXT("mesh_path"), true, TEXT("Static mesh object path."), {TEXT("static_mesh_path"), TEXT("staticMeshPath"), TEXT("static_mesh")});
+		AddSimpleCommand(TEXT("set_static_mesh_properties"), TEXT("Set Static Mesh Properties"), TEXT("Assign a static mesh to a StaticMeshComponent in a Blueprint."), P, Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("component_name"), MakeShared<FJsonValueString>(TEXT("Wall_01"))},
+			{TEXT("mesh_path"), MakeShared<FJsonValueString>(TEXT("/Engine/BasicShapes/Cube.Cube"))},
+		}));
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("blueprint_name"), true, TEXT("Blueprint asset name."), {TEXT("name"), TEXT("blueprint")});
+		AddStringParam(P, TEXT("event_name"), true, TEXT("Event function name (e.g. UserConstructionScript)."), {TEXT("name"), TEXT("event")});
+		AddVectorParam(P, TEXT("node_position"), false, TEXT("Node position in the graph."));
+		AddSimpleCommand(TEXT("add_blueprint_event_node"), TEXT("Add Blueprint Event Node"), TEXT("Add or reuse an event node in the EventGraph."), P, Example({
+			{TEXT("blueprint_name"), MakeShared<FJsonValueString>(TEXT("BP_TwoStoryBuilding"))},
+			{TEXT("event_name"), MakeShared<FJsonValueString>(TEXT("UserConstructionScript"))},
+		}));
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("blueprint_name"), true, TEXT("Blueprint asset name."), {TEXT("name"), TEXT("blueprint")});
+		AddStringParam(P, TEXT("function_name"), true, TEXT("Function name (e.g. MakeVector)."), {TEXT("name"), TEXT("function")});
+		AddStringParam(P, TEXT("target"), false, TEXT("Target class name for the function (e.g. KismetMathLibrary, SceneComponent)."));
+		AddStringParam(P, TEXT("function_owner_path"), false, TEXT("Optional explicit class path (/Script/Engine.KismetMathLibrary). Overrides target."), {TEXT("owner_path"), TEXT("ownerClassPath"), TEXT("owner_class_path")});
+		AddVectorParam(P, TEXT("node_position"), false, TEXT("Node position in the graph."));
+		AddSimpleCommand(TEXT("add_blueprint_function_node"), TEXT("Add Blueprint Function Node"), TEXT("Add a function call node to the EventGraph."), P, nullptr);
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("query"), true, TEXT("Substring to search for (function name/display name)."), {TEXT("q"), TEXT("name")});
+		AddStringParam(P, TEXT("target"), false, TEXT("Optional target class name (limits the search)."), {TEXT("class"), TEXT("owner")});
+		AddNumberParam(P, TEXT("limit"), false, TEXT("Max results (default 25)."));
+		AddSimpleCommand(TEXT("search_blueprint_functions"), TEXT("Search Blueprint Functions"), TEXT("Search for Blueprint-callable functions and return candidates."), P, Example({
+			{TEXT("query"), MakeShared<FJsonValueString>(TEXT("MakeVector"))},
+			{TEXT("target"), MakeShared<FJsonValueString>(TEXT("KismetMathLibrary"))},
+		}));
+	}
+
+	{
+		TArray<FUnrealMCPParamSchema> P;
+		AddStringParam(P, TEXT("function_name"), true, TEXT("Function name to resolve."), {TEXT("name"), TEXT("query")});
+		AddStringParam(P, TEXT("target"), false, TEXT("Optional target class constraint."), {TEXT("class"), TEXT("owner")});
+		AddSimpleCommand(TEXT("resolve_blueprint_function"), TEXT("Resolve Blueprint Function"), TEXT("Resolve a function to an explicit owner class path usable for add_blueprint_function_node."), P, Example({
+			{TEXT("function_name"), MakeShared<FJsonValueString>(TEXT("MakeVector"))},
+			{TEXT("target"), MakeShared<FJsonValueString>(TEXT("KismetMathLibrary"))},
+		}));
+	}
+
+	return Schemas;
+}
+
+static const TMap<FString, FUnrealMCPCommandSchema>& SchemaMap()
+{
+	static const TMap<FString, FUnrealMCPCommandSchema> Schemas = BuildSchemas();
+	return Schemas;
+}
+
+int32 FUnrealMCPCommandSchemaRegistry::SchemaVersion()
+{
+	return kUnrealMcpSchemaVersion;
+}
+
+const FUnrealMCPCommandSchema* FUnrealMCPCommandSchemaRegistry::FindSchema(const FString& CommandType)
+{
+	const auto& Map = SchemaMap();
+	if (const FUnrealMCPCommandSchema* Found = Map.Find(CommandType))
+	{
+		return Found;
+	}
+	return nullptr;
+}
+
+TArray<FString> FUnrealMCPCommandSchemaRegistry::GetSupportedCommands()
+{
+	// Keep explicit + stable ordering.
+	TArray<FString> Commands;
+	Commands.Add(TEXT("ping"));
+	Commands.Add(TEXT("get_plugin_info"));
+	Commands.Add(TEXT("list_capabilities"));
+	Commands.Add(TEXT("get_command_schema"));
+
+	// Editor
+	Commands.Add(TEXT("get_actors_in_level"));
+	Commands.Add(TEXT("find_actors_by_name"));
+	Commands.Add(TEXT("spawn_actor"));
+	Commands.Add(TEXT("create_actor"));
+	Commands.Add(TEXT("create_landscape"));
+	Commands.Add(TEXT("delete_actor"));
+	Commands.Add(TEXT("set_actor_transform"));
+	Commands.Add(TEXT("get_actor_properties"));
+	Commands.Add(TEXT("set_actor_property"));
+	Commands.Add(TEXT("spawn_blueprint_actor"));
+	Commands.Add(TEXT("focus_viewport"));
+	Commands.Add(TEXT("take_screenshot"));
+	Commands.Add(TEXT("save_all"));
+	Commands.Add(TEXT("get_play_in_editor_status"));
+	Commands.Add(TEXT("play_in_editor"));
+	Commands.Add(TEXT("play_in_editor_windowed"));
+	Commands.Add(TEXT("stop_play_in_editor"));
+	Commands.Add(TEXT("search_assets"));
+	Commands.Add(TEXT("get_asset_info"));
+	Commands.Add(TEXT("list_asset_packs"));
+	Commands.Add(TEXT("place_asset"));
+	Commands.Add(TEXT("map_check"));
+	Commands.Add(TEXT("get_editor_context"));
+	Commands.Add(TEXT("get_player_context"));
+	Commands.Add(TEXT("raycast_from_camera"));
+	Commands.Add(TEXT("raycast_down"));
+	Commands.Add(TEXT("get_actor_transform"));
+	Commands.Add(TEXT("get_actor_bounds"));
+
+	// Blueprint asset + SCS edits
+	Commands.Add(TEXT("create_blueprint"));
+	Commands.Add(TEXT("add_component_to_blueprint"));
+	Commands.Add(TEXT("set_component_property"));
+	Commands.Add(TEXT("set_physics_properties"));
+	Commands.Add(TEXT("compile_blueprint"));
+	Commands.Add(TEXT("compile_blueprints_all"));
+	Commands.Add(TEXT("set_blueprint_property"));
+	Commands.Add(TEXT("set_static_mesh_properties"));
+	Commands.Add(TEXT("set_pawn_properties"));
+
+	// Blueprint graph/node edits
+	Commands.Add(TEXT("connect_blueprint_nodes"));
+	Commands.Add(TEXT("add_blueprint_get_self_component_reference"));
+	Commands.Add(TEXT("add_blueprint_self_reference"));
+	Commands.Add(TEXT("find_blueprint_nodes"));
+	Commands.Add(TEXT("add_blueprint_event_node"));
+	Commands.Add(TEXT("add_blueprint_input_action_node"));
+	Commands.Add(TEXT("add_blueprint_function_node"));
+	Commands.Add(TEXT("add_blueprint_get_component_node"));
+	Commands.Add(TEXT("add_blueprint_variable"));
+
+	// Function discovery helpers
+	Commands.Add(TEXT("search_blueprint_functions"));
+	Commands.Add(TEXT("resolve_blueprint_function"));
+
+	// Project
+	Commands.Add(TEXT("create_input_mapping"));
+
+	// UMG
+	Commands.Add(TEXT("create_umg_widget_blueprint"));
+	Commands.Add(TEXT("add_text_block_to_widget"));
+	Commands.Add(TEXT("add_button_to_widget"));
+	Commands.Add(TEXT("bind_widget_event"));
+	Commands.Add(TEXT("set_text_block_binding"));
+	Commands.Add(TEXT("add_widget_to_viewport"));
+
+	return Commands;
+}
+
+static bool HasKey(const TSharedPtr<FJsonObject>& Obj, const FString& Key)
+{
+	return Obj.IsValid() && Obj->HasField(Key);
+}
+
+static FString JsonTypeName(const TSharedPtr<FJsonValue>& V)
+{
+	if (!V.IsValid()) return TEXT("null");
+	switch (V->Type)
+	{
+		case EJson::None: return TEXT("null");
+		case EJson::Null: return TEXT("null");
+		case EJson::String: return TEXT("string");
+		case EJson::Number: return TEXT("number");
+		case EJson::Boolean: return TEXT("boolean");
+		case EJson::Array: return TEXT("array");
+		case EJson::Object: return TEXT("object");
+		default: return TEXT("unknown");
+	}
+}
+
+static bool TryGetWithAliases(const TSharedPtr<FJsonObject>& In, const FString& Canonical, const TArray<FString>& Aliases, TSharedPtr<FJsonValue>& OutValue, FString& OutUsedKey)
+{
+	if (!In.IsValid()) return false;
+	OutValue = In->TryGetField(Canonical);
+	if (OutValue.IsValid())
+	{
+		OutUsedKey = Canonical;
+		return true;
+	}
+	for (const FString& A : Aliases)
+	{
+		if (A.IsEmpty()) continue;
+		OutValue = In->TryGetField(A);
+		if (OutValue.IsValid())
+		{
+			OutUsedKey = A;
+			return true;
+		}
+	}
+	return false;
+}
+
+bool FUnrealMCPCommandSchemaRegistry::NormalizeParams(
+	const FString& CommandType,
+	const TSharedPtr<FJsonObject>& InParams,
+	TSharedPtr<FJsonObject>& OutParams,
+	TSharedPtr<FJsonObject>& OutError)
+{
+	OutError.Reset();
+	OutParams = InParams.IsValid() ? MakeShared<FJsonObject>(*InParams) : MakeShared<FJsonObject>();
+
+	const FUnrealMCPCommandSchema* Schema = FindSchema(CommandType);
+	if (!Schema)
+	{
+		return true;
+	}
+
+	TArray<FString> Missing;
+	TSharedPtr<FJsonObject> Normalized = MakeShared<FJsonObject>(*OutParams);
+
+	for (const FUnrealMCPParamSchema& P : Schema->Params)
+	{
+		TSharedPtr<FJsonValue> Value;
+		FString UsedKey;
+		const bool bFound = TryGetWithAliases(OutParams, P.Name, P.Aliases, Value, UsedKey);
+		if (!bFound)
+		{
+			if (P.bRequired) Missing.Add(P.Name);
+			continue;
+		}
+
+		// Apply value aliases for enums (e.g. anchor="player" -> "player_camera").
+		if (P.ValueAliases.Num() > 0 && Value.IsValid() && Value->Type == EJson::String)
+		{
+			const FString InValue = Value->AsString();
+			if (const FString* Mapped = P.ValueAliases.Find(InValue))
+			{
+				Value = MakeShared<FJsonValueString>(*Mapped);
+			}
+		}
+
+		Normalized->SetField(P.Name, Value);
+	}
+
+	OutParams = Normalized;
+
+	if (Missing.Num() > 0)
+	{
+		TSharedPtr<FJsonObject> Details = MakeShared<FJsonObject>();
+		Details->SetStringField(TEXT("kind"), TEXT("missing_params"));
+		Details->SetStringField(TEXT("command"), CommandType);
+		Details->SetNumberField(TEXT("schemaVersion"), kUnrealMcpSchemaVersion);
+
+		TArray<TSharedPtr<FJsonValue>> MissingArr;
+		for (const FString& M : Missing) MissingArr.Add(MakeShared<FJsonValueString>(M));
+		Details->SetArrayField(TEXT("missing"), MissingArr);
+
+		TArray<TSharedPtr<FJsonValue>> RequiredArr;
+		for (const FUnrealMCPParamSchema& P : Schema->Params)
+		{
+			if (P.bRequired) RequiredArr.Add(MakeShared<FJsonValueString>(P.Name));
+		}
+		Details->SetArrayField(TEXT("required"), RequiredArr);
+
+		TArray<TSharedPtr<FJsonValue>> ProvidedArr;
+		for (const auto& Pair : OutParams->Values) ProvidedArr.Add(MakeShared<FJsonValueString>(Pair.Key));
+		Details->SetArrayField(TEXT("provided"), ProvidedArr);
+
+		if (Schema->ExampleParams.IsValid())
+		{
+			TSharedPtr<FJsonObject> ExampleCall = MakeShared<FJsonObject>();
+			ExampleCall->SetStringField(TEXT("type"), CommandType);
+			ExampleCall->SetObjectField(TEXT("params"), Schema->ExampleParams);
+			Details->SetObjectField(TEXT("exampleCall"), ExampleCall);
+		}
+
+		OutError = FUnrealMCPCommonUtils::CreateErrorResponse(FString::Printf(TEXT("Missing required parameter(s): %s"), *FString::Join(Missing, TEXT(", "))));
+		OutError->SetObjectField(TEXT("details"), Details);
+		return false;
+	}
+
+	return true;
+}
+
+TSharedPtr<FJsonObject> FUnrealMCPCommandSchemaRegistry::GetSchemaResponse(const FString& CommandTypeOrEmpty)
+{
+	TSharedPtr<FJsonObject> Out = MakeShared<FJsonObject>();
+	Out->SetNumberField(TEXT("schemaVersion"), kUnrealMcpSchemaVersion);
+
+	if (!CommandTypeOrEmpty.IsEmpty())
+	{
+		const FUnrealMCPCommandSchema* Schema = FindSchema(CommandTypeOrEmpty);
+		if (!Schema)
+		{
+			return FUnrealMCPCommonUtils::CreateErrorResponse(FString::Printf(TEXT("No schema found for command: %s"), *CommandTypeOrEmpty));
+		}
+		Out->SetObjectField(TEXT("schema"), Schema->ToJson());
+		return Out;
+	}
+
+	TArray<TSharedPtr<FJsonValue>> SchemasArr;
+	for (const auto& Pair : SchemaMap())
+	{
+		SchemasArr.Add(MakeShared<FJsonValueObject>(Pair.Value.ToJson()));
+	}
+	Out->SetArrayField(TEXT("schemas"), SchemasArr);
+	return Out;
+}
+
+TSharedPtr<FJsonObject> FUnrealMCPCommandSchemaRegistry::GetCapabilitiesResponse()
+{
+	TSharedPtr<FJsonObject> Out = MakeShared<FJsonObject>();
+	Out->SetNumberField(TEXT("schemaVersion"), kUnrealMcpSchemaVersion);
+
+	// Plugin descriptor (best-effort).
+	if (TSharedPtr<IPlugin> Plugin = IPluginManager::Get().FindPlugin(TEXT("UnrealMCP")))
+	{
+		const FPluginDescriptor& Descriptor = Plugin->GetDescriptor();
+		Out->SetStringField(TEXT("pluginName"), Plugin->GetName());
+		Out->SetStringField(TEXT("baseDir"), Plugin->GetBaseDir());
+		Out->SetStringField(TEXT("versionName"), Descriptor.VersionName);
+		Out->SetNumberField(TEXT("version"), Descriptor.Version);
+		Out->SetBoolField(TEXT("installed"), Descriptor.bInstalled);
+	}
+
+	TArray<TSharedPtr<FJsonValue>> Commands;
+	for (const FString& Cmd : GetSupportedCommands())
+	{
+		Commands.Add(MakeShared<FJsonValueString>(Cmd));
+	}
+	Out->SetArrayField(TEXT("commands"), Commands);
+
+	TSharedPtr<FJsonObject> Caps = MakeShared<FJsonObject>();
+	Caps->SetBoolField(TEXT("paramAliases"), true);
+	Caps->SetBoolField(TEXT("schemaDiscovery"), true);
+	Caps->SetBoolField(TEXT("vectorObjectInput"), true);
+	Caps->SetBoolField(TEXT("rotatorObjectInput"), true);
+	Caps->SetBoolField(TEXT("functionDiscovery"), true);
+	Out->SetObjectField(TEXT("capabilities"), Caps);
+
+	return Out;
+}