352 lines
11 KiB
C++
352 lines
11 KiB
C++
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
||
|
||
#pragma once
|
||
|
||
#include "CoreMinimal.h"
|
||
#include "GCS_CombatStructLibrary.h"
|
||
#include "Runtime/Launch/Resources/Version.h"
|
||
#if ENGINE_MINOR_VERSION < 5
|
||
#include "InstancedStruct.h"
|
||
#else
|
||
#include "StructUtils/InstancedStruct.h"
|
||
#endif
|
||
#include "Collision/GCS_TraceStructLibrary.h"
|
||
#include "UObject/Object.h"
|
||
#include "GCS_BulletStructLibrary.generated.h"
|
||
|
||
class UGCS_AttackRequest_Bullet;
|
||
class UNiagaraSystem;
|
||
class AGCS_BulletInstance;
|
||
|
||
|
||
/**
|
||
* Base struct allow you to extend the bullet definition's fields using C++.
|
||
* 基础结构体，允许你通过C++拓展子弹定义的字段。
|
||
*/
|
||
USTRUCT(BlueprintType, meta=(Hidden))
|
||
struct GENERICCOMBATSYSTEM_API FGCS_BulletDefinitionExtension
|
||
{
|
||
GENERATED_BODY()
|
||
};
|
||
|
||
|
||
/**
|
||
* Data structure defining bullet properties and behavior.
|
||
* 定义子弹属性和行为的数据结构。
|
||
*/
|
||
USTRUCT(BlueprintType, meta=(DisplayName="GCS Bullet Definition"))
|
||
struct GENERICCOMBATSYSTEM_API FGCS_BulletDefinition : public FTableRowBase
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
/**
|
||
* The bullet actor class.
|
||
* 子弹Actor类。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Common", meta=(AllowAbstract="false"))
|
||
TSoftClassPtr<AGCS_BulletInstance> BulletActorClass;
|
||
|
||
/**
|
||
* Duration for which the bullet exists (-1 for infinite).
|
||
* 子弹存在的持续时间（-1表示无限）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Common")
|
||
float Duration{3.0};
|
||
|
||
/**
|
||
* Number of bullets fired at once.
|
||
* 一次性发射的子弹数量。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Launch Configuration", meta=(ClampMin=1, UIMin=1))
|
||
int32 BulletCount{1};
|
||
|
||
/**
|
||
* Yaw angle for bullet launch.
|
||
* 子弹发射的水平角。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Launch Configuration")
|
||
float LaunchAngle{0.0f};
|
||
|
||
/**
|
||
* Yaw angle interval between bullets.
|
||
* 子弹之间的水平角间隔。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Launch Configuration")
|
||
float LaunchAngleInterval{10.0f};
|
||
|
||
/**
|
||
* Pitch angle for bullet launch.
|
||
* 子弹发射的仰角。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Launch Configuration")
|
||
float LaunchElevationAngle{0.0f};
|
||
|
||
/**
|
||
* Distance at which bullet attenuation begins.
|
||
* 子弹开始衰减的距离。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float AttenuationRange{800.0f};
|
||
|
||
/**
|
||
* Gravity scale within the attenuation range.
|
||
* 衰减范围内的重力系数。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement")
|
||
float GravityScaleInRange{1.0f};
|
||
|
||
/**
|
||
* Gravity scale outside the attenuation range.
|
||
* 衰减范围外的重力系数。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement")
|
||
float GravityScaleOutRage{1.0f};
|
||
|
||
/**
|
||
* Initial hit radius for the bullet.
|
||
* 子弹的初始命中半径。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float InitialHitRadius{20.0f};
|
||
|
||
/**
|
||
* Final hit radius for the bullet (-1 to use initial radius).
|
||
* 子弹的最终命中半径（-1使用初始半径）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float FinalHitRadius{-1.0f};
|
||
|
||
/**
|
||
* Initial speed of the bullet.
|
||
* 子弹的初始速度。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float InitialSpeed{1500.0f};
|
||
|
||
/**
|
||
* Minimum speed of the bullet.
|
||
* 子弹的最小速度。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float MinSpeed{1500.0f};
|
||
|
||
/**
|
||
* Maximum speed of the bullet.
|
||
* 子弹的最大速度。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Movement", meta=(Units="cm"))
|
||
float MaxSpeed{1500.0f};
|
||
|
||
/**
|
||
* Handle to the attack definition for the bullet.
|
||
* 子弹的攻击定义句柄。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Attack", meta=(RowType="/Script/GenericCombatSystem.GCS_AttackDefinition"))
|
||
FDataTableRowHandle AttackDefinition;
|
||
|
||
/**
|
||
* Trace definitions for hit detection.
|
||
* 用于命中检测的碰撞检测定义。
|
||
* @note Overrides trace definitions in the bullet instance class.
|
||
* @注意 覆盖子弹实例类中的碰撞检测定义。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Trace")
|
||
TArray<FGCS_TraceDefinition> TraceDefinitions;
|
||
|
||
/**
|
||
* Visual effect for the bullet projectile (Niagara).
|
||
* 子弹的视觉效果（Niagara）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="VFX")
|
||
TSoftObjectPtr<UNiagaraSystem> ProjectileFX;
|
||
|
||
/**
|
||
* Visual effect for the bullet projectile (Cascade).
|
||
* 子弹的视觉效果（Cascade）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="VFX")
|
||
TSoftObjectPtr<UParticleSystem> ProjectileFX_Cascade;
|
||
|
||
/**
|
||
* Visual effect for bullet impact (Niagara).
|
||
* 子弹命中的视觉效果（Niagara）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="VFX")
|
||
TSoftObjectPtr<UNiagaraSystem> ImpactFX;
|
||
|
||
/**
|
||
* Visual effect for bullet impact (Cascade).
|
||
* 子弹命中的视觉效果（Cascade）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="VFX")
|
||
TSoftObjectPtr<UParticleSystem> ImpactFX_Cascade;
|
||
|
||
/**
|
||
* Sound effect for bullet impact.
|
||
* 子弹命中的音效。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="SFX")
|
||
TSoftObjectPtr<USoundBase> ImpactSFX;
|
||
|
||
/**
|
||
* Sound effect attached to the bullet projectile.
|
||
* 附着在子弹上的音效。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="SFX")
|
||
TSoftObjectPtr<USoundBase> ProjectileSFX;
|
||
|
||
/**
|
||
* Sound effect played once when the bullet spawns.
|
||
* 子弹生成时播放一次的音效。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="SFX")
|
||
TSoftObjectPtr<USoundBase> SpawnSFX;
|
||
|
||
/**
|
||
* Whether the bullet penetrates characters/pawns.
|
||
* 子弹是否穿透角色/Pawn。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Penetration")
|
||
bool bPenetrateCharacter{false};
|
||
|
||
/**
|
||
* Whether the bullet penetrates map geometry.
|
||
* 子弹是否穿透地图几何体。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Penetration")
|
||
bool bPenetrateMap{false};
|
||
|
||
/**
|
||
* Handle to the bullet definition to spawn on hit/expiration.
|
||
* 命中或失效时生成的子弹定义句柄。
|
||
* @note Cannot be the same as this bullet.
|
||
* @注意 不能与此子弹相同。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Hit Configuration", meta=(RowType="/Script/GenericCombatSystem.GCS_BulletDefinition"))
|
||
FDataTableRowHandle HitBulletDefinition;
|
||
|
||
/**
|
||
* Condition for launching bullet chains.
|
||
* 子弹链的发射条件。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Hit Configuration", meta=(Categories="GGF.Combat.Bullet.LaunchCond"))
|
||
FGameplayTag LaunchCondition{FGameplayTag::EmptyTag};
|
||
|
||
/**
|
||
* Native Instanced struct for extending the bullet definition.
|
||
* 实例化结构体用于扩充子弹定义的字段。
|
||
* @attention For C++ users only. 仅针对C++用户。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
|
||
TInstancedStruct<FGCS_BulletDefinitionExtension> NativeExtension;
|
||
|
||
/**
|
||
* Blueprint Instanced struct for extending the bullet definition.
|
||
* 实例化结构体用于扩充子弹定义的字段。
|
||
* @attention For blueprint users only. 仅针对蓝图用户。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
|
||
FInstancedStruct Extension;
|
||
|
||
/**
|
||
* Custom user settings for extending the bullet definition.
|
||
* 扩展子弹定义的自定义用户设置。
|
||
*/
|
||
UE_DEPRECATED(1.5, "Using extension field to add custom fields!")
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Deprecated", meta=(ForceInlineRow, BaseStruct = "/Script/GenericCombatSystem.GCS_UserSetting"))
|
||
TMap<FGameplayTag, FInstancedStruct> UserSettings;
|
||
|
||
/**
|
||
* Shares the hit history to sub bullet.(prevent repeat hit for whole bullet chains.)
|
||
*/
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Hit Configuration",meta=(Categories="GGF.Combat.Bullet.LaunchCond"))
|
||
// bool bUseSharedHitList{true};
|
||
|
||
/**
|
||
* The amount of time between a bullet hits something and when it explodes.
|
||
*/
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Hit Configuration", meta=(Units="s", ClampMin=0))
|
||
// float ExplosionDelay{0.0};
|
||
|
||
// Emitter will be added in next version.
|
||
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Emitter", meta=(RowType="/Script/GenericCombatSystem.GCS_BulletDefinition"))
|
||
// FDataTableRowHandle EmitterBulletDefinition;
|
||
//
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Emitter")
|
||
// float EmitterInitialWaitTime{0};
|
||
//
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Emitter")
|
||
// float EmitterMinShootInterval{0};
|
||
//
|
||
// UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Emitter")
|
||
// float EmitterMaxShootInterval{0};
|
||
};
|
||
|
||
|
||
/**
|
||
* Parameters for spawning bullets.
|
||
* 子弹生成参数。
|
||
*/
|
||
USTRUCT(BlueprintType)
|
||
struct GENERICCOMBATSYSTEM_API FGCS_BulletSpawnParameters
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
/**
|
||
* The owner of the bullet.
|
||
* 子弹的拥有者。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
|
||
TObjectPtr<AActor> Owner{nullptr};
|
||
|
||
/**
|
||
* Handle to the bullet definition.
|
||
* 子弹定义的句柄。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS", meta=(RowType="/Script/GenericCombatSystem.GCS_BulletDefinition"))
|
||
FDataTableRowHandle DefinitionHandle;
|
||
|
||
/**
|
||
* Transform for spawning the bullet.
|
||
* 子弹生成时的变换。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
|
||
FTransform SpawnTransform{FTransform::Identity};
|
||
|
||
/**
|
||
* The associated attack request.
|
||
* 关联的攻击请求。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
|
||
TObjectPtr<const UGCS_AttackRequest_Bullet> Request{nullptr};
|
||
|
||
/**
|
||
* Whether the bullet is locally predicted.
|
||
* 子弹是否为本地预测。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
|
||
bool bIsLocalPredicting{false};
|
||
|
||
/**
|
||
* IDs for locally predicted bullets.
|
||
* 本地预测子弹的ID。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS", meta=(DisplayName="Local Predicting Bullet Ids"))
|
||
TArray<FGuid> OverrideBulletIds;
|
||
|
||
/**
|
||
* ID of the parent bullet (for bullet chains).
|
||
* 父子弹的ID（用于子弹链）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GCS")
|
||
FGuid ParentId;
|
||
|
||
/**
|
||
* Returns a debug string representation.
|
||
* 返回调试字符串表示。
|
||
* @return The debug string. 调试字符串。
|
||
*/
|
||
FString ToDebugString() const;
|
||
};
|