第一次提交

Plugins/GCS/Source/GenericCombatSystem/Public/Weapon/GCS_WeaponInterface.h

@@ -0,0 +1,96 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameplayTagContainer.h"
+#include "UObject/Interface.h"
+#include "GCS_WeaponInterface.generated.h"
+
+class APawn;
+class AActor;
+
+/**
+ * Interface for objects acting as weapons.
+ * 作为武器的对象的接口。
+ */
+UINTERFACE()
+class UGCS_WeaponInterface : public UInterface
+{
+	GENERATED_BODY()
+};
+
+/**
+ * Interface for weapon-related functionality.
+ * 武器相关功能的接口。
+ */
+class GENERICCOMBATSYSTEM_API IGCS_WeaponInterface
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Gets the pawn owning this weapon.
+	 * 获取拥有此武器的Pawn。
+	 * @return The owning pawn. 所属Pawn。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Weapon")
+	APawn* GetWeaponOwner() const;
+
+	/**
+	 * Gets the gameplay tags associated with the weapon.
+	 * 获取与武器关联的游戏标签。
+	 * @return The weapon's gameplay tags. 武器游戏标签。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Weapon")
+	const FGameplayTagContainer GetWeaponTags() const;
+
+	/**
+	 * Sets the weapon's active state.
+	 * 设置武器的激活状态。
+	 * @param bNewActive The new active state. 新激活状态。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "GCS|Weapon")
+	void SetWeaponActive(bool bNewActive);
+
+	/**
+	 * Checks if the weapon is active.
+	 * 检查武器是否激活。
+	 * @return True if the weapon is active. 如果武器激活返回true。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "GCS|Weapon")
+	bool IsWeaponActive() const;
+
+	/**
+	 * Gets the main primitive component of the weapon.
+	 * 获取武器的主要原始组件。
+	 * @return The primitive component. 原始组件。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category = "GCS|Weapon")
+	UPrimitiveComponent* GetPrimitiveComponent() const;
+	virtual UPrimitiveComponent* GetPrimitiveComponent_Implementation() const;
+
+	/**
+	 * Gets the targeting start transform for ranged weapons.
+	 * 获取远程武器的目标起始变换。
+	 * @return The targeting start transform. 目标起始变换。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Weapon", meta=(DisplayName="Get Targeting Start Transform"))
+	FTransform GCS_GetTargetingStartTransform() const;
+
+	/**
+	 * Toggles targeting for the weapon.
+	 * 切换武器的目标状态。
+	 * @param bEnable Whether to enable targeting. 是否启用目标。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Weapon", meta=(DisplayName="Toggle Targeting"))
+	void GCS_ToggleTargeting(bool bEnable);
+
+	/**
+	 * Toggles trails for the weapon.
+	 * 开关武器拖尾。
+	 * @param bEnable Whether to enable trails. 是否启用武器拖尾
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintNativeEvent, Category="GCS|Weapon", meta=(DisplayName="Toggle Trail"))
+	void ToggleTrail(bool bEnable);
+};