ue-mcp 1.0.70 → 1.0.71

package/README.md

@@ -1,6 +1,6 @@
 # UE-MCP
 
-**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->545+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
+**Unreal Engine Model Context Protocol Server** - gives AI assistants deep read/write access to the Unreal Editor through <!-- count:tools -->21<!-- /count --> category tools covering <!-- count:actions -->547+<!-- /count --> actions, plus a YAML flow engine for multi-step workflows.
 
 ```mermaid
 flowchart LR
@@ -57,7 +57,7 @@ If you prefer to configure manually, add to your MCP client config:
 
 - [Getting Started](https://db-lyon.github.io/ue-mcp/getting-started/) — Installation, configuration, first run
 - [Architecture](https://db-lyon.github.io/ue-mcp/architecture/) — How the pieces fit together
-- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->545+<!-- /count --> actions
+- [Tool Reference](https://db-lyon.github.io/ue-mcp/tool-reference/) - All <!-- count:tools -->21<!-- /count --> tools with <!-- count:actions -->547+<!-- /count --> actions
 - [Flows](https://db-lyon.github.io/ue-mcp/flows/) - YAML flow engine, custom tasks, rollback, hooks
 - [Configuration](https://db-lyon.github.io/ue-mcp/configuration/) — `.ue-mcp.json` and MCP client config
 - [Neon Shrine Demo](https://db-lyon.github.io/ue-mcp/neon-shrine-demo/) — Interactive guided demo

package/dist/tool-counts.json

@@ -1,7 +1,7 @@
 {
   "tools": 21,
-  "actions": 545,
-  "bridgeActions": 517,
+  "actions": 547,
+  "bridgeActions": 519,
   "localActions": 28,
   "perTool": {
     "project": 25,
@@ -19,13 +19,13 @@
     "editor": 54,
     "reflection": 8,
     "gameplay": 53,
-    "gas": 12,
+    "gas": 14,
     "networking": 11,
     "demo": 3,
     "feedback": 1,
     "statetree": 35,
     "plugins": 2
   },
-  "generatedAt": "2026-05-29T20:36:26.666Z",
-  "version": "1.0.70"
+  "generatedAt": "2026-05-29T20:48:42.832Z",
+  "version": "1.0.71"
 }

package/dist/tools/gas.js

@@ -10,9 +10,11 @@ export const gasTool = categoryTool("gas", "Gameplay Ability System: abilities,
     set_effect_modifier: bp("Add modifier. Params: effectPath, attribute, operation?, magnitude?", "set_effect_modifier"),
     create_cue: bp("Create GameplayCue. Params: name, packagePath?, cueType?", "create_gameplay_cue"),
     get_info: bp("Inspect GAS setup. Params: blueprintPath", "get_gas_info"),
+    set_asc_defaults: bp("Wire an AttributeSet onto a Blueprint's ASC component (DefaultStartingData) so attributes exist at runtime. Params: blueprintPath, attributeSet (content path or class name), componentName?, initDataTable? (starting values). Run add_ability_system_component first.", "set_asc_defaults"),
     apply_effect: bp("Apply a GameplayEffect to a live actor's ASC (agnostic stat/damage stimulus - uses the game's own effect). Params: actorLabel, effectClass (content path or class name), level?, setByCaller? ({tag-or-name: magnitude}), world? (auto|pie|editor, default auto)", "apply_effect"),
     set_attribute: bp("Set a gameplay attribute's base value on a live actor's ASC (recalculates CurrentValue through the aggregator). Params: actorLabel, attribute (Health | SetName.Health), value, world?", "set_attribute"),
     get_attribute: bp("Read gameplay attribute base + current values on a live actor's ASC. Omit attribute to list all. Params: actorLabel, attribute?, world?", "get_attribute"),
+    init_asc: bp("Initialize a live actor's ASC (InitAbilityActorInfo) and optionally instantiate an AttributeSet so attributes are live - the runtime setup step for testing a bridge-authored GAS actor. Params: actorLabel, attributeSet? (content path or class name), world?", "init_asc"),
 }, undefined, {
     blueprintPath: z.string().optional(),
     name: z.string().optional(),
@@ -41,5 +43,7 @@ export const gasTool = categoryTool("gas", "Gameplay Ability System: abilities,
     setByCaller: z.record(z.number()).optional().describe("apply_effect: SetByCaller magnitudes keyed by gameplay tag or name"),
     value: z.number().optional().describe("set_attribute: new base value"),
     world: z.string().optional().describe("Runtime world scope: auto (default) | pie | editor"),
+    attributeSet: z.string().optional().describe("set_asc_defaults / init_asc: AttributeSet content path or class name"),
+    initDataTable: z.string().optional().describe("set_asc_defaults: optional DataTable of starting attribute values"),
 });
 //# sourceMappingURL=gas.js.map

package/dist/tools/gas.js.map

@@ -1 +1 @@
-{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/tools/gas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gas.js","sourceRoot":"","sources":["../../src/tools/gas.ts"],"names":[],"mappings":"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"}

package/dist/ue-mcp.default.yml

@@ -2927,6 +2927,12 @@ tasks:
     description: "Inspect GAS setup. Params: blueprintPath"
     options:
       method: get_gas_info
+  gas.set_asc_defaults:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Wire an AttributeSet onto a Blueprint's ASC component (DefaultStartingData) so attributes exist at runtime. Params: blueprintPath, attributeSet (content path or class name), componentName?, initDataTable? (starting values). Run add_ability_system_component first."
+    options:
+      method: set_asc_defaults
   gas.apply_effect:
     class_path: ue-mcp.bridge
     group: gas
@@ -2945,6 +2951,12 @@ tasks:
     description: "Read gameplay attribute base + current values on a live actor's ASC. Omit attribute to list all. Params: actorLabel, attribute?, world?"
     options:
       method: get_attribute
+  gas.init_asc:
+    class_path: ue-mcp.bridge
+    group: gas
+    description: "Initialize a live actor's ASC (InitAbilityActorInfo) and optionally instantiate an AttributeSet so attributes are live - the runtime setup step for testing a bridge-authored GAS actor. Params: actorLabel, attributeSet? (content path or class name), world?"
+    options:
+      method: init_asc
 
   # ── networking ──
   networking.set_replicates:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ue-mcp",
-  "version": "1.0.70",
-  "description": "Unreal Engine MCP server - 21 tools, 545+ actions for AI-driven editor control",
+  "version": "1.0.71",
+  "description": "Unreal Engine MCP server - 21 tools, 547+ actions for AI-driven editor control",
   "type": "module",
   "main": "dist/index.js",
   "exports": {

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

@@ -21,6 +21,9 @@
 #include "Engine/SimpleConstructionScript.h"
 #include "Engine/SCS_Node.h"
 #include "EdGraphSchema_K2.h"
+#include "AbilitySystemComponent.h"
+#include "AttributeSet.h"
+#include "Engine/DataTable.h"
 
 void FGasHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 {
@@ -33,9 +36,11 @@ void FGasHandlers::RegisterHandlers(FMCPHandlerRegistry& Registry)
 	Registry.RegisterHandler(TEXT("add_attribute"), &AddAttribute);
 	Registry.RegisterHandler(TEXT("set_ability_tags"), &SetAbilityTags);
 	Registry.RegisterHandler(TEXT("set_effect_modifier"), &SetEffectModifier);
+	Registry.RegisterHandler(TEXT("set_asc_defaults"), &SetAscDefaults);
 	Registry.RegisterHandler(TEXT("apply_effect"), &ApplyEffect);
 	Registry.RegisterHandler(TEXT("set_attribute"), &SetAttribute);
 	Registry.RegisterHandler(TEXT("get_attribute"), &GetAttribute);
+	Registry.RegisterHandler(TEXT("init_asc"), &InitAsc);
 }
 
 TSharedPtr<FJsonValue> FGasHandlers::CreateGasBlueprint(
@@ -376,3 +381,109 @@ TSharedPtr<FJsonValue> FGasHandlers::SetEffectModifier(const TSharedPtr<FJsonObj
 	Result->SetStringField(TEXT("note"), TEXT("GameplayEffect modifier configuration set. Use execute_python for full GE modifier array manipulation."));
 	return MCPResult(Result);
 }
+
+TSharedPtr<FJsonValue> FGasHandlers::SetAscDefaults(const TSharedPtr<FJsonObject>& Params)
+{
+	FString BPPath;
+	if (auto Err = RequireString(Params, TEXT("blueprintPath"), BPPath)) return Err;
+
+	FString AttrSetSpec;
+	if (auto Err = RequireStringAlt(Params, TEXT("attributeSet"), TEXT("attributeSetPath"), AttrSetSpec)) return Err;
+
+	UBlueprint* BP = Cast<UBlueprint>(UEditorAssetLibrary::LoadAsset(BPPath));
+	if (!BP) return MCPError(FString::Printf(TEXT("Blueprint not found: %s"), *BPPath));
+
+	UClass* ASCClass = FindObject<UClass>(nullptr, TEXT("/Script/GameplayAbilities.AbilitySystemComponent"));
+	if (!ASCClass) return MCPError(TEXT("AbilitySystemComponent not found. Enable GameplayAbilities plugin."));
+
+	// Resolve the AttributeSet class from a content path (BP generated class) or
+	// a native short name.
+	UClass* AttrSetClass = nullptr;
+	{
+		UClass* AttrBase = UAttributeSet::StaticClass();
+		auto Ok = [AttrBase](UClass* C) { return C && C->IsChildOf(AttrBase); };
+		if (AttrSetSpec.Contains(TEXT("/")))
+		{
+			if (UClass* C = LoadObject<UClass>(nullptr, *AttrSetSpec); Ok(C)) AttrSetClass = C;
+			if (!AttrSetClass)
+			{
+				FString AssetName;
+				AttrSetSpec.Split(TEXT("/"), nullptr, &AssetName, ESearchCase::CaseSensitive, ESearchDir::FromEnd);
+				if (UClass* C = LoadObject<UClass>(nullptr, *(AttrSetSpec + TEXT(".") + AssetName + TEXT("_C"))); Ok(C)) AttrSetClass = C;
+			}
+			if (!AttrSetClass)
+			{
+				if (UBlueprint* SetBP = Cast<UBlueprint>(UEditorAssetLibrary::LoadAsset(AttrSetSpec)))
+				{
+					if (Ok(SetBP->GeneratedClass)) AttrSetClass = SetBP->GeneratedClass;
+				}
+			}
+		}
+		else if (UClass* C = FindClassByShortName(AttrSetSpec); Ok(C))
+		{
+			AttrSetClass = C;
+		}
+	}
+	if (!AttrSetClass) return MCPError(FString::Printf(TEXT("AttributeSet class not found: %s"), *AttrSetSpec));
+
+	// Find the ASC component template on the blueprint's construction script.
+	const FString CompName = OptionalString(Params, TEXT("componentName"));
+	UAbilitySystemComponent* ASCTemplate = nullptr;
+	FString ResolvedComp;
+	if (BP->SimpleConstructionScript)
+	{
+		for (USCS_Node* N : BP->SimpleConstructionScript->GetAllNodes())
+		{
+			if (!N || !N->ComponentTemplate || !N->ComponentTemplate->IsA(ASCClass)) continue;
+			if (!CompName.IsEmpty() && N->GetVariableName() != FName(*CompName)) continue;
+			ASCTemplate = Cast<UAbilitySystemComponent>(N->ComponentTemplate);
+			ResolvedComp = N->GetVariableName().ToString();
+			break;
+		}
+	}
+	if (!ASCTemplate)
+	{
+		return MCPError(TEXT("No AbilitySystemComponent on the blueprint - run add_ability_system_component first"));
+	}
+
+	// Optional init DataTable (production path: starting values at ASC init).
+	UDataTable* InitTable = nullptr;
+	const FString TablePath = OptionalString(Params, TEXT("initDataTable"));
+	if (!TablePath.IsEmpty())
+	{
+		InitTable = LoadObject<UDataTable>(nullptr, *TablePath);
+		if (!InitTable) return MCPError(FString::Printf(TEXT("initDataTable not found: %s"), *TablePath));
+	}
+
+	// Idempotency: already wired for this attribute set?
+	for (const FAttributeDefaults& D : ASCTemplate->DefaultStartingData)
+	{
+		if (D.Attributes == AttrSetClass)
+		{
+			auto Existed = MCPSuccess();
+			MCPSetExisted(Existed);
+			Existed->SetStringField(TEXT("blueprintPath"), BPPath);
+			Existed->SetStringField(TEXT("component"), ResolvedComp);
+			Existed->SetStringField(TEXT("attributeSet"), AttrSetClass->GetName());
+			return MCPResult(Existed);
+		}
+	}
+
+	FAttributeDefaults Def;
+	Def.Attributes = AttrSetClass;
+	Def.DefaultStartingTable = InitTable;
+	ASCTemplate->DefaultStartingData.Add(Def);
+
+	FKismetEditorUtilities::CompileBlueprint(BP);
+	SaveAssetPackage(BP);
+
+	auto Result = MCPSuccess();
+	MCPSetCreated(Result);
+	Result->SetStringField(TEXT("blueprintPath"), BPPath);
+	Result->SetStringField(TEXT("component"), ResolvedComp);
+	Result->SetStringField(TEXT("attributeSet"), AttrSetClass->GetName());
+	if (InitTable) Result->SetStringField(TEXT("initDataTable"), InitTable->GetPathName());
+	Result->SetStringField(TEXT("note"),
+		TEXT("Attribute set wired to the ASC's DefaultStartingData. If attributes aren't live at runtime, call gas(action=\"init_asc\", attributeSet=...) after PIE starts."));
+	return MCPResult(Result);
+}

package/plugin/ue_mcp_bridge/Source/UE_MCP_Bridge/Private/Handlers/GasHandlers.h

@@ -33,9 +33,16 @@ private:
 	static TSharedPtr<FJsonValue> SetAbilityTags(const TSharedPtr<FJsonObject>& Params);
 	static TSharedPtr<FJsonValue> SetEffectModifier(const TSharedPtr<FJsonObject>& Params);
 
+	// Wire an AttributeSet (with optional init DataTable) onto a Blueprint's ASC
+	// component template via DefaultStartingData. Authoring; in GasHandlers.cpp.
+	static TSharedPtr<FJsonValue> SetAscDefaults(const TSharedPtr<FJsonObject>& Params);
+
 	// Runtime GAS control (operates on a live actor's AbilitySystemComponent,
 	// PIE by default). Implemented in GasHandlers_Runtime.cpp.
 	static TSharedPtr<FJsonValue> ApplyEffect(const TSharedPtr<FJsonObject>& Params);
 	static TSharedPtr<FJsonValue> SetAttribute(const TSharedPtr<FJsonObject>& Params);
 	static TSharedPtr<FJsonValue> GetAttribute(const TSharedPtr<FJsonObject>& Params);
+	// InitAbilityActorInfo + optionally GetOrCreateAttributeSubobject on a live
+	// actor, so a bridge-authored GAS actor has live attributes to test against.
+	static TSharedPtr<FJsonValue> InitAsc(const TSharedPtr<FJsonObject>& Params);
 };

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

@@ -109,30 +109,29 @@ namespace
 		Obj->SetNumberField(TEXT("currentValue"), ASC->GetNumericAttribute(Attr));
 	}
 
-	// Resolve a UGameplayEffect subclass from a content path or short class name.
-	UClass* ResolveEffectClass(const FString& Spec)
+	// Resolve a UClass deriving from Base from a content path or short class name.
+	// Handles native classes, Blueprint generated classes (path + "_C"), and a
+	// Blueprint-asset fallback. Returns nullptr unless the result is a Base subclass.
+	UClass* ResolveClassDeriving(const FString& Spec, UClass* Base)
 	{
-		auto IsEffect = [](UClass* C) { return C && C->IsChildOf(UGameplayEffect::StaticClass()); };
+		auto Ok = [Base](UClass* C) { return C && Base && C->IsChildOf(Base); };
 
 		if (Spec.Contains(TEXT("/")))
 		{
-			// Direct class load (native or already-_C class path).
-			if (UClass* C = LoadObject<UClass>(nullptr, *Spec); IsEffect(C)) return C;
-			// Blueprint generated class: "/Game/Foo/GE_Bar" -> ".../GE_Bar.GE_Bar_C".
+			if (UClass* C = LoadObject<UClass>(nullptr, *Spec); Ok(C)) return C;
 			FString AssetName;
 			Spec.Split(TEXT("/"), nullptr, &AssetName, ESearchCase::CaseSensitive, ESearchDir::FromEnd);
 			const FString ClassPath = Spec + TEXT(".") + AssetName + TEXT("_C");
-			if (UClass* C = LoadObject<UClass>(nullptr, *ClassPath); IsEffect(C)) return C;
-			// Fall back to loading the Blueprint and taking its generated class.
+			if (UClass* C = LoadObject<UClass>(nullptr, *ClassPath); Ok(C)) return C;
 			if (UBlueprint* BP = LoadAssetByPath<UBlueprint>(Spec))
 			{
-				if (IsEffect(BP->GeneratedClass)) return BP->GeneratedClass;
+				if (Ok(BP->GeneratedClass)) return BP->GeneratedClass;
 			}
 			return nullptr;
 		}
 
 		UClass* C = FindClassByShortName(Spec);
-		return IsEffect(C) ? C : nullptr;
+		return Ok(C) ? C : nullptr;
 	}
 }
 
@@ -148,7 +147,7 @@ TSharedPtr<FJsonValue> FGasHandlers::ApplyEffect(const TSharedPtr<FJsonObject>&
 	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
 	if (!ASC) return Err;
 
-	UClass* EffectClass = ResolveEffectClass(EffectSpec);
+	UClass* EffectClass = ResolveClassDeriving(EffectSpec, UGameplayEffect::StaticClass());
 	if (!EffectClass)
 	{
 		return MCPError(FString::Printf(
@@ -298,3 +297,64 @@ TSharedPtr<FJsonValue> FGasHandlers::GetAttribute(const TSharedPtr<FJsonObject>&
 	Result->SetNumberField(TEXT("count"), Rows.Num());
 	return MCPResult(Result);
 }
+
+TSharedPtr<FJsonValue> FGasHandlers::InitAsc(const TSharedPtr<FJsonObject>& Params)
+{
+	MCP_CHECK_GAME_THREAD();
+
+	AActor* Actor = nullptr;
+	TSharedPtr<FJsonValue> Err;
+	UAbilitySystemComponent* ASC = ResolveASC(Params, Actor, Err);
+	if (!ASC) return Err;
+
+	// Establish owner/avatar so abilities activate and effect contexts target
+	// correctly. Safe to call again; a game's own pawn may also init the ASC.
+	ASC->InitAbilityActorInfo(Actor, Actor);
+
+	// Optionally guarantee an attribute set exists on the ASC. This is what lets
+	// a bridge-authored test actor have live attributes without shipping an init
+	// DataTable: spawn the set (with its default values) and register it if it
+	// isn't already present. GetOrCreateAttributeSubobject is protected, so use
+	// the public GetAttributeSet + AddSpawnedAttribute pair.
+	FString CreatedSet;
+	const FString AttrSetSpec = OptionalString(Params, TEXT("attributeSet"));
+	if (!AttrSetSpec.IsEmpty())
+	{
+		UClass* AttrSetClass = ResolveClassDeriving(AttrSetSpec, UAttributeSet::StaticClass());
+		if (!AttrSetClass)
+		{
+			return MCPError(FString::Printf(
+				TEXT("AttributeSet class not found: %s (pass a content path or class name)"), *AttrSetSpec));
+		}
+		const UAttributeSet* Existing = ASC->GetAttributeSet(AttrSetClass);
+		if (!Existing)
+		{
+			UAttributeSet* NewSet = NewObject<UAttributeSet>(Actor, AttrSetClass);
+			ASC->AddSpawnedAttribute(NewSet);
+			CreatedSet = NewSet->GetClass()->GetName();
+		}
+		else
+		{
+			CreatedSet = Existing->GetClass()->GetName();
+		}
+	}
+
+	// Count attributes now live across all spawned sets.
+	int32 AttrCount = 0;
+	for (const UAttributeSet* Set : ASC->GetSpawnedAttributes())
+	{
+		if (!Set) continue;
+		for (TFieldIterator<FProperty> It(Set->GetClass()); It; ++It)
+		{
+			FStructProperty* SProp = CastField<FStructProperty>(*It);
+			if (SProp && SProp->Struct == FGameplayAttributeData::StaticStruct()) ++AttrCount;
+		}
+	}
+
+	auto Result = MCPSuccess();
+	Result->SetStringField(TEXT("actorLabel"), Actor->GetActorLabel());
+	Result->SetBoolField(TEXT("initialized"), true);
+	if (!CreatedSet.IsEmpty()) Result->SetStringField(TEXT("attributeSet"), CreatedSet);
+	Result->SetNumberField(TEXT("attributeCount"), AttrCount);
+	return MCPResult(Result);
+}