第一次提交

Plugins/GCS/Source/GenericCombatSystem/Public/AbilitySystem/Tasks/GCS_AbilityTask_CollisionTrace.h

@@ -0,0 +1,116 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Abilities/Tasks/AbilityTask.h"
+#include "Collision/GCS_TraceStructLibrary.h"
+#include "Components/SkeletalMeshComponent.h"
+#include "GCS_AbilityTask_CollisionTrace.generated.h"
+
+class UGCS_AttackRequest_Melee;
+
+/**
+ * Ability task for handling collision traces in combat.
+ * 处理战斗中碰撞检测的能力任务。
+ */
+UCLASS()
+class GENERICCOMBATSYSTEM_API UGCS_AbilityTask_CollisionTrace : public UAbilityTask
+{
+	GENERATED_BODY()
+
+public:
+	UGCS_AbilityTask_CollisionTrace();
+	/**
+	 * Creates and activates a collision trace task.
+	 * 创建并激活碰撞检测任务。
+	 * @param OwningAbility The owning gameplay ability. 所属游戏能力。
+	 * @param TaskInstanceName The name of the task instance. 任务实例名称。
+	 * @param bAdjustVisibilityBasedAnimTickOption Whether to adjust visibility-based animation ticking. 是否调整基于可见性的动画tick。
+	 * @return The created task. 创建的任务。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GCS|AbilityTasks", meta = (HidePin = "OwningAbility", DefaultToSelf = "OwningAbility", BlueprintInternalUseOnly = "TRUE"))
+	static UGCS_AbilityTask_CollisionTrace* HandleCollisionTraces(UGameplayAbility* OwningAbility, FName TaskInstanceName, bool bAdjustVisibilityBasedAnimTickOption = false);
+
+	/**
+	 * Activates the task.
+	 * 激活任务。
+	 */
+	virtual void Activate() override;
+
+	/**
+	 * Called when the task is destroyed.
+	 * 任务销毁时调用。
+	 * @param bInOwnerFinished Whether the owner finished the task. 拥有者是否完成了任务。
+	 */
+	virtual void OnDestroy(bool bInOwnerFinished) override;
+
+	/**
+	 * Adds a melee attack request to the task.
+	 * 向任务添加近战攻击请求。
+	 * @param Request The melee attack request. 近战攻击请求。
+	 * @param SourceObject Optional source object. 可选的源对象。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GCS|AbilityTasks")
+	void AddMeleeRequest(const UGCS_AttackRequest_Melee* Request, UObject* SourceObject);
+
+	/**
+	 * Removes a melee attack request from the task.
+	 * 从任务移除近战攻击请求。
+	 * @param Request The melee attack request. 近战攻击请求。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GCS|AbilityTasks")
+	void RemoveMeleeRequest(const UGCS_AttackRequest_Melee* Request);
+
+	/**
+	 * Delegate for trace instance hit events.
+	 * 碰撞检测实例命中事件的委托。
+	 */
+	DECLARE_DYNAMIC_MULTICAST_DELEGATE_ThreeParams(FGCS_OnTraceInstanceHitSignature, const UGCS_AttackRequest_Melee*, MeleeRequest, const FGCS_TraceHandle&, TraceHandle,
+	                                               const FHitResult&,
+	                                               HitResult);
+
+	/**
+	 * Fired when a trace instance detects targets.
+	 * 当碰撞检测实例检测到目标时触发。
+	 */
+	UPROPERTY(BlueprintAssignable)
+	FGCS_OnTraceInstanceHitSignature OnTargetsFound;
+
+protected:
+	/**
+	 * Handles trace instance hit events.
+	 * 处理碰撞检测实例命中事件。
+	 * @param TraceHandle The trace instance. 碰撞检测实例。
+	 * @param HitResult The hit result. 命中结果。
+	 */
+	UFUNCTION()
+	void TraceHitCallback(const FGCS_TraceHandle& TraceHandle, const FHitResult& HitResult);
+
+	/**
+	 * Map of melee requests to their associated trace instances.
+	 * 近战请求及其关联碰撞检测实例的映射。
+	 */
+	TMap<TObjectPtr<const UGCS_AttackRequest_Melee>, TArray<FGCS_TraceHandle>> MeleeRequests;
+
+	/**
+	 * Whether to adjust visibility-based animation ticking.
+	 * 是否调整基于可见性的动画tick。
+	 */
+	UPROPERTY()
+	bool bAdjustAnimTickOption{false};
+
+	/**
+	 * Whether the animation tick option was adjusted.
+	 * 是否已调整动画tick选项。
+	 */
+	UPROPERTY()
+	bool bAdjustedAnimTickOption{false};
+
+	/**
+	 * The previous animation tick option.
+	 * 之前的动画tick选项。
+	 */
+	UPROPERTY()
+	EVisibilityBasedAnimTickOption PrevAnimTickOption{EVisibilityBasedAnimTickOption::AlwaysTickPose};
+};