第一次提交

Plugins/GCS/Source/GenericCombatSystem/Public/CombatFlow/GCS_CombatFlow.h

@@ -0,0 +1,114 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameplayTagContainer.h"
+#include "GCS_ActorOwnedObject.h"
+#include "GCS_AttackResult.h"
+#include "GGA_GameplayAttributeStructLibrary.h"
+#include "GCS_CombatFlow.generated.h"
+
+class UGCS_AttackResultProcessor;
+class UGCS_CombatSystemComponent;
+
+/**
+ * Combat flow for processing incoming attacks.
+ * 处理传入攻击的战斗流程。
+ * @note Typically one instance per character type (e.g., human, quadruped, mechanical).
+ * @注意 通常每种角色类型一个实例（例如人类、四足动物、机械）。
+ */
+UCLASS(Abstract, BlueprintType, Blueprintable, DefaultToInstanced, EditInlineNew, CollapseCategories, meta=(DisplayName="GCS Combat Flow"))
+class GENERICCOMBATSYSTEM_API UGCS_CombatFlow : public UGCS_ActorOwnedObject
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Default constructor.
+	 * 默认构造函数。
+	 */
+	UGCS_CombatFlow();
+
+	/**
+	 * Retrieves lifetime replicated properties.
+	 * 获取生命周期复制属性。
+	 * @param OutLifetimeProps The lifetime properties. 生命周期属性。
+	 */
+	virtual void GetLifetimeReplicatedProps(TArray<FLifetimeProperty>& OutLifetimeProps) const override;
+
+	/**
+	 * Checks if networking is supported.
+	 * 检查是否支持网络。
+	 * @return True if supported. 如果支持返回true。
+	 */
+	virtual bool IsSupportedForNetworking() const override { return true; }
+
+	/**
+	 * Gets the actor owning this combat flow.
+	 * 获取拥有此战斗流程的演员。
+	 * @return The owning actor. 所属演员。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category = "GCS|Combat Flow")
+	AActor* GetFlowOwner() const { return Owner; }
+
+	/**
+	 * Initializes the combat flow with an owner.
+	 * 使用拥有者初始化战斗流程。
+	 * @param NewOwner The owning actor. 所属演员。
+	 */
+	void Initialize(AActor* NewOwner);
+
+	/**
+	 * Adds dynamic tags to a gameplay effect spec.
+	 * 为游戏效果规格添加动态标签。
+	 * @note Requires GGA_AbilitySystemGlobals as default AbilitySystemGlobals.
+	 * @注意 需要将GGA_AbilitySystemGlobals设置为默认AbilitySystemGlobals。
+	 * @param Spec The gameplay effect spec. 游戏效果规格。
+	 * @param AbilitySystemComponent The ability system component. 能力系统组件。
+	 * @param OutDynamicTagsAppendToSpec The tags to append (output). 要附加的标签（输出）。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Combat Flow")
+	void HandlePreGameplayEffectSpecApply(const FGameplayEffectSpec& Spec, UAbilitySystemComponent* AbilitySystemComponent, FGameplayTagContainer& OutDynamicTagsAppendToSpec);
+
+	/**
+	 * Handles gameplay effect execution.
+	 * 处理游戏效果执行。
+	 * @param Payload The effect modification data. 效果修改数据。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Combat Flow")
+	void HandleGameplayEffectExecute(const FGGA_GameplayEffectModCallbackData& Payload);
+	virtual void HandleGameplayEffectExecute_Implementation(const FGGA_GameplayEffectModCallbackData& Payload);
+
+	/**
+	 * Handles attack results across the network.
+	 * 在网络上处理攻击结果。
+	 * @note Default implementation calls result processors.
+	 * @注意 默认实现调用结果处理器。
+	 * @param Payload The attack result. 攻击结果。
+	 */
+	UFUNCTION(BlueprintNativeEvent, BlueprintCallable, Category = "GCS|Combat Flow")
+	void HandleAttackResult(const FGCS_AttackResult& Payload);
+
+protected:
+	/**
+	 * The actor owning this combat flow.
+	 * 拥有此战斗流程的演员。
+	 */
+	UPROPERTY()
+	TObjectPtr<AActor> Owner;
+
+	/**
+	 * Reference to the owning combat system component.
+	 * 所属战斗系统组件的引用。
+	 */
+	UPROPERTY(BlueprintReadOnly, Category = "GCS|Combat Flow", meta=(BlueprintProtected))
+	TObjectPtr<UGCS_CombatSystemComponent> CombatComponent;
+
+	/**
+	 * List of attack result processors for handling attack results.
+	 * 处理攻击结果的攻击结果处理器列表。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadOnly, Instanced, Category = "GCS|Combat Flow Settings", meta=(TitleProperty="EditorFriendlyName"))
+	TArray<TObjectPtr<UGCS_AttackResultProcessor>> AttackResultProcessors;
+};