loneseDocument/Content/Blueprints/BP_Barrel.md

BP_Barrel

基本信息

• 类型: Blueprint (Actor)
• 父类: Actor
• 源文件: /Game/Blueprints/Playground/BP_Barrel.BP_Barrel
• 模块: Content/Blueprints/Playground

功能概述

可交互的木桶 Actor，在 Playground 场景中作为可破坏或可互动物体。持有 BarrelWindow（WBP_Window）用于显示交互界面，与库存系统（BP_InventoryComp）和容器系统（BP_DefaultContainer）联动。

设计用意

Playground 场景中的测试用互动物体，用于验证 Actor 与 HUD/库存系统的交互流程。通过 BarrelWindow 窗口展示容器内容，验证库存 UI 与场景物体的数据交互。

职责范围

• 作为场景中的可互动物体持有 BarrelWindow 引用
• 通过 EventGraph（4 事件, 24 节点）处理交互逻辑

项目内依赖

依赖项	关系	源文件
BP_Hud	引用	/Game/Blueprints/BP_Hud
WBP_InventoryView	引用	/Game/Blueprints/UI/Item/WBP_InventoryView
WBP_Window	包含(变量)	/Game/Blueprints/UI/WBP_Window
BP_TestCtl	引用	/Game/Blueprints/BP_TestCtl
BP_InventoryComp	引用	/Game/Blueprints/Playground/BP_InventoryComp
BP_DefaultContainer	引用	/Game/Blueprints/Playground/BP_DefaultContainer

外部视角

BP_Barrel 是 Actor 的子类，从外部调用者视角：

公开属性（蓝图可读写）

• BarrelWindow（WBP_Window_C*）— 木桶交互界面的窗口 Widget

核心行为

• 通过 BP_Hud 获取 InvView（WBP_InventoryView）显示木桶内物品
• 通过 BP_InventoryComp / BP_DefaultContainer 管理木桶库存
• 通过 BP_TestCtl 获取控制器引用

EventGraph 事件

事件	类型	触发时机	行为
事件开始运行	原生覆盖 (BeginPlay)	Actor 生成时由引擎自动触发	创建 BP_DefaultContainer → 通过 IItemContainer 创建随机数量的 TestItem → 遍历新物品 ID → 通过 IInventory 接收物品
事件Actor开始重叠	原生覆盖 (OnActorBeginOverlap)	其他 Actor 进入重叠区域时	预留（当前无连线逻辑）
事件Tick	原生覆盖	每帧	预留（当前无连线逻辑）
On Clicked (Barrel)	组件绑定事件	玩家点击木桶碰撞体时	获取 PlayerController → GetHUD → Cast 到 BP_Hud → 创建 WBP_Window（设 IsTemp=true）和 WBP_InventoryView → BindToComp 绑定到木桶的 BP_InventoryComp → 作为子项添加到 HUD

外部交互方式

• 放置在 Playground 关卡中作为可交互场景物体
• 玩家靠近/与木桶交互时，通过 HUD 显示库存界面

使用方法

BP_Barrel 在项目中的典型调用流程：

• 木桶交互流程 — 玩家点击木桶碰撞体 → 触发 On Clicked (Barrel) → 获取 PlayerController → GetHUD → Cast 到 BP_Hud → 创建临时 WBP_Window 和 WBP_InventoryView → BindToComp 绑定到木桶的 BP_InventoryComp → 显示木桶库存 UI
• 木桶初始化流程 — BeginPlay → 创建 BP_DefaultContainer → 调用 CreateItem 生成随机数量 TestItem → 通过 IInventory 接口接收物品到木桶的 InventoryComp

用例

引用方	路径	用途
Playground	/Game/地图关卡/Playground	关卡中的可交互木桶，演示物品查看/拾取流程