138 lines
4.3 KiB
Markdown
138 lines
4.3 KiB
Markdown
# PHY 编辑器打通清单（装备/药品/通知）
|
||
|
||
> 目标：打通你当前 C++ 已实现的链路：
|
||
> - 装备穿脱 -> 属性生效/回滚
|
||
> - 药品使用（Server RPC）-> 扣除库存 -> 恢复属性
|
||
> - 通知飘字（Info/Reward/Warning）
|
||
|
||
## 0. 代码前提（已实现）
|
||
|
||
- `APHYCharacter` 已挂载：`InventorySystem` + `EquipmentSystem`。
|
||
- 服务器 `BeginPlay` 会初始化库存与装备系统。
|
||
- `APHYPlayerCharacter::ServerUseConsumableByItemId` 已有严格校验：
|
||
- 必须是 `GIS.Item.Type.Consumable`
|
||
- 找不到道具/扣除失败会发 Warning 通知
|
||
- `APHYPlayerState` 已接入 owner 通知分发（支持 DS/Listen/Standalone）。
|
||
|
||
## 1. GameplayTags（必须先做）
|
||
|
||
请在 `Project Settings -> Gameplay Tags` 或 `Config/DefaultGameplayTags.ini` 中确认存在：
|
||
|
||
### 1.1 类型标签（必须）
|
||
|
||
- `GIS.Item.Type.Weapon`
|
||
- `GIS.Item.Type.Equipment`
|
||
- `GIS.Item.Type.Consumable`
|
||
- `GIS.Item.Type.Material`
|
||
|
||
### 1.2 药品效果标签（必须）
|
||
|
||
- `GIS.Attribute.Item.Consumable.RestoreHealth`
|
||
- `GIS.Attribute.Item.Consumable.RestoreInnerPower`
|
||
|
||
### 1.3 装备属性标签（建议）
|
||
|
||
- `GIS.Attribute.Item.Attack`
|
||
- `GIS.Attribute.Item.Defense`
|
||
- `GIS.Attribute.Item.CritRate`
|
||
- `GIS.Attribute.Item.CritDamage`
|
||
- `GIS.Attribute.Item.Hit`
|
||
- `GIS.Attribute.Item.Dodge`
|
||
- `GIS.Attribute.Item.Parry`
|
||
- `GIS.Attribute.Item.CounterChance`
|
||
- `GIS.Attribute.Item.ArmorPenetration`
|
||
- `GIS.Attribute.Item.DamageReduction`
|
||
- `GIS.Attribute.Item.LifeSteal`
|
||
- `GIS.Attribute.Item.Resilience`
|
||
- `GIS.Attribute.Item.MoveSpeed`
|
||
- `GIS.Attribute.Item.HealthRegenRate`
|
||
- `GIS.Attribute.Item.InnerPowerRegenRate`
|
||
- `GIS.Attribute.Item.MaxHealth`
|
||
- `GIS.Attribute.Item.MaxInnerPower`
|
||
|
||
## 2. 角色蓝图组件配置
|
||
|
||
打开你的玩家角色蓝图（继承 `APHYPlayerCharacter`）：
|
||
|
||
1. 选中 `InventorySystem` 组件：
|
||
- 确认存在普通背包集合（如 `GIS.Collection.Inventory`）
|
||
- 确认存在装备槽集合（如 `GIS.Collection.Equipped`，SlotCollection）
|
||
2. 选中 `EquipmentSystem` 组件：
|
||
- `TargetCollectionTag` 设为装备槽集合标签（如 `GIS.Collection.Equipped`）
|
||
|
||
> 若 `TargetCollectionTag` 不匹配，装备状态事件不会触发，属性不会生效。
|
||
|
||
## 3. 创建三类物品（UGIS_ItemDefinition）
|
||
|
||
## 3.1 药品示例：`ID_Cons_HealthSmall`
|
||
|
||
- `DisplayName`: 小还丹
|
||
- `ItemTags`: 添加 `GIS.Item.Type.Consumable`
|
||
- 图标：设置 `Icon`
|
||
- 动态或静态属性至少配置其一：
|
||
- `GIS.Attribute.Item.Consumable.RestoreHealth = 120`
|
||
- `GIS.Attribute.Item.Consumable.RestoreInnerPower = 0`
|
||
|
||
## 3.2 武器示例：`ID_Wpn_BronzeSword`
|
||
|
||
- `DisplayName`: 青铜剑
|
||
- `ItemTags`: 添加 `GIS.Item.Type.Weapon`
|
||
- 属性：
|
||
- `GIS.Attribute.Item.Attack = 35`
|
||
- `GIS.Attribute.Item.CritRate = 0.03`
|
||
|
||
## 3.3 装备示例：`ID_Equip_ClothArmor`
|
||
|
||
- `DisplayName`: 布甲
|
||
- `ItemTags`: 添加 `GIS.Item.Type.Equipment`
|
||
- 属性：
|
||
- `GIS.Attribute.Item.Defense = 20`
|
||
- `GIS.Attribute.Item.DamageReduction = 0.02`
|
||
|
||
## 4. 物品“使用”按钮绑定（UI）
|
||
|
||
在你的物品操作逻辑中（右键菜单/快捷键）：
|
||
|
||
1. 从 `UItemData` 取 `ItemInfo.Item`
|
||
2. `Item->GetItemId()` 拿到 `FGuid`
|
||
3. `GetOwningPlayerPawn` -> Cast `APHYPlayerCharacter`
|
||
4. 调用：`ServerUseConsumableByItemId(ItemId, 1)`
|
||
|
||
## 5. 通知验证点
|
||
|
||
你当前 UI 会接 `OnGameplayNotifyDelegate`，预期：
|
||
|
||
- 使用药品成功：`Reward`（例如：使用 小还丹 x1）
|
||
- 使用非药品：`Warning`
|
||
- 数量不足/扣除失败：`Warning`
|
||
- 装备成功：`Info`（装备 xxx）
|
||
- 卸下成功：`Info`（卸下 xxx）
|
||
|
||
## 6. 联机验收顺序（建议）
|
||
|
||
1. Standalone
|
||
2. Listen Server + 1 Client
|
||
3. Dedicated Server + 1 Client
|
||
|
||
每轮都检查：
|
||
|
||
- 药品是否扣库存
|
||
- 生命/内力是否恢复
|
||
- 装备/卸下是否改变属性
|
||
- 通知是否只在拥有者客户端显示
|
||
|
||
## 7. 常见问题
|
||
|
||
- **现象：药品点了无反应**
|
||
- 常见原因：缺少 `GIS.Item.Type.Consumable`
|
||
- **现象：装备后属性不变**
|
||
- 常见原因：`EquipmentSystem.TargetCollectionTag` 不匹配装备集合
|
||
- **现象：Dedicated Server 下无提示**
|
||
- 先确认 HUD/UI 绑定是否在客户端建立；`PlayerState` 已支持 owner 通知分发
|
||
|
||
---
|
||
|
||
如果你需要，我可以继续生成第二份文档：
|
||
- `PHY_Item_Asset_Convention.md`（命名规范 + 品质色 + 图标规范 + 掉落表字段模板）
|
||
|