第一次提交

2026-03-03 01:23:02 +08:00
commit 3e434877e8
1053 changed files with 102411 additions and 0 deletions
--- a/Plugins/GCS/Source/GenericCombatSystem/Public/Targeting/GCS_TargetingSourceInterface.h
+++ b/Plugins/GCS/Source/GenericCombatSystem/Public/Targeting/GCS_TargetingSourceInterface.h
@@ -0,0 +1,77 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "UObject/Interface.h"
+#include "GCS_TargetingSourceInterface.generated.h"
+
+/**
+ * Interface for objects providing targeting system information.
+ * 为目标系统提供信息的对象的接口。
+ * @note Used to provide additional targeting data.
+ * @注意 用于提供额外的目标数据。
+ */
+UINTERFACE(MinimalAPI, BlueprintType, Blueprintable)
+class UGCS_TargetingSourceInterface : public UInterface
+{
+	GENERATED_BODY()
+};
+
+/**
+ * Interface for targeting source objects.
+ * 目标源对象的接口。
+ */
+class GENERICCOMBATSYSTEM_API IGCS_TargetingSourceInterface
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Gets the trace level for dynamic tracing.
+	 * 获取动态追踪的追踪级别。
+	 * @return The trace level. 追踪级别。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Trace")
+	float GetTraceLevel() const;
+	virtual float GetTraceLevel_Implementation() const = 0;
+
+	/**
+	 * Gets the trace direction for targeting.
+	 * 获取目标的追踪方向。
+	 * @param OutDirection The trace direction (output). 追踪方向（输出）。
+	 * @return True if a direction is provided. 如果提供方向返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Trace")
+	bool GetTraceDirection(FVector& OutDirection) const;
+	virtual bool GetTraceDirection_Implementation(FVector& OutDirection) const = 0;
+
+	/**
+	 * Gets the swept trace rotation for capsule or box traces.
+	 * 获取胶囊或盒体追踪的旋转。
+	 * @param OutRotation The rotation (output). 旋转（输出）。
+	 * @return True if a rotation is provided. 如果提供旋转返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "GCS|Trace")
+	bool GetSweptTraceRotation(FRotator& OutRotation) const;
+	virtual bool GetSweptTraceRotation_Implementation(FRotator& OutRotation) const = 0;
+
+	/**
+	 * Gets the shape component for trace properties.
+	 * 获取追踪属性的形状组件。
+	 * @param OutShape The shape component (output). 形状组件（输出）。
+	 * @return True if a shape component is provided. 如果提供形状组件返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Trace")
+	bool GetTraceShape(UShapeComponent*& OutShape) const;
+	virtual bool GetTraceShape_Implementation(UShapeComponent*& OutShape) const = 0;
+
+	/**
+	 * Gets additional actors to ignore during tracing.
+	 * 获取追踪期间忽略的额外Actor。
+	 * @return Array of actors to ignore. 忽略的Actor数组。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Trace")
+	TArray<AActor*> GetAdditionalActorsToIgnore() const;
+	virtual TArray<AActor*> GetAdditionalActorsToIgnore_Implementation() const = 0;
+};