#pragma once #include "CoreMinimal.h" #include "Dom/JsonValue.h" #include "Dom/JsonObject.h" class UBehaviorTree; class UBlackboardData; class UBTNode; class FGameplayHandlers { public: static void RegisterHandlers(class FMCPHandlerRegistry& Registry); // Environment Query System authoring and execution, in // GameplayHandlers_EQS.cpp. The bridge could create an EQS asset and list // the ones that exist; a query with no generator produces no items, so // what it could create was an empty asset. // // There are no typed setters for generator or test parameters on purpose: // every tunable is a UPROPERTY, read_eqs_query returns each object's path, // and editor(set_property) writes a property at an object path. static TSharedPtr ListEqsTypes(const TSharedPtr& Params); static TSharedPtr ReadEqsQuery(const TSharedPtr& Params); static TSharedPtr AddEqsGenerator(const TSharedPtr& Params); static TSharedPtr AddEqsTest(const TSharedPtr& Params); static TSharedPtr RemoveEqsTest(const TSharedPtr& Params); static TSharedPtr RemoveEqsOption(const TSharedPtr& Params); // BehaviorTree RUNTIME, in GameplayHandlers_BTRuntime.cpp. The authoring // actions build a tree; these answer whether it actually runs, which is // what "authored a tree, cannot tell whether it works" needed. static TSharedPtr GetBtRuntime(const TSharedPtr& Params); static TSharedPtr GetLiveBlackboard(const TSharedPtr& Params); static TSharedPtr SetLiveBlackboard(const TSharedPtr& Params); static TSharedPtr RunBehaviorTree(const TSharedPtr& Params); static TSharedPtr StopBehaviorTree(const TSharedPtr& Params); static TSharedPtr ListAiAgents(const TSharedPtr& Params); // AI Perception readback and runtime, in GameplayHandlers_Perception.cpp. // No per-parameter sense setters: every tunable is a UPROPERTY and // read_perception returns each sense config's objectPath for set_property. static TSharedPtr ReadPerception(const TSharedPtr& Params); static TSharedPtr RemoveSense(const TSharedPtr& Params); static TSharedPtr GetPerceivedActors(const TSharedPtr& Params); static TSharedPtr CheckPerception(const TSharedPtr& Params); static TSharedPtr ReportNoiseEvent(const TSharedPtr& Params); static TSharedPtr ReorderEqsTests(const TSharedPtr& Params); static TSharedPtr RunEqsQuery(const TSharedPtr& Params); // BehaviorTree introspection primitives, shared by the BT handlers and // exercised directly by the automation tests in Private/Tests, which build // nodes in memory rather than round-tripping an asset through disk. // Definitions live in GameplayHandlers_BehaviorTree.cpp. /** Every key on a Blackboard asset: name, type, sync flag, description. */ static TArray> DescribeBlackboardKeys(const UBlackboardData* Blackboard); /** One BT node as JSON: identity, decorator configuration (#888), and the * node's own UPROPERTY values when asked for (#919). PropertyFilter holds * lowercased property names; empty means "everything the node class adds". */ static TSharedPtr DescribeBTNode( UBTNode* Node, const FString& NodePath, const FString& ParentPath, bool bIncludeProperties, bool bIncludeInherited, const TSet& PropertyFilter); /** Read one dotted/indexed property path off a BT node. A UE 5.8 * FValueOrBBKey_* field comes back unpacked into defaultValue + key. */ static TSharedPtr ReadBTNodeProperty(UBTNode* Node, const FString& PropertyPath, FString& OutError); /** Write one dotted/indexed property path on a BT node. A scalar aimed at a * FValueOrBBKey_* field lands on its DefaultValue; a class-valued leaf * accepts a short name, a /Script path or a Blueprint asset path. */ static bool WriteBTNodeProperty(UBTNode* Node, const FString& PropertyPath, const TSharedPtr& Value, FString& OutError); /** Load a BehaviorTree from a caller-supplied asset path, or null. */ static UBehaviorTree* LoadBehaviorTree(const FString& AssetPath); /** Every runtime node in a compiled tree, keyed by the structural address * the read surface reports ("Root.Children[0].Decorators[1]"). * * #889 authoring addresses editor-graph nodes by guid, but a caller who * just read the tree holds these addresses instead, so both surfaces walk * this one map rather than growing a second scheme. Defined next to the * walker it wraps in GameplayHandlers_BehaviorTree.cpp. */ static void MapBTNodeAddresses(UBehaviorTree* Tree, TMap& OutAddresses); private: static TSharedPtr CreateSmartObjectDefinition(const TSharedPtr& Params); // #778: per-player Enhanced Input applied mapping contexts, per PIE world. static TSharedPtr GetInputMappingContexts(const TSharedPtr& Params); static TSharedPtr GetNavmeshInfo(const TSharedPtr& Params); static TSharedPtr GetGameFrameworkInfo(const TSharedPtr& Params); static TSharedPtr ListInputAssets(const TSharedPtr& Params); static TSharedPtr ListBehaviorTrees(const TSharedPtr& Params); static TSharedPtr ListEqsQueries(const TSharedPtr& Params); static TSharedPtr ListStateTrees(const TSharedPtr& Params); static TSharedPtr ProjectPointToNavigation(const TSharedPtr& Params); // Enhanced Input asset authoring lives here (core authoring, not test // automation). pie-studio handles PIE record/replay/inject of inputs. static TSharedPtr CreateInputAction(const TSharedPtr& Params); static TSharedPtr CreateInputMappingContext(const TSharedPtr& Params); static TSharedPtr ReadImc(const TSharedPtr& Params); // #604 read a live PIE player's applied Input Mapping Contexts static TSharedPtr AddImcMapping(const TSharedPtr& Params); static TSharedPtr SetMappingModifiers(const TSharedPtr& Params); static TSharedPtr RemoveImcMapping(const TSharedPtr& Params); static TSharedPtr SetImcMappingKey(const TSharedPtr& Params); static TSharedPtr SetImcMappingAction(const TSharedPtr& Params); // Enhanced Input depth (V11), in GameplayHandlers_Input.cpp. No typed // setters for ValueType, the consumption flags, AccumulationBehavior or // any tunable on an existing trigger/modifier: those are UPROPERTYs and // read_input_action returns the objectPath editor(set_property) writes at. // set_action_triggers earns its place because the ACTION's own Triggers // and Modifiers are Instanced arrays, and the JSON property setter can // only assign an object it can LOAD FROM A PATH, never mint one. static TSharedPtr ReadInputAction(const TSharedPtr& Params); static TSharedPtr SetActionTriggers(const TSharedPtr& Params); static TSharedPtr ApplyMappingContext(const TSharedPtr& Params); static TSharedPtr RemoveMappingContext(const TSharedPtr& Params); static TSharedPtr GetActionValue(const TSharedPtr& Params); static TSharedPtr ValidateInput(const TSharedPtr& Params); // Mass Entity trait-list CRUD and Zone Graph lane queries (T18), in // GameplayHandlers_Mass.cpp. Creation and trait authoring already ship in // MassHandlers.cpp (ensure_mass_entity_config / read_mass_entity_config); // these are the removal, reorder, discovery, audit and query halves that // no property write can reach. Mass and ZoneGraph classes are resolved by // reflection so the bridge still loads where those plugins are off. static TSharedPtr ListMassTypes(const TSharedPtr& Params); static TSharedPtr RemoveMassTrait(const TSharedPtr& Params); static TSharedPtr ReorderMassTraits(const TSharedPtr& Params); static TSharedPtr ValidateMassEntityConfig(const TSharedPtr& Params); static TSharedPtr QueryZoneGraph(const TSharedPtr& Params); static TSharedPtr CreateBlackboard(const TSharedPtr& Params); static TSharedPtr CreateBehaviorTree(const TSharedPtr& Params); static TSharedPtr CreateEqsQuery(const TSharedPtr& Params); static TSharedPtr CreateStateTree(const TSharedPtr& Params); // #654: read a running StateTreeComponent's active state names in PIE. static TSharedPtr GetStateTreeRuntime(const TSharedPtr& Params); static TSharedPtr CreateGameMode(const TSharedPtr& Params); static TSharedPtr CreateGameState(const TSharedPtr& Params); static TSharedPtr CreatePlayerController(const TSharedPtr& Params); static TSharedPtr CreatePlayerState(const TSharedPtr& Params); static TSharedPtr CreateHud(const TSharedPtr& Params); static TSharedPtr SpawnNavModifierVolume(const TSharedPtr& Params); static TSharedPtr RebuildNavmesh(const TSharedPtr& Params); // #424: synchronous path query + invoker enumeration. static TSharedPtr FindNavPath(const TSharedPtr& Params); static TSharedPtr ListNavInvokers(const TSharedPtr& Params); static TSharedPtr SetWorldGameMode(const TSharedPtr& Params); static TSharedPtr AddBlackboardKey(const TSharedPtr& Params); // #469: child-of-parent blackboard pattern + per-key removal + read. static TSharedPtr SetBlackboardParent(const TSharedPtr& Params); static TSharedPtr RemoveBlackboardKey(const TSharedPtr& Params); static TSharedPtr ReadBlackboard(const TSharedPtr& Params); // #494: discover available BT node classes so authoring scripts can // build asset-specific BTs without grepping the engine source. static TSharedPtr ListBTNodeClasses(const TSharedPtr& Params); // #250: rebind a BehaviorTree asset's BlackboardAsset (the C++ field is // protected, so reflection is the only way to write it cleanly). static TSharedPtr SetBehaviorTreeBlackboard(const TSharedPtr& Params); static TSharedPtr GetBehaviorTreeInfo(const TSharedPtr& Params); static TSharedPtr AddPerceptionComponent(const TSharedPtr& Params); static TSharedPtr ConfigureAiPerceptionSense(const TSharedPtr& Params); static TSharedPtr AddStateTreeComponent(const TSharedPtr& Params); static TSharedPtr AddSmartObjectComponent(const TSharedPtr& Params); // #416: slot authoring on USmartObjectDefinition via UPROPERTY reflection // (no Build.cs dependency on SmartObjectsModule). static TSharedPtr AddSmartObjectSlot(const TSharedPtr& Params); static TSharedPtr SetSmartObjectSlot(const TSharedPtr& Params); static TSharedPtr RemoveSmartObjectSlot(const TSharedPtr& Params); static TSharedPtr ListSmartObjectSlots(const TSharedPtr& Params); static TSharedPtr AddSmartObjectSlotBehavior(const TSharedPtr& Params); static TSharedPtr AddSmartObjectDefaultBehavior(const TSharedPtr& Params); // IMC read/write, PIE inspection, anim state, subsystem state - moved to pie-studio // Helper to create a blueprint with a given parent class static TSharedPtr CreateBlueprintWithParent(const FString& Name, const FString& PackagePath, const FString& ParentClassPath, const FString& FriendlyTypeName); // v0.7.11 - BT graph traversal (#124), decorator configuration added (#888) static TSharedPtr ReadBehaviorTreeGraph(const TSharedPtr& Params); // #919: pick BT nodes by class/name/path/kind and return their UPROPERTY // values, instead of an unfiltered whole-asset property dump. static TSharedPtr ReadBTNodeProperties(const TSharedPtr& Params); // #940: inventory BTTask nodes across one asset or a directory, including // the UE 5.8 FValueOrBBKey_Class shape of BTTask_MoveTo::FilterClass. static TSharedPtr ListBTTasks(const TSharedPtr& Params); // #919/#940: scoped nested write onto one owned BT node subobject. // Registered as both set_bt_node_property and set_bt_task_property. static TSharedPtr SetBTNodeProperty(const TSharedPtr& Params); // #889/#947: BehaviorTree editor-graph authoring. These drive // UBehaviorTreeGraph and its node classes, then recompile the graph into // the runnable UBTCompositeNode tree, which is the step no reflected // runtime API can perform. Definitions in GameplayHandlers_BTAuthoring.cpp. static TSharedPtr ListBTGraphNodes(const TSharedPtr& Params); static TSharedPtr AddBTNode(const TSharedPtr& Params); static TSharedPtr MoveBTNode(const TSharedPtr& Params); static TSharedPtr RemoveBTNode(const TSharedPtr& Params); // #163 - detailed navmesh configuration static TSharedPtr GetNavmeshDetails(const TSharedPtr& Params); // ApplyDamageInPie moved to pie-studio };