第一次提交

2026-03-03 01:23:02 +08:00
commit 3e434877e8
1053 changed files with 102411 additions and 0 deletions
--- a/Plugins/GGS/Source/GenericGameSystem/Public/Interaction/GGS_SmartObjectFunctionLibrary.h
+++ b/Plugins/GGS/Source/GenericGameSystem/Public/Interaction/GGS_SmartObjectFunctionLibrary.h
@@ -0,0 +1,70 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GGS_InteractionStructLibrary.h"
+#include "SmartObjectSubsystem.h"
+#include "SmartObjectTypes.h"
+#include "Kismet/BlueprintFunctionLibrary.h"
+#include "GGS_SmartObjectFunctionLibrary.generated.h"
+
+class UGameplayInteractionSmartObjectBehaviorDefinition;
+class UGameplayBehaviorSmartObjectBehaviorDefinition;
+class UGameplayBehaviorConfig;
+class USmartObjectBehaviorDefinition;
+
+/**
+ * Blueprint function library for smart object interactions.
+ * 智能对象交互的蓝图函数库。
+ */
+UCLASS()
+class GENERICGAMESYSTEM_API UGGS_SmartObjectFunctionLibrary : public UBlueprintFunctionLibrary
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Retrieves the gameplay behavior config from a smart object behavior definition.
+	 * 从智能对象行为定义获取游戏行为配置。
+	 * @param BehaviorDefinition The smart object behavior definition. 智能对象行为定义。
+	 * @return The gameplay behavior config. 游戏行为配置。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure, Category = "GGS|SmartObject")
+	static UGameplayBehaviorConfig* GetGameplayBehaviorConfig(const USmartObjectBehaviorDefinition* BehaviorDefinition);
+
+	/**
+	 * Finds a specific gameplay behavior config by class.
+	 * 按类查找特定游戏行为配置。
+	 * @param BehaviorDefinition The smart object behavior definition. 智能对象行为定义。
+	 * @param DesiredClass The desired config class. 期望的配置类。
+	 * @param OutConfig The found config (output). 找到的配置（输出）。
+	 * @return True if the config was found, false otherwise. 如果找到配置返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GGS|SmartObject", meta=(DeterminesOutputType="DesiredClass", DynamicOutputParam="OutConfig", ExpandBoolAsExecs="ReturnValue"))
+	static bool FindGameplayBehaviorConfig(const USmartObjectBehaviorDefinition* BehaviorDefinition, TSubclassOf<UGameplayBehaviorConfig> DesiredClass, UGameplayBehaviorConfig*& OutConfig);
+
+	/**
+	 * Searches for smart object slots with interaction entrances on an actor.
+	 * 在演员上搜索带有交互入口的智能对象槽。
+	 * @param Filter The search filter. 搜索过滤器。
+	 * @param SearchActor The actor to search. 要搜索的演员。
+	 * @param OutResults The found smart object slot candidates (output). 找到的智能对象槽候选（输出）。
+	 * @param UserActor Optional actor for additional data in condition evaluation. 用于条件评估的可选演员。
+	 * @return True if at least one candidate was found, false otherwise. 如果找到至少一个候选返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure = False, Category = "GGS|SmartObject", Meta = (ReturnDisplayName = "bSuccess"))
+	static bool FindSmartObjectsWithInteractionEntranceInActor(const FSmartObjectRequestFilter& Filter, AActor* SearchActor, TArray<FSmartObjectRequestResult>& OutResults,
+	                                                           const AActor* UserActor = nullptr);
+
+	/**
+	 * Finds the interaction definition for a smart object slot.
+	 * 查找智能对象槽的交互定义。
+	 * @param WorldContext The world context object. 世界上下文对象。
+	 * @param SmartObjectSlotHandle The smart object slot handle. 智能对象槽句柄。
+	 * @param OutDefinition The interaction definition (output). 交互定义（输出）。
+	 * @return True if the definition was found, false otherwise. 如果找到定义返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GGS|SmartObject", meta=(WorldContext="WorldContext", ExpandBoolAsExecs="ReturnValue"))
+	static bool FindInteractionDefinitionFromSmartObjectSlot(UObject* WorldContext, FSmartObjectSlotHandle SmartObjectSlotHandle, UGGS_InteractionDefinition*& OutDefinition);
+};