#pragma once #include "CoreMinimal.h" #include "Dom/JsonValue.h" #include "Dom/JsonObject.h" class FAnimationHandlers { public: static void RegisterHandlers(class FMCPHandlerRegistry& Registry); private: // Existing read-only queries static TSharedPtr ListAnimAssets(const TSharedPtr& Params); // Real-bone skeleton editing, in AnimationHandlers_Skeleton.cpp. Before // this the bridge could list bones and add virtual ones, and could not // touch a real bone at all. USkeletonModifier batches every hierarchy // change and writes only on commit, so the lifecycle is explicit the way // begin/apply/bake_control_rig_edit already is. static TSharedPtr BeginSkeletonEdit(const TSharedPtr& Params); // Creates a real USkeleton through USkeletonFactory and therefore assigns it // to the source mesh as the engine's Create Skeleton asset flow does. static TSharedPtr CreateSkeleton(const TSharedPtr& Params); static TSharedPtr EditSkeletonBones(const TSharedPtr& Params); static TSharedPtr CommitSkeletonEdit(const TSharedPtr& Params); static TSharedPtr CancelSkeletonEdit(const TSharedPtr& Params); static TSharedPtr SetBoneRetargeting(const TSharedPtr& Params); static TSharedPtr AuthorBlendProfile(const TSharedPtr& Params); static TSharedPtr EditCurveMetadata(const TSharedPtr& Params); static TSharedPtr RegisterCompatibleSkeleton(const TSharedPtr& Params); static TSharedPtr ListSkeletalMeshes(const TSharedPtr& Params); static TSharedPtr GetSkeletonInfo(const TSharedPtr& Params); static TSharedPtr ListSockets(const TSharedPtr& Params); static TSharedPtr GetPhysicsAssetInfo(const TSharedPtr& Params); // Read handlers for animation asset types static TSharedPtr ReadAnimBlueprint(const TSharedPtr& Params); static TSharedPtr ReadAnimMontage(const TSharedPtr& Params); static TSharedPtr ReadAnimSequence(const TSharedPtr& Params); static TSharedPtr ScanAnimationTracks(const TSharedPtr& Params); // Read handlers for blendspace static TSharedPtr ReadBlendspace(const TSharedPtr& Params); // Create handlers for animation asset types static TSharedPtr CreateAnimBlueprint(const TSharedPtr& Params); static TSharedPtr CreateMontage(const TSharedPtr& Params); static TSharedPtr AuthorMontagesBatch(const TSharedPtr& Params); static TSharedPtr CreateBlendspace(const TSharedPtr& Params); // #248: add a sample to a BlendSpace. static TSharedPtr AddBlendSample(const TSharedPtr& Params); // #272: move an existing sample to new coordinates / swap its animation. static TSharedPtr SetBlendSample(const TSharedPtr& Params); // #459: one-call axis-params + samples authoring for BlendSpace1D/2D. static TSharedPtr PopulateBlendspace(const TSharedPtr& Params); // #459 partner: explicit BlendSpace1D creation (defaults grid for 1D). static TSharedPtr CreateBlendspace1D(const TSharedPtr& Params); // Notify handlers static TSharedPtr AddAnimNotify(const TSharedPtr& Params); // #471: per-name removal so migration scripts can prune obsolete notifies // without scanning through Python's AnimationLibrary. static TSharedPtr RemoveAnimNotify(const TSharedPtr& Params); // Animation sequence authoring static TSharedPtr CreateSequence(const TSharedPtr& Params); static TSharedPtr SetBoneKeyframes(const TSharedPtr& Params); static TSharedPtr BakeKeyframesBatch(const TSharedPtr& Params); static TSharedPtr GetBoneTransforms(const TSharedPtr& Params); // #656: compare an animation/pose asset's curve names against a skeletal // mesh's morph target names and report matches/mismatches. static TSharedPtr CompareCurvesToMorphTargets(const TSharedPtr& Params); // Montage editing static TSharedPtr SetMontageSequence(const TSharedPtr& Params); static TSharedPtr SetMontageProperties(const TSharedPtr& Params); // State machine authoring static TSharedPtr CreateStateMachine(const TSharedPtr& Params); static TSharedPtr AddState(const TSharedPtr& Params); static TSharedPtr AddTransition(const TSharedPtr& Params); static TSharedPtr SetStateAnimation(const TSharedPtr& Params); static TSharedPtr SetTransitionBlend(const TSharedPtr& Params); static TSharedPtr SetTransitionCondition(const TSharedPtr& Params); static TSharedPtr ReadStateMachine(const TSharedPtr& Params); // AnimGraph inspection (#23 / #91) static TSharedPtr ReadAnimGraph(const TSharedPtr& Params); // #657: deep-dump the FAnimNode_* struct of anim graph nodes (PoseDriver // PoseTargets/PoseAsset/RBF params, etc.) that read_anim_graph omits. static TSharedPtr InspectAnimNodes(const TSharedPtr& Params); // Float curve authoring (#79 / #24) static TSharedPtr AddCurve(const TSharedPtr& Params); // #712: set float-curve key VALUES directly (add_curve only names an empty curve). static TSharedPtr SetAnimCurveKeys(const TSharedPtr& Params); // #712: instantiate + run a UAnimationModifier subclass on an AnimSequence // (e.g. DistanceCurveModifier to bake a Distance curve from root motion). static TSharedPtr ApplyAnimationModifier(const TSharedPtr& Params); // Montage slot & section editing (#78, #27) static TSharedPtr SetMontageSlot(const TSharedPtr& Params); static TSharedPtr AddMontageSection(const TSharedPtr& Params); // #826: multi-segment montage authoring. UAnimMontage::SlotAnimTracks is not // reachable from script, so appending a second animation to a slot has to // happen here. static TSharedPtr AddMontageSegment(const TSharedPtr& Params); static TSharedPtr RemoveMontageSegment(const TSharedPtr& Params); static TSharedPtr ListMontageSegments(const TSharedPtr& Params); // IK Rig (#93) static TSharedPtr CreateIKRig(const TSharedPtr& Params); static TSharedPtr ReadIKRig(const TSharedPtr& Params); // UE 5.8 full-body IK definition authoring over an existing IK Rig. static TSharedPtr ConfigureIKRig(const TSharedPtr& Params); // Control Rig (#11) static TSharedPtr ListControlRigVariables(const TSharedPtr& Params); // #774: full RigVM model inspection - nodes, pins, links, variable metadata. static TSharedPtr ReadControlRigGraph(const TSharedPtr& Params); // #619 per-element Control Rig hierarchy metadata (name, type, index, parent) static TSharedPtr ReadControlRigHierarchy(const TSharedPtr& Params); // UE 5.8 Control Rig editing in Sequencer. Source AnimSequences are read-only; // edits live in a LevelSequence until explicitly baked to a new AnimSequence. static TSharedPtr BeginControlRigEdit(const TSharedPtr& Params); static TSharedPtr ReadControlRigEdit(const TSharedPtr& Params); static TSharedPtr CaptureControlRigPose(const TSharedPtr& Params); static TSharedPtr ApplyControlRigEdits(const TSharedPtr& Params); static TSharedPtr BakeControlRigEdit(const TSharedPtr& Params); static TSharedPtr AnalyzeAnimation(const TSharedPtr& Params); // v0.7.11 - depth static TSharedPtr SetRootMotionSettings(const TSharedPtr& Params); static TSharedPtr AddVirtualBone(const TSharedPtr& Params); static TSharedPtr RemoveVirtualBone(const TSharedPtr& Params); static TSharedPtr CreateAnimComposite(const TSharedPtr& Params); static TSharedPtr ListAnimModifiers(const TSharedPtr& Params); // v0.7.11 - issue fixes static TSharedPtr CreateIKRetargeter(const TSharedPtr& Params); static TSharedPtr ReadIKRetargeter(const TSharedPtr& Params); // UE 5.8 retarget op, chain-map, preview-mesh and retarget-pose authoring. static TSharedPtr ConfigureIKRetargeter(const TSharedPtr& Params); // #701/#703: IK rig/retargeter authoring tail + batch retarget bake. static TSharedPtr SetIKRigMesh(const TSharedPtr& Params); static TSharedPtr SetIKRetargeterRig(const TSharedPtr& Params); static TSharedPtr AutoAlignRetargetPose(const TSharedPtr& Params); static TSharedPtr ResetRetargetPose(const TSharedPtr& Params); static TSharedPtr BatchRetargetAnimations(const TSharedPtr& Params); static TSharedPtr SetAnimBlueprintSkeleton(const TSharedPtr& Params); static TSharedPtr ReadBoneTrack(const TSharedPtr& Params); // v1.0.0-rc.2 - animation authoring gaps (#153, #154) static TSharedPtr SetSequenceProperties(const TSharedPtr& Params); static TSharedPtr BakeRootMotionFromBone(const TSharedPtr& Params); // v0.7.15 - PoseSearch (motion matching) static TSharedPtr CreatePoseSearchDatabase(const TSharedPtr& Params); static TSharedPtr SetPoseSearchSchema(const TSharedPtr& Params); static TSharedPtr AddPoseSearchSequence(const TSharedPtr& Params); // #684: bulk clip-list authoring with per-entry flags (mirror/reselection/sampling). static TSharedPtr SetPoseSearchClips(const TSharedPtr& Params); static TSharedPtr BuildPoseSearchIndex(const TSharedPtr& Params); static TSharedPtr ReadPoseSearchDatabase(const TSharedPtr& Params); // Motion Matching content pipeline: schema, mirror table, normalization set, // database tuning (AnimationHandlers_MotionMatching.cpp). static TSharedPtr CreatePoseSearchSchema(const TSharedPtr& Params); static TSharedPtr AddPoseSearchSchemaPoseChannel(const TSharedPtr& Params); static TSharedPtr AddPoseSearchSchemaTrajectoryChannel(const TSharedPtr& Params); static TSharedPtr ReadPoseSearchSchema(const TSharedPtr& Params); static TSharedPtr CreateMirrorDataTable(const TSharedPtr& Params); static TSharedPtr ReadMirrorDataTable(const TSharedPtr& Params); static TSharedPtr CreatePoseSearchNormalizationSet(const TSharedPtr& Params); static TSharedPtr SetPoseSearchDatabaseSettings(const TSharedPtr& Params); // Motion Matching runtime AnimGraph nodes. static TSharedPtr AddMotionMatchingNode(const TSharedPtr& Params); static TSharedPtr AddPoseHistoryNode(const TSharedPtr& Params); // Drive the MM node's Database from a ChooserTable (runtime database selection). static TSharedPtr SetMotionMatchingChooser(const TSharedPtr& Params); // #713 - distance-matching graph authoring // Add a Sequence Evaluator node (explicit-time player distance matching drives). static TSharedPtr AddSequenceEvaluator(const TSharedPtr& Params); // Bind a thread-safe anim-node function to a node's OnUpdate/OnBecomeRelevant/ // OnInitialUpdate (the mechanism distance matching uses to advance the evaluator). static TSharedPtr BindAnimNodeFunction(const TSharedPtr& Params); // #419/#420 - live-actor skeletal reads + rebind + preview (moved from Level) static TSharedPtr GetBoneTransform(const TSharedPtr& Params); static TSharedPtr ListBones(const TSharedPtr& Params); static TSharedPtr RebindLeaderPose(const TSharedPtr& Params); static TSharedPtr PreviewAnimation(const TSharedPtr& Params); // Live-only post-process AnimBP override. This deliberately targets a // spawned/placed component, never a mesh or component-template asset. static TSharedPtr SetLivePostProcessAnimBlueprint(const TSharedPtr& Params); // Animation authoring depth, in AnimationHandlers_Depth.cpp. The removal // half of the surface plus the two things that could not be authored at // all. Five adds already documented their own missing inverse in a source // comment ("No rollback: no paired remove_* handler"); those are the five // removals here. set_state_machine_entry is the one that made state // machines work: nothing ever wired the entry node, so a machine authored // through the bridge had no initial state and output the reference pose. static TSharedPtr SetStateMachineEntry(const TSharedPtr& Params); static TSharedPtr RemoveState(const TSharedPtr& Params); static TSharedPtr RemoveTransition(const TSharedPtr& Params); static TSharedPtr RemoveStateMachine(const TSharedPtr& Params); static TSharedPtr RemoveMontageSection(const TSharedPtr& Params); static TSharedPtr RemoveAnimCurve(const TSharedPtr& Params); // Windowed notifies. add_anim_notify only ever writes FAnimNotifyEvent::Notify, // so a notify STATE (NotifyStateClass + Duration + EndLink) had no route in, // and remove_anim_notify's class filter cannot see one either. static TSharedPtr AddNotifyState(const TSharedPtr& Params); static TSharedPtr RemoveNotifyState(const TSharedPtr& Params); // Sync markers: apply, refresh, register on the skeleton, read back. A raw // property write reaches AuthoredSyncMarkers and leaves it inert. static TSharedPtr SetSyncMarkers(const TSharedPtr& Params); // #922/#926 - the evaluated pose off a live SkeletalMeshComponent, for a set // of bones at once. Lives in AnimationHandlers_SkeletalLive.cpp. static TSharedPtr GetLiveBoneTransforms(const TSharedPtr& Params); // #923/#926/#922 - evaluated pose reads off an asset. Live in // AnimationHandlers_Pose.cpp. // Evaluate an AnimSequence (or a BlendSpace at a blend position) at given // frames or times and return composed transforms. static TSharedPtr SamplePose(const TSharedPtr& Params); // Planted-foot speed of a clip, which every retarget changes by the target // skeleton's leg-length ratio and so has to be re-measured per clip. static TSharedPtr MeasureNaturalSpeed(const TSharedPtr& Params); };