102 lines
3.5 KiB
C++
102 lines
3.5 KiB
C++
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "CoreMinimal.h"
|
|
#include "GCS_BulletStructLibrary.h"
|
|
#include "Subsystems/WorldSubsystem.h"
|
|
#include "GCS_BulletSubsystem.generated.h"
|
|
|
|
class UGCS_AttackRequest_Bullet;
|
|
class AGCS_BulletInstance;
|
|
|
|
|
|
/**
|
|
* Subsystem for managing bullet spawning and lifecycle.
|
|
* 管理子弹生成和生命周期的子系统。
|
|
*/
|
|
UCLASS()
|
|
class GENERICCOMBATSYSTEM_API UGCS_BulletSubsystem : public UWorldSubsystem
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
static UGCS_BulletSubsystem* Get(const UWorld* World);
|
|
|
|
/**
|
|
* Spawns bullets based on the provided parameters.
|
|
* 根据提供的参数生成子弹。
|
|
* @param SpawnParameters The spawn parameters. 生成参数。
|
|
* @return The spawned bullet instances. 生成的子弹实例。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category="GCS|Bullet")
|
|
virtual TArray<AGCS_BulletInstance*> SpawnBullets(const FGCS_BulletSpawnParameters& SpawnParameters);
|
|
|
|
/**
|
|
* Gets the IDs of the provided bullet instances.
|
|
* 获取提供的子弹实例的ID。
|
|
* @param Instances The bullet instances. 子弹实例。
|
|
* @return The IDs of the bullets. 子弹的ID。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, BlueprintPure, Category="GCS|Bullet")
|
|
virtual TArray<FGuid> GetIdsFromBullets(TArray<AGCS_BulletInstance*> Instances);
|
|
|
|
/**
|
|
* Gets or creates bullet instances based on parameters and definition.
|
|
* 根据参数和定义获取或创建子弹实例。
|
|
* @param SpawnParameters The spawn parameters. 生成参数。
|
|
* @param Definition The bullet definition. 子弹定义。
|
|
* @return The bullet instances. 子弹实例。
|
|
*/
|
|
TArray<AGCS_BulletInstance*> GetOrCreateBulletInstances(const FGCS_BulletSpawnParameters& SpawnParameters, const FGCS_BulletDefinition& Definition);
|
|
|
|
/**
|
|
* Retrieves a bullet instance from the pool.
|
|
* 从池中获取子弹实例。
|
|
* @param BulletClass The class of the bullet. 子弹的类。
|
|
* @return The bullet instance. 子弹实例。
|
|
*/
|
|
AGCS_BulletInstance* TakeBulletFromPool(TSubclassOf<AGCS_BulletInstance> BulletClass);
|
|
|
|
/**
|
|
* Destroys a bullet by its ID.
|
|
* 根据ID销毁子弹。
|
|
* @param BulletId The bullet ID. 子弹ID。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category="GCS|Bullet")
|
|
virtual void DestroyBullet(FGuid BulletId);
|
|
|
|
/**
|
|
* Creates a single bullet instance.
|
|
* 创建单个子弹实例。
|
|
* @param SpawnParameters The spawn parameters. 生成参数。
|
|
* @param Definition The bullet definition. 子弹定义。
|
|
* @return The created bullet instance. 创建的子弹实例。
|
|
*/
|
|
AGCS_BulletInstance* CreateBulletInstance(const FGCS_BulletSpawnParameters& SpawnParameters, const FGCS_BulletDefinition& Definition);
|
|
|
|
/**
|
|
* Loads a bullet definition from a handle.
|
|
* 从句柄加载子弹定义。
|
|
* @param Handle The bullet definition handle. 子弹定义句柄。
|
|
* @param OutDefinition The loaded definition (output). 加载的定义（输出）。
|
|
* @return True if the definition was loaded successfully. 如果定义加载成功返回true。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, BlueprintPure=false, Category="GCS|Bullet", meta=(ExpandBoolAsExecs="ReturnValue"))
|
|
virtual bool LoadBulletDefinition(const FDataTableRowHandle& Handle, FGCS_BulletDefinition& OutDefinition);
|
|
|
|
/**
|
|
* Active bullet instances mapped by their IDs.
|
|
* 按ID映射的激活子弹实例。
|
|
*/
|
|
UPROPERTY()
|
|
TMap<FGuid, TObjectPtr<AGCS_BulletInstance>> BulletInstances;
|
|
|
|
/**
|
|
* Pool of bullet instances for reuse.
|
|
* 用于重用的子弹实例池。
|
|
*/
|
|
UPROPERTY()
|
|
TArray<TObjectPtr<AGCS_BulletInstance>> BulletPools;
|
|
};
|