PHY/PHY_Editor_Integration_Checklist.md

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（命名规范 + 品质色 + 图标规范 + 掉落表字段模板）