65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# BP_NewChar
|
||
|
||
## 基本信息
|
||
- **类型**: Blueprint (Character)
|
||
- **父类**: Character
|
||
- **源文件**: /Game/Blueprints/BP_NewChar.BP_NewChar
|
||
- **模块**: Content/Blueprints
|
||
|
||
## 功能概述
|
||
实验性角色蓝图，继承自 Character。作为一个轻量级角色模板，用于测试角色控制组件（BP_RouterComp）和移动输入组件（BP_MoveInput）的集成。不含自定义变量，仅包含 3 个事件和 3 个节点的简单事件图。
|
||
|
||
## 设计用意
|
||
基础 Character 子类，作为角色控制功能（路由组件、移动输入）的挂载载体。不添加自定义逻辑，保持最小化以便在不同的测试场景中复用。
|
||
|
||
## 职责范围
|
||
- 作为 Character 子类挂载 BP_RouterComp、BP_MoveInput、BP_SayHello 等组件
|
||
|
||
## 项目内依赖
|
||
| 依赖项 | 关系 | 源文件 |
|
||
|--------|------|--------|
|
||
| BP_RouterComp | 引用(组件) | /CharacterControl/BP_RouterComp |
|
||
| ABP_TestChar | 引用(动画) | /Game/Blueprints/Anim/ABP_TestChar |
|
||
| BP_MoveInput | 引用(组件) | /Game/Blueprints/Component/BP_MoveInput |
|
||
| BP_SayHello | 引用(组件) | /Game/Blueprints/Component/BP_SayHello |
|
||
|
||
## 外部视角
|
||
|
||
BP_NewChar 是 Character 的子类，从外部调用者视角：
|
||
|
||
**EventGraph 事件**
|
||
|
||
| 事件 | 类型 | 触发时机 | 行为 |
|
||
|------|------|----------|------|
|
||
| `事件开始运行` | 原生覆盖 (BeginPlay) | 角色生成时由引擎自动触发 | 预留（当前无连线逻辑） |
|
||
| `事件Actor开始重叠` | 原生覆盖 (OnActorBeginOverlap) | 与其他 Actor 碰撞时 | 预留（当前无连线逻辑） |
|
||
| `事件Tick` | 原生覆盖 | 每帧 | 预留（当前无连线逻辑） |
|
||
|
||
**接口概览**
|
||
- 无自定义变量或公开函数
|
||
- 极简事件图（3 事件, 3 节点）
|
||
|
||
**组件装配**
|
||
- BP_RouterComp（来自 CharacterControl 插件）— 指令路由组件
|
||
- BP_MoveInput — 移动输入端点组件
|
||
- BP_SayHello — 指令测试端点组件
|
||
- 动画蓝图类设为 ABP_TestChar
|
||
|
||
**外部交互方式**
|
||
- BP_TestMode 可以在蓝图层将其设为默认 Pawn
|
||
- BP_ItemTrap 引用该角色，用于触发式物品发放的目标
|
||
|
||
## 使用方法
|
||
|
||
BP_NewChar 在项目中的典型调用流程：
|
||
|
||
- **物品发放流程** — BP_ItemTrap 触发 → 通过 BP_NewChar 引用将物品发放到目标角色的 InventoryComp 中
|
||
- **潜在游戏替换流程** — BP_TestMode 可替换 DefaultPawnClass 为 BP_NewChar → 引擎使用 BP_NewChar 替代 BP_TestChar 作为玩家角色
|
||
|
||
## 用例
|
||
|
||
| 引用方 | 路径 | 用途 |
|
||
|--------|------|------|
|
||
| BP_ItemTrap | `/Game/Blueprints/Playground/BP_ItemTrap` | 作为物品发放的目标角色引用 |
|
||
| BP_TestMode | `/Game/Blueprints/BP_TestMode` | 可能的 DefaultPawn 替代选择 |
|