// 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;
};