init

Plugins/Item/UItemRegistrySettings.md

@@ -0,0 +1,83 @@
+# UItemRegistrySettings
+
+## 基本信息
+- **类型**: UCLASS(Config=Game, DefaultConfig)
+- **父类**: UDeveloperSettings
+- **源文件**: Plugins/Item/Source/Item/Public/ItemRegistrySettings.h
+- **模块**: Item
+
+## 功能概述
+Item插件的项目设置类。可在编辑器中的 Project Settings > Game > Item Registry Settings 下配置。包含DataTable软引用和视图策略类软引用的TMap。软引用避免启动时急切加载。
+
+## 设计用意
+设计时配置的契约。UDeveloperSettings将配置存储在DefaultGame.ini中。软引用避免在启动时加载所有内容。标准的UE项目设置模式。
+
+## 职责范围
+配置数据容器。将名称映射到DataTable/策略类资产。由UItemRegistrySubsystem::Initialize在游戏启动时读取。无运行时逻辑。
+
+## 项目内依赖
+（无项目内依赖）
+
+## 对外接口
+UItemRegistrySettings 是 UDeveloperSettings 子类（Config=Game, DefaultConfig），作为项目配置容器，本身没有可调用的方法（仅有默认构造函数）。外部通过以下两个 UPROPERTY 读取配置：
+
+- **ItemDataTables** (TMap<FName, TSoftObjectPtr<UDataTable>>): 物品 DataTable 的映射表。键为逻辑名称（如 "Default"），值为 DataTable 资产的软引用路径。在编辑器中通过 Project Settings > Game > Item Registry Settings 配置。
+- **ViewStrategies** (TMap<FName, TSoftClassPtr<UObject>>): 视图策略类的映射表。键为属性名称（对应 IItemViewStrategy::GetPropertyName），值为实现了 ItemViewStrategy 接口的 Blueprint 类软引用。
+
+**读取方式：**
+由 UItemRegistrySubsystem::Initialize 通过 GetDefault<UItemRegistrySettings>() 获取单例，遍历两个 TMap 调用 LoadSynchronous 加载软引用并注册（ItemRegistrySubsystem.cpp:58-80）。
+
+**配置存储：**
+标记 Config=Game 使这些字段存储在 DefaultGame.ini 中。设计师不需要修改代码，只需在项目设置编辑器中配置 DataTable 和策略类的映射关系即可。软引用（TSoftObjectPtr / TSoftClassPtr）避免在游戏启动时急切加载所有资产。
+
+## 使用方法
+UItemRegistrySettings 是纯配置数据容器，由研发人员在项目设置中配置。
+
+**配置路径：**
+编辑器中：Project Settings > Game > Item Registry Settings（由 meta = (DisplayName = "Item Registry Settings") 定义）。
+
+**配置 ItemDataTables：**
+在 "General" 分类下，添加键值对：
+- 键：DataTable 的逻辑名称（如 "Items"、"Equipment"）。
+- 值：指向 DataTable 资产（其行结构体为 FItemDef）的软引用。
+
+**配置 ViewStrategies：**
+在 "Strategies" 分类下，添加键值对：
+- 键：属性名称（与 IItemViewStrategy::GetPropertyName() 返回值一致，如 "Attribute_Health"）。
+- 值：指向实现了 ItemViewStrategy 接口的 Blueprint 类的软引用。
+
+**运行时加载（ItemRegistrySubsystem.cpp:58-80）：**
+```cpp
+void UItemRegistrySubsystem::Initialize(FSubsystemCollectionBase& Collection)
+{
+    Super::Initialize(Collection);
+    const UItemRegistrySettings* Settings =
+        GetDefault<UItemRegistrySettings>();
+
+    for (const auto& Pair : Settings->ItemDataTables)
+    {
+        if (UDataTable* LoadedTable = Pair.Value.LoadSynchronous())
+            RegisterDataTable(Pair.Key, LoadedTable);
+    }
+    for (const auto& Pair : Settings->ViewStrategies)
+    {
+        if (UClass* StrategyClass = Pair.Value.LoadSynchronous())
+        {
+            TScriptInterface<IItemViewStrategy> NewStrategy =
+                NewObject<UObject>(this, StrategyClass);
+            RegisterViewStrategy(Pair.Key, NewStrategy);
+        }
+    }
+}
+```
+
+**配置存储位置：**
+标记 Config=Game 使配置写入 DefaultGame.ini。多个平台可共享同一配置，也可按平台覆写。
+
+## 用例
+- `Plugins/Item/Source/Item/Public/ItemRegistrySettings.h:13-23` -- UItemRegistrySettings 类声明（ItemDataTables + ViewStrategies 两个 UPROPERTY + 构造函数）。
+- `Plugins/Item/Source/Item/Private/ItemRegistrySettings.cpp:6-8` -- 构造函数实现（空实现，所有工作在 UPROPERTY 初始化器中完成）。
+- `Plugins/Item/Source/Item/Private/ItemRegistrySubsystem.cpp:59` -- Initialize 中通过 GetDefault<UItemRegistrySettings>() 获取配置单例。
+- `Plugins/Item/Source/Item/Private/ItemRegistrySubsystem.cpp:62-68` -- Initialize 中遍历 Settings->ItemDataTables，LoadSynchronous 每个软引用并注册。
+- `Plugins/Item/Source/Item/Private/ItemRegistrySubsystem.cpp:70-78` -- Initialize 中遍历 Settings->ViewStrategies，LoadSynchronous 每个类，NewObject 实例化策略并注册。
+- `Plugins/Item/Source/Item/Private/ItemRegistrySubsystem.cpp:79-80` -- Initialize 完成后通过 UE_LOG 输出注册的 DataTable 和策略数量。