第一次提交

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

@@ -0,0 +1,205 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameplayEffectTypes.h"
+#include "GCS_CombatStructLibrary.h"
+#include "Net/Serialization/FastArraySerializer.h"
+#include "UObject/Object.h"
+#include "GCS_AttackResult.generated.h"
+
+class UGCS_AttackRequest_Melee;
+class UGCS_CombatFlow;
+class UGCS_CombatSystemComponent;
+
+/**
+ * Structure representing the result of a processed attack.
+ * 表示已处理攻击结果的结构。
+ */
+USTRUCT(BlueprintType)
+struct GENERICCOMBATSYSTEM_API FGCS_AttackResult : public FFastArraySerializerItem
+{
+	GENERATED_BODY()
+
+
+	void PostReplicatedAdd(const struct FGCS_AttackResultContainer& InArray);
+
+
+	/**
+	 * Deprecated.
+	 * 已经弃用。
+	 */
+	UE_DEPRECATED(1.5, "Use TaggedValues within FGCS_ContextPayload_Combat")
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category="GCS", NotReplicated, meta=(DeprecatedProperty, DeprecationMessage="Use TaggedValues within FGCS_ContextPayload_Combat!"))
+	TArray<FGCS_TaggedValue> TaggedValues;
+
+	/**
+	 * Optional object related to the attack.
+	 * 与攻击相关的可选对象。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
+	TObjectPtr<const UObject> OptionalObject;
+
+	/**
+	 * Context handle for the gameplay effect.
+	 * 游戏效果的上下文句柄。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
+	FGameplayEffectContextHandle EffectContextHandle;
+
+	/**
+	 * Aggregated source tags for the attack.
+	 * 攻击的聚合来源标签。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
+	FGameplayTagContainer AggregatedSourceTags;
+
+	/**
+	 * Aggregated target tags for the attack.
+	 * 攻击的聚合目标标签。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
+	FGameplayTagContainer AggregatedTargetTags;
+
+	/**
+	 * Whether the attack result has been consumed.
+	 * 攻击结果是否已被消耗。
+	 */
+	UPROPERTY(NotReplicated)
+	bool bConsumed{false};
+
+	/**
+	 * Indicates this attack result was found in existing processed array with same prediction key.
+	 * 表示此攻击结果在已处理攻击结果列表中有相同的预测Key。
+	 */
+	UPROPERTY(NotReplicated)
+	bool bWasPredicated{false};
+
+	/**
+	 * Indicates this attack result was replicated via fast array serializer.
+	 * 表示此攻击结果是经由fast array serializer同步而来。
+	 */
+	UPROPERTY(NotReplicated)
+	bool bWasReplicated{false};
+};
+
+/**
+ * Container for storing combat results with network serialization.
+ * 用于存储战斗结果的容器，支持网络序列化。
+ */
+USTRUCT(BlueprintType)
+struct GENERICCOMBATSYSTEM_API FGCS_AttackResultContainer : public FFastArraySerializer
+{
+	GENERATED_BODY()
+
+	/**
+		 * Default constructor.
+		 * 默认构造函数。
+		 */
+	FGCS_AttackResultContainer();
+
+	/**
+	 * Constructor with combat flow and max size.
+	 * 带有战斗流程和最大尺寸的构造函数。
+	 * @param InCombatFlow The combat flow instance. 战斗流程实例。
+	 * @param InMaxSize The maximum size of the container. 容器最大尺寸。
+	 */
+	FGCS_AttackResultContainer(UGCS_CombatFlow* InCombatFlow, int32 InMaxSize);
+
+	/**
+	 * Constructor with combat system component and max size.
+	 * 带有战斗系统组件和最大尺寸的构造函数。
+	 * @param InCombatSystemComponent The combat system component. 战斗系统组件。
+	 * @param InMaxSize The maximum size of the container. 容器最大尺寸。
+	 */
+	FGCS_AttackResultContainer(UGCS_CombatSystemComponent* InCombatSystemComponent, int32 InMaxSize);
+
+	/**
+	 * Sets the owning combat system component.
+	 * 设置所属战斗系统组件。
+	 * @param InCombatSystemComponent The combat system component. 战斗系统组件。
+	 */
+	void SetOwningCombatSystem(UGCS_CombatSystemComponent* InCombatSystemComponent) { CombatSystemComponent = InCombatSystemComponent; }
+
+	/**
+	 * Sets the combat flow.
+	 * 设置战斗流程。
+	 * @param InCombatFlow The combat flow instance. 战斗流程实例。
+	 */
+	void SetCombatFlow(UGCS_CombatFlow* InCombatFlow) { CombatFlow = InCombatFlow; }
+
+	/**
+	 * Adds a new attack result entry to the container.
+	 * 向容器添加新的攻击结果条目。
+	 * @param NewEntry The attack result to add. 要添加的攻击结果。
+	 */
+	void AddEntry(FGCS_AttackResult& NewEntry);
+
+	/**
+	 * Handles post-replication addition of entries.
+	 * 处理条目添加后的复制。
+	 * @param AddedIndices The indices of added entries. 添加的条目索引。
+	 * @param FinalSize The final size of the container. 容器最终尺寸。
+	 */
+	void PostReplicatedAdd(const TArrayView<int32> AddedIndices, int32 FinalSize);
+
+	/**
+	 * Handles post-replication changes to entries.
+	 * 处理条目更改后的复制。
+	 * @param ChangedIndices The indices of changed entries. 更改的条目索引。
+	 * @param FinalSize The final size of the container. 容器最终尺寸。
+	 */
+	void PostReplicatedChange(const TArrayView<int32>& ChangedIndices, int32 FinalSize);
+
+	/**
+	 * Serializes the container for network replication.
+	 * 为网络复制序列化容器。
+	 * @param DeltaParms The network serialization parameters. 网络序列化参数。
+	 * @return True if serialization is successful. 如果序列化成功返回true。
+	 */
+	bool NetDeltaSerialize(FNetDeltaSerializeInfo& DeltaParms)
+	{
+		return FastArrayDeltaSerialize<FGCS_AttackResult, FGCS_AttackResultContainer>(Results, DeltaParms, *this);
+	}
+
+	bool HasPredictedResultWithPredictedKey(FPredictionKey PredictionKey) const;
+
+private:
+	/**
+	 * Reference to the combat flow instance.
+	 * 战斗流程实例的引用。
+	 */
+	UPROPERTY()
+	TObjectPtr<UGCS_CombatFlow> CombatFlow;
+
+	/**
+	 * Reference to the combat system component.
+	 * 战斗系统组件的引用。
+	 */
+	UPROPERTY()
+	TObjectPtr<UGCS_CombatSystemComponent> CombatSystemComponent;
+
+	/**
+	 * List of attack results.
+	 * 攻击结果列表。
+	 */
+	UPROPERTY()
+	TArray<FGCS_AttackResult> Results;
+
+	/**
+	 * Maximum size of the container.
+	 * 容器最大尺寸。
+	 */
+	UPROPERTY()
+	int32 MaxSize;
+};
+
+template <>
+struct TStructOpsTypeTraits<FGCS_AttackResultContainer> : TStructOpsTypeTraitsBase2<FGCS_AttackResultContainer>
+{
+	enum
+	{
+		WithNetDeltaSerializer = true,
+	};
+};