init

Content/Blueprints/BP_TestChar.md

@@ -0,0 +1,57 @@
+# BP_TestChar
+
+## 基本信息
+- **类型**: Blueprint (Actor)
+- **父类**: AMyCharacter
+- **源文件**: /Game/Blueprints/BP_TestChar.BP_TestChar
+- **模块**: Content
+
+## 功能概述
+BP_TestChar 是玩家主角的蓝图实现，继承 C++ 的 AMyCharacter。它通过添加 CharacterControl 插件的路由组件来扩展角色能力，在蓝图层面组合移动、指令路由和摄像机控制。
+
+## 设计用意
+AMyCharacter 在 C++ 层提供了移动和摄像机 Pawn 创建的基础能力。BP_TestChar 在蓝图层面通过组件化的方式组装角色功能：添加 UCommandRouterComponent 将角色变成指令路由中心，添加各种 ICommandEndpoint 组件处理不同类型的指令。作为项目的核心 Pawn，它是指令系统和角色能力的"组装层"——新功能通过添加新的端点组件来扩展，而非修改 C++ 代码。
+
+## 职责范围
+BP_TestChar 是角色的蓝图配置层，负责添加并配置 CharacterControl 路由组件和端点组件，实现角色重叠、Tick 等蓝图级逻辑。移动逻辑由 AMyCharacter C++ 层处理，摄像机逻辑由 ACameraPawn 负责。
+
+## 项目内依赖
+| 依赖项 | 关系 | 源文件 |
+|--------|------|--------|
+| AMyCharacter | 父类 | /Game/Blueprints/BP_TestChar (C++ 继承) |
+| ACameraPawn | 间接（CameraActorClass） | /Game/Blueprints/BP_CameraPawn |
+| UCommandRouterComponent | 组件 | CharacterControl 插件 |
+| BP_UniversalEndpointComp | 组件 | /Game/Blueprints/Component/BP_UniversalEndpointComp |
+| BP_MoveInput | 组件 | /Game/Blueprints/Component/BP_MoveInput |
+| BP_ControllerComp | 组件 | /Game/Blueprints/Component/BP_ControllerComp |
+| BP_SayHello | 组件 | /Game/Blueprints/Component/BP_SayHello |
+
+## 对外接口
+- **继承自 AMyCharacter 的 BlueprintCallable 函数**：
+  - `Move(const FInputActionValue& Value)` -- 移动输入处理，供 EnhancedInput 绑定调用
+  - `BeginRun(const FInputActionValue& Value)` / `StopRun(const FInputActionValue& Value)` -- 奔跑切换
+  - `BeginCrouch(const FInputActionValue& Value)` / `StopCrouch(const FInputActionValue& Value)` -- 蹲伏切换
+  - `IsRunning() const` / `IsCrouching() const` -- 状态查询
+- **继承自 AMyCharacter 的 BlueprintReadOnly 属性**：
+  - `DefaultMapping` (UInputMappingContext*) -- 默认输入映射上下文
+  - `MoveAction`, `RunAction`, `CrouchAction`, `CameraMoveAction`, `CameraZoomAction`, `CameraResetAction`, `CameraRotateAction` -- 各输入动作引用
+  - `CameraActorClass` (TSubclassOf<ACameraPawn>) -- 摄像机 Pawn 类，设置为 BP_CameraPawn
+- **身上的组件作为对外能力**：
+  - `UCommandRouterComponent` -- 指令路由中心，通过 RegisterEndpoint / InputCommand 接收和分发指令
+  - `BP_UniversalEndpointComp` -- 通用端点，对外暴露 `CommandReceivedDispatcher` 动态多播委托
+  - `BP_MoveInput` -- 移动端点，对外暴露 `CharMove` (CharacterMovementComponent*) 变量
+  - `BP_ControllerComp` -- 摄像机控制端点，对外暴露 `MoveController`、`RotateController`、`ZoomCamera`、`ResetControllerLocation`、`TickFollowChar` 函数及摄像机配置参数
+  - `BP_SayHello` -- 测试端点，验证指令路由系统
+
+## 使用方法
+- 在 BP_TestMode 中设置为 `DefaultPawnClass`，作为项目的默认 Pawn
+- 在蓝图编辑器中添加 CharacterControl 路由和端点组件：`UCommandRouterComponent` 作为指令路由器，`BP_UniversalEndpointComp`、`BP_MoveInput`、`BP_ControllerComp`、`BP_SayHello` 作为各类指令端点
+- 通过父类 AMyCharacter 的 `CameraActorClass` 属性指定 BP_CameraPawn 作为分离式摄像机
+- 配置父类的 InputAction 属性（MoveAction、RunAction 等）连接 EnhancedInput 系统
+- 各端点组件通过 `EndpointState.InterestedTags` 配置关注的 GameplayTag，UCommandRouterComponent 的 `AutoRegisterEndpoints` 在 BeginPlay 时自动注册所有组件上的端点
+- 指令链路：EnhancedInput -> UCommandInputComponent -> UCommandRouterComponent -> 匹配的端点组件
+
+## 用例
+- BP_TestMode 的 `DefaultPawnClass`，作为玩家进入关卡时的默认角色
+- 身上挂载的 `BP_UniversalEndpointComp`、`BP_MoveInput`、`BP_ControllerComp`、`BP_SayHello` 作为该角色的指令处理端点
+- `CameraActorClass` 属性引用 BP_CameraPawn，角色被 Possess 时自动生成摄像机