This commit is contained in:
meishibiezb
2026-06-05 03:01:15 +08:00
parent 29a3f77908
commit a8bdf281ff
41 changed files with 1935 additions and 779 deletions

View File

@@ -0,0 +1,55 @@
# DA_InputCommands
## 基本信息
- **类型**: InputCommandData
- **父类**: —
- **源文件**: /Game/Data/DA_InputCommands.DA_InputCommands
- **模块**: Content/Data
## 功能概述
输入命令数据资产,集中定义项目中的输入动作和映射上下文。引用了 8 个 InputActionIA_CameraMoveAction、IA_CameraResetAction、IA_CameraRotateAction、IA_CameraZoomAction、IA_MoveAction、IA_SayHello、IA_Hint、IA_Inventory和 1 个 InputMappingContextIMC_Context
## 设计用意
将输入命令的定义集中到一个数据资产中,作为输入系统的配置中心,方便管理和调整按键映射关系。
## 职责范围
- 集中管理和暴露项目中的输入动作InputAction
- 关联输入映射上下文InputMappingContext
## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| IA_CameraMoveAction | 引用 | /Game/Inputs/IA/IA_CameraMoveAction |
| IA_CameraResetAction | 引用 | /Game/Inputs/IA/IA_CameraResetAction |
| IA_CameraRotateAction | 引用 | /Game/Inputs/IA/IA_CameraRotateAction |
| IA_CameraZoomAction | 引用 | /Game/Inputs/IA/IA_CameraZoomAction |
| IA_MoveAction | 引用 | /Game/Inputs/IA/IA_MoveAction |
| IMC_Context | 引用 | /Game/Inputs/IMC/IMC_Context |
| IA_SayHello | 引用 | /Game/Inputs/IA/IA_SayHello |
| IA_Hint | 引用 | /Game/Inputs/IA/IA_Hint |
| IA_Inventory | 引用 | /Game/Inputs/IA/IA_Inventory |
## 外部视角
DA_InputCommands 是 InputCommandData 数据资产,从外部调用者视角:
**公开数据**
- 持有 8 个 InputAction 的引用IA_MoveAction、IA_CameraMoveAction、IA_CameraZoomAction、IA_CameraRotateAction、IA_CameraResetAction、IA_SayHello、IA_Hint、IA_Inventory
- 持有 1 个 InputMappingContext 引用IMC_Context
**外部交互方式**
- 由 BP_TestCtl 在初始化时加载,作为输入命令定义的配置中心
- 外部系统通过数据资产引用读取其中的 InputAction 和 IMC用于增强输入绑定
- 不提供函数调用接口,所有交互通过读取数据实现
## 使用方法
DA_InputCommands 在项目中的使用方式:
- **BP_TestCtl**`/Game/Blueprints/BP_TestCtl`)— 加载该数据资产,从中获取 InputAction 和 IMC_Context 配置输入系统
## 用例
| 引用方 | 路径 | 用途 |
|--------|------|------|
| BP_TestCtl | `/Game/Blueprints/BP_TestCtl` | 加载输入命令配置,初始化增强输入绑定 |

46
Content/Data/NewGraph.md Normal file
View File

@@ -0,0 +1,46 @@
# NewGraph
## 基本信息
- **类型**: DialogGraphDataAsset
- **父类**: —
- **源文件**: /Game/Data/NewGraph.NewGraph
- **模块**: Content/Data
## 功能概述
对话图数据资产,存储一个对话分支图的定义。作为 Dialog 系统的数据结构,用于定义对话节点的拓扑结构和连接关系。
## 设计用意
Dialog 插件的核心数据资产之一,用于编辑和存储对话流程图,驱动对话系统的分支逻辑。
## 职责范围
- 存储对话图的节点和连接数据
- 供 Dialog 系统运行时加载和解析
## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| (无) | — | — |
## 外部视角
NewGraph 是 DialogGraphDataAsset 数据资产,从外部调用者视角:
**公开数据**
- 存储对话图的节点和连接拓扑数据
- 结构由 Dialog 插件的 DialogGraphDataAsset 类型定义
**外部交互方式**
- Dialog 系统的 UDialogPresentationSubsystem 在运行时加载并解析
- 不提供函数调用接口,通过数据资产引用读取图结构
- 当前项目内无其他资产直接引用MCP 未发现引用者),可能在运行时通过路径加载
## 使用方法
NewGraph 在项目中的使用方式:
- 由 Dialog 插件的数据层加载,作为对话分支图的数据源
- 项目内暂无其他蓝图或 C++ 直接引用该资产
## 用例
(项目内暂无直接使用示例)

View File

@@ -0,0 +1,47 @@
# TestDialog
## 基本信息
- **类型**: DataTable
- **父类**: —
- **源文件**: /Game/Data/TestDialog.TestDialog
- **模块**: Content/Data
## 功能概述
测试对话数据表,用于存储对话框系统的测试数据。结构未知,作为 Dialog 系统的数据输入。
## 设计用意
Dialog 系统的测试数据,用于验证对话数据的加载和解析流程。
## 职责范围
- 存储测试用对话条目数据
- 供 Dialog 系统读取和解析
## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| (无) | — | — |
## 外部视角
TestDialog 是 DataTable 数据资产,从外部调用者视角:
**公开数据**
- 包含测试用对话条目数据行
- 行结构由 Dialog 插件定义的 DataTable 类型决定
**外部交互方式**
- DialogTest 关卡中引用该数据表,由 Dialog 系统加载并解析
- 外部通过 DataTable 引用读取数据行
- 不提供函数调用接口
## 使用方法
TestDialog 在项目中的使用方式:
- **DialogTest 关卡**`/Game/地图关卡/DialogTest`)— 引用该 DataTable作为对话数据的来源
## 用例
| 引用方 | 路径 | 用途 |
|--------|------|------|
| DialogTest | `/Game/地图关卡/DialogTest` | 加载对话测试数据,驱动对话演示 |

View File

@@ -0,0 +1,47 @@
# TestDialogMap
## 基本信息
- **类型**: DataTable
- **父类**: —
- **源文件**: /Game/Data/TestDialogMap.TestDialogMap
- **模块**: Content/Data
## 功能概述
测试对话映射表,用于存储对话 ID 与对话数据的映射关系。作为 Dialog 系统的查询表。
## 设计用意
Dialog 系统的测试数据,用于验证对话映射查询功能。
## 职责范围
- 存储对话 ID 到对话数据的映射关系
- 供 Dialog 系统按 ID 查询对话数据
## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| (无) | — | — |
## 外部视角
TestDialogMap 是 DataTable 数据资产,从外部调用者视角:
**公开数据**
- 包含对话 ID 到对话数据的映射关系
- 行结构由 Dialog 插件定义的 DataTable 类型决定
**外部交互方式**
- DialogTest 关卡中引用该数据表,由 Dialog 系统按 ID 查询对话数据
- 外部通过 DataTable 引用读取映射关系
- 不提供函数调用接口
## 使用方法
TestDialogMap 在项目中的使用方式:
- **DialogTest 关卡**`/Game/地图关卡/DialogTest`)— 引用该 DataTable作为对话映射查询的数据源
## 用例
| 引用方 | 路径 | 用途 |
|--------|------|------|
| DialogTest | `/Game/地图关卡/DialogTest` | 加载对话映射数据,支持按 ID 查询对话 |

View File

@@ -0,0 +1,46 @@
# TestItemDefTable
## 基本信息
- **类型**: DataTable
- **父类**: —
- **源文件**: /Game/Data/Item/TestItemDefTable.TestItemDefTable
- **模块**: Content/Data/Item
## 功能概述
测试物品定义表,用于存储物品定义的测试数据。作为物品系统的配置数据输入。
## 设计用意
物品系统的测试数据表用于验证物品定义ItemDef的加载和解析流程。
## 职责范围
- 存储测试用物品定义数据行
- 供物品系统读取和解析物品定义
## 项目内依赖
| 依赖项 | 关系 | 源文件 |
|--------|------|--------|
| (无) | — | — |
## 外部视角
TestItemDefTable 是 DataTable 数据资产,从外部调用者视角:
**公开数据**
- 包含测试用物品定义ItemDef数据行
- 行结构由 Item 插件定义的 DataTable 类型决定
**外部交互方式**
- Item 插件的 UItemRegistrySubsystem 在运行时加载,注册物品定义
- BP_InventoryComp 等组件通过物品注册表间接引用其中的物品定义
- 当前项目内无其他资产直接引用MCP 未发现引用者),通过运行时路径加载
## 使用方法
TestItemDefTable 在项目中的使用方式:
- 由物品系统的 UItemRegistrySubsystem 加载,作为物品定义的测试数据源
- BP_InventoryComp 在其 BeginPlay 逻辑中通过物品注册表读取物品定义
## 用例
(项目内暂无直接使用示例 — 可能通过运行时路径动态加载)

View File

@@ -0,0 +1,37 @@
# Content/Data 依赖关系
## 文件间引用关系
Content/Data 模块包含 5 个数据资产,均为独立的数据定义/配置,**模块内无文件间引用**。
| 源文件 | 引用方式 | 目标文件 | 目标单位 |
|--------|---------|---------|---------|
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_CameraMoveAction | IA_CameraMoveAction |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_CameraResetAction | IA_CameraResetAction |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_CameraRotateAction | IA_CameraRotateAction |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_CameraZoomAction | IA_CameraZoomAction |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_MoveAction | IA_MoveAction |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_SayHello | IA_SayHello |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_Hint | IA_Hint |
| DA_InputCommands | 引用 | /Game/Inputs/IA/IA_Inventory | IA_Inventory |
| DA_InputCommands | 引用 | /Game/Inputs/IMC/IMC_Context | IMC_Context |
**说明:** DA_InputCommands 的所有引用均指向 /Game/Inputs/ 下的输入资产,属于跨模块引用。其余 4 个数据资产NewGraph、TestDialog、TestDialogMap、TestItemDefTable不引用模块内或其他模块的资产它们是纯粹的数据文件。
## 关键依赖链
**模块结构:**
```
Content/Data/
├── DA_InputCommands — 输入命令配置(引用 InputAction / IMC
├── NewGraph — 对话图数据Dialog 系统数据源)
├── TestDialog — 对话测试数据表
├── TestDialogMap — 对话映射数据表
└── TestItemDefTable — 物品定义测试数据表Content/Data/Item 子模块)
```
**输入配置流:** DA_InputCommands → UEnhancedInputLocalPlayerSubsystem → BP_TestCtl 消费
**对话数据流:** NewGraph / TestDialog / TestDialogMap → UDialogPresentationSubsystem → WBP_TestUI 展示
**物品数据流:** TestItemDefTable → UItemRegistrySubsystem → BP_InventoryComp 加载物品定义