第一次提交

Plugins/GGS/Source/GenericGameSystem/Public/Utilities/GGS_SocketRelationshipMapping.h

@@ -0,0 +1,135 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "Engine/DataAsset.h"
+#include "GGS_SocketRelationshipMapping.generated.h"
+
+/**
+ * Structure for socket adjustments.
+ * 插槽调整结构。
+ */
+USTRUCT(BlueprintType)
+struct GENERICGAMESYSTEM_API FGGS_SocketAdjustment
+{
+	GENERATED_BODY()
+
+	/**
+	 * Array of skeleton names for the adjustment.
+	 * 调整适用的骨骼名称数组。
+	 */
+	UPROPERTY(EditAnywhere, Category="GGS")
+	TArray<FString> ForSkeletons;
+
+	/**
+	 * Name of the socket.
+	 * 插槽名称。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
+	FName SocketName{NAME_None};
+
+	/**
+	 * Relative transform for the socket.
+	 * 插槽的相对变换。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
+	FTransform RelativeTransform;
+
+#if WITH_EDITORONLY_DATA
+	/**
+	 * Editor-friendly name for the adjustment.
+	 * 调整的编辑器友好名称。
+	 */
+	UPROPERTY(EditAnywhere, Category="GGS", meta=(EditCondition=false, EditConditionHides))
+	FString EditorFriendlyName;
+#endif
+};
+
+/**
+ * Structure for socket relationships.
+ * 插槽关系结构。
+ */
+USTRUCT(BlueprintType)
+struct GENERICGAMESYSTEM_API FGGS_SocketRelationship
+{
+	GENERATED_BODY()
+
+	/**
+	 * Mesh asset associated with the relationship.
+	 * 与关系关联的网格资产。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS")
+	TSoftObjectPtr<UStreamableRenderAsset> MeshAsset;
+
+	/**
+	 * Array of socket adjustments for the mesh.
+	 * 网格的插槽调整数组。
+	 * @note Will look from bottom to top; 从下往上查询。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS", meta=(TitleProperty="EditorFriendlyName"))
+	TArray<FGGS_SocketAdjustment> Adjustments;
+
+#if WITH_EDITORONLY_DATA
+	/**
+	 * Editor-friendly name for the relationship.
+	 * 关系的编辑器友好名称。
+	 */
+	UPROPERTY(EditAnywhere, Category="GGS", meta=(EditCondition=false, EditConditionHides))
+	FString EditorFriendlyName;
+#endif
+};
+
+/**
+ * Data asset for defining socket relationships for mesh attachments.
+ * 定义网格附件插槽关系的数据资产。
+ */
+UCLASS(BlueprintType)
+class GENERICGAMESYSTEM_API UGGS_SocketRelationshipMapping : public UDataAsset
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Finds a socket adjustment for a given mesh and socket.
+	 * 查找给定网格和插槽的插槽调整。
+	 * @param InParentMeshComponent The parent mesh component. 父网格组件。
+	 * @param InMeshAsset The mesh asset. 网格资产。
+	 * @param InSocketName The socket name. 插槽名称。
+	 * @param OutAdjustment The found socket adjustment (output). 找到的插槽调整（输出）。
+	 * @return True if an adjustment was found, false otherwise. 如果找到调整返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, BlueprintPure=False, Category="GGS|Utilities")
+	bool FindSocketAdjustment(const USkeletalMeshComponent* InParentMeshComponent, const UStreamableRenderAsset* InMeshAsset, FName InSocketName,
+	                          FGGS_SocketAdjustment& OutAdjustment) const;
+
+	/**
+	 * Finds a socket adjustment across multiple mappings.
+	 * 在多个映射中查找插槽调整。
+	 * @param InMappings The socket relationship mappings. 插槽关系映射。
+	 * @param InParentMeshComponent The parent mesh component. 父网格组件。
+	 * @param InMeshAsset The mesh asset. 网格资产。
+	 * @param InSocketName The socket name. 插槽名称。
+	 * @param OutAdjustment The found socket adjustment (output). 找到的插槽调整（输出）。
+	 * @return True if an adjustment was found, false otherwise. 如果找到调整返回true，否则返回false。
+	 */
+	UFUNCTION(BlueprintCallable, Category="GGS|Utilities")
+	static bool FindSocketAdjustmentInMappings(TArray<TSoftObjectPtr<UGGS_SocketRelationshipMapping>> InMappings, const USkeletalMeshComponent* InParentMeshComponent,
+	                                           const UStreamableRenderAsset* InMeshAsset, FName InSocketName,
+	                                           FGGS_SocketAdjustment& OutAdjustment);
+
+	/**
+	 * Array of socket relationships.
+	 * 插槽关系数组。
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="GGS", meta=(TitleProperty="EditorFriendlyName"))
+	TArray<FGGS_SocketRelationship> Relationships;
+
+#if WITH_EDITORONLY_DATA
+	/**
+	 * Pre-save processing for editor.
+	 * 编辑器预保存处理。
+	 */
+	virtual void PreSave(FObjectPreSaveContext SaveContext) override;
+#endif
+};