第一次提交

2026-03-03 01:23:02 +08:00
commit 3e434877e8
1053 changed files with 102411 additions and 0 deletions
--- a/Plugins/GMS/Source/GenericMovementSystem/Public/Locomotions/GMS_MainAnimInstance.h
+++ b/Plugins/GMS/Source/GenericMovementSystem/Public/Locomotions/GMS_MainAnimInstance.h
@@ -0,0 +1,651 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "GMS_LocomotionStructLibrary.h"
+#include "Engine/TimerHandle.h"
+#include "TimerManager.h"
+#include "Animation/AnimExecutionContext.h"
+#include "Animation/AnimInstance.h"
+#include "Animation/AnimNodeReference.h"
+#include "Engine/World.h"
+#include "Settings/GMS_SettingStructLibrary.h"
+#include "Locomotions/GMS_AnimState.h"
+#include "Utility/GMS_Tags.h"
+#include "GMS_MainAnimInstance.generated.h"
+
+class IPoseSearchTrajectoryPredictorInterface;
+class UGMS_AnimLayerSetting_Additive;
+class UGMS_AnimLayer;
+class UGMS_AnimLayerSetting;
+class UGMS_AnimLayerSetting_View;
+class UGMS_AnimLayerSetting_Overlay;
+class UGMS_AnimLayerSetting_States;
+class UGMS_MovementDefinition;
+class UGMS_MovementSystemComponent;
+
+/**
+ * Base animation template for the main animation instance.
+ * 主动画实例的动画模板基类。
+ */
+UCLASS(BlueprintType)
+class GENERICMOVEMENTSYSTEM_API UGMS_MainAnimInstance : public UAnimInstance
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Gets the movement system component.
+	 * 获取运动系统组件。
+	 * @return The movement system component. 运动系统组件。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	UGMS_MovementSystemComponent* GetMovementSystemComponent() const;
+
+	/**
+	 * Constructor.
+	 * 构造函数。
+	 */
+	UGMS_MainAnimInstance();
+
+	/**
+	 * Initializes the animation.
+	 * 初始化动画。
+	 */
+	virtual void NativeInitializeAnimation() override;
+
+	/**
+	 * Uninitializes the animation.
+	 * 取消初始化动画。
+	 */
+	virtual void NativeUninitializeAnimation() override;
+
+	/**
+	 * Called when the game starts.
+	 * 游戏开始时调用。
+	 */
+	virtual void NativeBeginPlay() override;
+
+	/**
+	 * Updates the animation.
+	 * 更新动画。
+	 * @param DeltaTime Time since last update. 自上次更新以来的时间。
+	 */
+	virtual void NativeUpdateAnimation(float DeltaTime) override;
+
+	/**
+	 * Thread-safe animation update.
+	 * 线程安全的动画更新。
+	 * @param DeltaTime Time since last update. 自上次更新以来的时间。
+	 */
+	virtual void NativeThreadSafeUpdateAnimation(float DeltaTime) override;
+
+	/**
+	 * Applies an animation layer setting to an animation layer instance.
+	 * 将动画层设置应用于动画层实例。
+	 * @param LayerSetting The layer setting to apply. 要应用的层设置。
+	 * @param LayerInstance The layer instance to apply the setting to. 要应用设置的层实例。
+	 */
+	virtual void SetAnimLayerBySetting(const UGMS_AnimLayerSetting* LayerSetting, TObjectPtr<UGMS_AnimLayer>& LayerInstance);
+
+	/**
+	 * Registers animation state name to tag mappings for a given animation instance.
+	 * 为给定的动画实例注册动画状态名称到标签的映射。
+	 * @param SourceAnimInstance The animation instance to register mappings for. 要注册映射的动画实例。
+	 * @param Mapping The state name to tag mappings. 状态名称到标签的映射。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GMS|Animation")
+	virtual void RegisterStateNameToTagMapping(UAnimInstance* SourceAnimInstance, TArray<FGMS_AnimStateNameToTag> Mapping);
+
+	/**
+	 * Unregisters animation state name to tag mappings for a given animation instance.
+	 * 为给定的动画实例取消注册动画状态名称到标签的映射。
+	 * @param SourceAnimInstance The animation instance to unregister mappings for. 要取消注册映射的动画实例。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GMS|Animation")
+	virtual void UnregisterStateNameToTagMapping(UAnimInstance* SourceAnimInstance);
+
+	/**
+	 * Refreshes layer settings when core state changes (e.g., movement set, locomotion mode).
+	 * 当核心状态（如运动集、运动模式）更改时刷新层设置。
+	 * @note Override if custom movement definitions include additional animation layer settings. 如果自定义运动定义包含额外的动画层设置，则需覆盖。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GMS|Animation")
+	void RefreshLayerSettings();
+	virtual void RefreshLayerSettings_Implementation();
+
+	/**
+	 * Sets the offset root bone rotation mode.
+	 * 设置偏移根骨骼旋转模式。
+	 * @param NewRotationMode The new rotation mode. 新的旋转模式。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	void SetOffsetRootBoneRotationMode(EOffsetRootBoneMode NewRotationMode);
+
+	/**
+	 * Gets the current offset root bone rotation mode.
+	 * 获取当前偏移根骨骼旋转模式。
+	 * @return The current rotation mode. 当前旋转模式。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	EOffsetRootBoneMode GetOffsetRootBoneRotationMode() const;
+
+	/**
+	 * Gets the current offset root bone translation mode.
+	 * 获取当前偏移根骨骼平移模式。
+	 * @return The current translation mode. 当前平移模式。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	EOffsetRootBoneMode GetOffsetRootBoneTranslationMode() const;
+
+	/**
+	 * Sets the offset root bone translation mode.
+	 * 设置偏移根骨骼平移模式。
+	 * @param NewTranslationMode The new translation mode. 新的平移模式。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	void SetOffsetRootBoneTranslationMode(EOffsetRootBoneMode NewTranslationMode);
+
+protected:
+	/**
+	 * Called when the locomotion mode changes.
+	 * 运动模式更改时调用。
+	 * @param Prev The previous locomotion mode. 之前的运动模式。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GMS|Animation")
+	void OnLocomotionModeChanged(const FGameplayTag& Prev);
+
+	/**
+	 * Called when the rotation mode changes.
+	 * 旋转模式更改时调用。
+	 * @param Prev The previous rotation mode. 之前的旋转模式。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GMS|Animation")
+	void OnRotationModeChanged(const FGameplayTag& Prev);
+
+	/**
+	 * Called when the movement set changes.
+	 * 运动集更改时调用。
+	 * @param Prev The previous movement set. 之前的运动集。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GMS|Animation")
+	void OnMovementSetChanged(const FGameplayTag& Prev);
+
+	/**
+	 * Called when the movement state changes.
+	 * 运动状态更改时调用。
+	 * @param Prev The previous movement state. 之前的运动状态。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GMS|Animation")
+	void OnMovementStateChanged(const FGameplayTag& Prev);
+
+	/**
+	 * Called when the overlay mode changes.
+	 * 叠层模式更改时调用。
+	 * @param Prev The previous overlay mode. 之前的叠层模式。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GMS|Animation")
+	void OnOverlayModeChanged(const FGameplayTag& Prev);
+
+	/**
+	 * Refreshes Trajectory-related data.
+	 * 刷新Trajectory相关数据。
+	 * @param DeltaTime Time since last update. 自上次更新以来的时间。
+	 */
+	virtual void RefreshTrajectoryState(float DeltaTime);
+
+	/**
+	 * Refreshes view-related data.
+	 * 刷新视图相关数据。
+	 * @param DeltaTime Time since last update. 自上次更新以来的时间。
+	 */
+	virtual void RefreshView(float DeltaTime);
+
+	/**
+	 * Refreshes locomotion data.
+	 * 刷新运动数据。
+	 * @param DeltaTime Time since last update. 自上次更新以来的时间。
+	 */
+	virtual void RefreshLocomotion(const float DeltaTime);
+
+	/**
+	 * Refreshes block state.
+	 * 刷新阻塞状态。
+	 */
+	virtual void RefreshBlock();
+
+	/**
+	 * Gather information from game world.
+	 * 从游戏世界获取信息。
+	 */
+	virtual void RefreshStateOnGameThread();
+
+	/**
+	 * Refreshes animation node relevance tags on the game thread.
+	 * 在游戏线程上刷新动画节点相关性标签。
+	 */
+	virtual void RefreshRelevanceOnGameThread();
+
+	/**
+	 * Refreshes grounded state data.
+	 * 刷新地面状态数据。
+	 */
+	virtual void RefreshGrounded();
+
+	/**
+	 * Refreshes lean data for grounded state.
+	 * 刷新地面状态的倾斜数据。
+	 */
+	virtual void RefreshGroundedLean();
+
+	/**
+	 * Gets the relative acceleration amount for leaning.
+	 * 获取用于倾斜的相对加速度量。
+	 * @return 2D vector of relative acceleration. 相对加速度的2D向量。
+	 */
+	virtual FVector2f GetRelativeAccelerationAmount() const;
+
+	/**
+	 * Refreshes in-air state data.
+	 * 刷新空中状态数据。
+	 */
+	virtual void RefreshInAir();
+
+	/**
+	 * Refreshes ground prediction data.
+	 * 刷新地面预测数据。
+	 */
+	virtual void RefreshGroundPrediction();
+
+	/**
+	 * Refreshes lean data for in-air state.
+	 * 刷新空中状态的倾斜数据。
+	 */
+	virtual void RefreshInAirLean();
+
+	/**
+	 * Refreshes the offset root bone state.
+	 * 刷新偏移根骨骼状态。
+	 * @param Context Animation update context. 动画更新上下文。
+	 * @param Node Animation node reference. 动画节点引用。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	void RefreshOffsetRootBone(UPARAM(ref)
+	                           FAnimUpdateContext& Context, UPARAM(ref)
+	                           FAnimNodeReference& Node);
+
+public:
+	/**
+	 * Gets the clamped curve value (0 to 1) for a given curve name.
+	 * 获取给定曲线名称的限制曲线值（0到1）。
+	 * @param CurveName The name of the curve. 曲线名称。
+	 * @return The clamped curve value. 限制的曲线值。
+	 */
+	float GetCurveValueClamped01(const FName& CurveName) const;
+
+	/**
+	 * Gets the named blend profile.
+	 * 获取命名的混合配置文件。
+	 * @param BlendProfileName The name of the blend profile. 混合配置文件名称。
+	 * @return The blend profile. 混合配置文件。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	UBlendProfile* GetNamedBlendProfile(const FName& BlendProfileName) const;
+
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	FGameplayTagContainer GetAggregatedTags() const;
+
+	/**
+	 * Gets the yaw value for aim offset.
+	 * 获取瞄准偏移的偏航值。
+	 * @return The aim offset yaw value. 瞄准偏移偏航值。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	float GetAOYawValue() const;
+
+	/**
+	 * Selects a cardinal direction based on an angle.
+	 * 根据角度选择主要方向。
+	 * @param Angle The angle to evaluate. 要评估的角度。
+	 * @param DeadZone The dead zone for direction changes. 方向变化的死区。
+	 * @param CurrentDirection The current direction. 当前方向。
+	 * @param bUseCurrentDirection Whether to consider the current direction. 是否考虑当前方向。
+	 * @return The selected cardinal direction. 选择的主要方向。
+	 */
+	EGMS_MovementDirection SelectCardinalDirectionFromAngle(float Angle, float DeadZone, EGMS_MovementDirection CurrentDirection, bool bUseCurrentDirection) const;
+
+	/**
+	 * Selects an octagonal direction based on an angle.
+	 * 根据角度选择八方向。
+	 * @param Angle The angle to evaluate. 要评估的角度。
+	 * @param DeadZone The dead zone for direction changes. 方向变化的死区。
+	 * @param CurrentDirection The current direction. 当前方向。
+	 * @param bUseCurrentDirection Whether to consider the current direction. 是否考虑当前方向。
+	 * @return The selected octagonal direction. 选择的八方向。
+	 */
+	EGMS_MovementDirection_8Way SelectOctagonalDirectionFromAngle(float Angle, float DeadZone, EGMS_MovementDirection_8Way CurrentDirection, bool bUseCurrentDirection) const;
+
+	/**
+	 * Gets the opposite cardinal direction.
+	 * 获取相反的主要方向。
+	 * @param CurrentDirection The current direction. 当前方向。
+	 * @return The opposite cardinal direction. 相反的主要方向。
+	 */
+	EGMS_MovementDirection GetOppositeCardinalDirection(EGMS_MovementDirection CurrentDirection) const;
+
+	/**
+	 * Checks if any core state has changed (movement set, state, locomotion, rotation, or overlay mode).
+	 * 检查是否有核心状态更改（运动集、状态、运动、旋转或叠层模式）。
+	 * @return True if any core state has changed. 如果任何核心状态更改则返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	bool HasCoreStateChanges() const;
+
+	/**
+	 * Checks if specified core states have changed.
+	 * 检查指定的核心状态是否更改。
+	 * @param bCheckLocomotionMode Check locomotion mode changes. 检查运动模式更改。
+	 * @param bCheckMovementSet Check movement set changes. 检查运动集更改。
+	 * @param bCheckRotationMode Check rotation mode changes. 检查旋转模式更改。
+	 * @param bCheckMovementState Check movement state changes. 检查运动状态更改。
+	 * @param bCheckOverlayMode Check overlay mode changes. 检查叠层模式更改。
+	 * @return True if any specified state has changed. 如果任何指定状态更改则返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category="GMS|Animation", meta=(BlueprintThreadSafe))
+	bool CheckCoreStateChanges(bool bCheckLocomotionMode, bool bCheckMovementSet, bool bCheckRotationMode, bool bCheckMovementState, bool bCheckOverlayMode) const;
+
+	/**
+	 * Animation state name to gameplay tag mappings.
+	 * 动画状态名称到游戏标签的映射。
+	 * @note Used to check if a state node is active via NodeRelevantTags. 用于通过NodeRelevantTags检查状态节点是否活跃。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(TitleProperty="Tag"))
+	TArray<FGMS_AnimStateNameToTag> AnimStateNameToTagMapping;
+
+	/**
+	 * Current locomotion mode.
+	 * 当前运动模式。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.LocomotionMode"))
+	FGameplayTag LocomotionMode{GMS_MovementModeTags::Grounded};
+
+	/**
+	 * Container for locomotion mode (for chooser only).
+	 * 运动模式的容器（仅用于选择器）。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.LocomotionMode"))
+	FGameplayTagContainer LocomotionModeContainer;
+
+	/**
+	 * Current rotation mode.
+	 * 当前旋转模式。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.RotationMode"))
+	FGameplayTag RotationMode{GMS_RotationModeTags::ViewDirection};
+
+	/**
+	 * Container for rotation mode (for chooser only).
+	 * 旋转模式的容器（仅用于选择器）。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.RotationMode"))
+	FGameplayTagContainer RotationModeContainer;
+
+	/**
+	 * Current movement state.
+	 * 当前运动状态。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.MovementState"))
+	FGameplayTag MovementState{GMS_MovementStateTags::Jog};
+
+	/**
+	 * Container for movement state (for chooser only).
+	 * 运动状态的容器（仅用于选择器）。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.MovementState"))
+	FGameplayTagContainer MovementStateContainer;
+
+	/**
+	 * Current movement set.
+	 * 当前运动集。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.MovementSet"))
+	FGameplayTag MovementSet;
+
+	/**
+	 * Container for movement set (for chooser only).
+	 * 运动集的容器（仅用于选择器）。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.MovementSet"))
+	FGameplayTagContainer MovementSetContainer;
+
+	/**
+	 * Current overlay mode.
+	 * 当前叠层模式。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.OverlayMode"))
+	FGameplayTag OverlayMode{GMS_OverlayModeTags::Default};
+
+	/**
+	 * Container for overlay mode (for chooser only).
+	 * 叠层模式的容器（仅用于选择器）。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings", meta=(Categories="GMS.OverlayMode"))
+	FGameplayTagContainer OverlayModeContainer;
+
+	/**
+	 * Enables ground prediction.
+	 * 启用地面预测。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings")
+	bool bEnableGroundPrediction{false};
+
+	/**
+	 * General animation settings.
+	 * 通用动画设置。
+	 */
+	UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category="Settings")
+	FGMS_AnimDataSetting_General GeneralSetting;
+
+	UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category="Settings", meta=(BlueprintThreadSafe))
+	TObjectPtr<const UGMS_MovementControlSetting_Default> ControlSetting{nullptr};
+
+
+	UPROPERTY(Transient)
+	FGMS_MovementBaseState MovementBase;
+
+	/**
+	 * Locomotion state for the game thread.
+	 * 游戏线程的运动状态。
+	 */
+	UPROPERTY(Transient)
+	FGMS_LocomotionState GameLocomotionState;
+
+	/**
+	 * Root bone animation state.
+	 * 根骨骼动画状态。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_Root RootState;
+
+
+	/**
+	 * Locomotion animation state.
+	 * 运动动画状态。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_Locomotion LocomotionState;
+
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_Trajectory TrajectoryState;
+
+	/**
+	 * View-related animation state.
+	 * 视图相关动画状态。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_View ViewState;
+
+	/**
+	 * Lean animation state.
+	 * 倾斜动画状态。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_Lean LeanState;
+
+	/**
+	 * Movement intent vector.
+	 * 运动意图向量。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State", meta=(DisplayName="Movement Intent"))
+	FVector MovementIntent;
+
+	/**
+	 * In-air animation state.
+	 * 空中动画状态。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="State")
+	FGMS_AnimState_InAir InAirState;
+
+	/**
+	 * Tags owned by the animation instance.
+	 * 动画实例拥有的标签。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	FGameplayTagContainer OwnedTags;
+
+	/**
+	 * Tags indicating active animation nodes.
+	 * 指示活跃动画节点的标签。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	FGameplayTagContainer NodeRelevanceTags;
+
+	/**
+	 * Indicates if any montage is playing.
+	 * 指示是否有蒙太奇在播放。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bAnyMontagePlaying{false};
+
+	/**
+	 * Indicates if the movement state has changed.
+	 * 指示运动状态是否更改。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bMovementStateChanged{false};
+
+	/**
+	 * Indicates if the locomotion mode has changed.
+	 * 指示运动模式是否更改。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bLocomotionModeChanged{false};
+
+	/**
+	 * Indicates if the movement set has changed.
+	 * 指示运动集是否更改。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bMovementSetChanged{false};
+
+	/**
+	 * Indicates if the rotation mode has changed.
+	 * 指示旋转模式是否更改。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bRotationModeChanged{false};
+
+	/**
+	 * Indicates if the overlay mode has changed.
+	 * 指示叠层模式是否更改。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bOverlayModeChanged{false};
+
+	/**
+	 * Indicates if movement is blocked.
+	 * 指示移动是否被阻塞。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State", meta=(DisplayName="Movement Blocked"))
+	bool bBlocked{false};
+
+	/**
+	 * Indicates if the character has just landed.
+	 * 指示角色是否刚刚着陆。
+	 */
+	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category="State")
+	bool bJustLanded{false};
+
+	/**
+	 * Indicates if this is the first update.
+	 * 指示这是否是第一次更新。
+	 */
+	bool bFirstUpdate = true;
+
+	UPROPERTY()
+	TScriptInterface<IPoseSearchTrajectoryPredictorInterface> TrajectoryPredictor;
+
+protected:
+	/**
+	 * Reference to the movement system component.
+	 * 运动系统组件的引用。
+	 */
+	UPROPERTY()
+	TObjectPtr<UGMS_MovementSystemComponent> MovementSystem;
+
+
+	/**
+	 * Reference to the owning pawn.
+	 * 拥有Pawn的引用。
+	 */
+	UPROPERTY(Transient)
+	TObjectPtr<APawn> PawnOwner;
+
+	/**
+	 * Runtime mappings of animation state names to tags.
+	 * 动画状态名称到标签的运行时映射。
+	 */
+	UPROPERTY()
+	TMap<TObjectPtr<UAnimInstance>, FGMS_AnimStateNameToTagWrapper> RuntimeAnimStateNameToTagMappings;
+
+	/**
+	 * Timer handle for initial updates.
+	 * 初始更新的计时器句柄。
+	 */
+	FTimerHandle InitialTimerHandle;
+
+	/**
+	 * Animation layer instance for states.
+	 * 状态动画层实例。
+	 */
+	UPROPERTY(VisibleInstanceOnly, Category="AnimLayers", meta=(ShowInnerProperties))
+	TObjectPtr<UGMS_AnimLayer> StateLayerInstance;
+
+	/**
+	 * Animation layer instance for overlays.
+	 * 叠层动画层实例。
+	 */
+	UPROPERTY(VisibleInstanceOnly, Category="AnimLayers", meta=(ShowInnerProperties))
+	TObjectPtr<UGMS_AnimLayer> OverlayLayerInstance;
+
+	/**
+	 * Animation layer instance for view.
+	 * 视图动画层实例。
+	 */
+	UPROPERTY(VisibleInstanceOnly, Category="AnimLayers", meta=(ShowInnerProperties))
+	TObjectPtr<UGMS_AnimLayer> ViewLayerInstance;
+
+	/**
+	 * Animation layer instance for additive animations.
+	 * 附加动画层实例。
+	 */
+	UPROPERTY(VisibleInstanceOnly, Category="AnimLayers", meta=(ShowInnerProperties))
+	TObjectPtr<UGMS_AnimLayer> AdditiveLayerInstance;
+
+	/**
+	 * Animation layer instance for skeletal controls.
+	 * 骨骼控制动画层实例。
+	 */
+	UPROPERTY(VisibleInstanceOnly, Category="AnimLayers", meta=(ShowInnerProperties))
+	TObjectPtr<UGMS_AnimLayer> SkeletonControlsLayerInstance;
+};