PHY/PHY_ItemSystem_Attributes.md

PHY Item Attribute System (GIS)

本次新增

• Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.h
• Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.cpp
• Source/PHYInventory/Private/Items/PHYItemFragment_PropertySet.h
• Source/PHYInventory/Private/Items/PHYItemFragment_PropertySet.cpp
• Source/PHYInventory/Private/Items/PHYItemBlueprintLibrary.h
• Source/PHYInventory/Private/Items/PHYItemBlueprintLibrary.cpp
• Source/PHY/Private/Character/PHYCharacter.h
• Source/PHY/Private/Character/PHYCharacter.cpp
• Source/PHY/Private/Character/PHYPlayerCharacter.h
• Source/PHY/Private/Character/PHYPlayerCharacter.cpp
• Source/PHY/Private/Gameplay/Player/PHYPlayerState.h
• Source/PHY/Private/Gameplay/Player/PHYPlayerState.cpp

新增联动能力（12）

1) 装备属性自动生效/回滚（服务器权威）

• 在基础角色上新增 UGIS_EquipmentSystemComponent。
• 服务器 BeginPlay 时：先初始化 InventorySystem，再初始化 EquipmentSystem。
• APHYPlayerCharacter 监听 OnEquipmentStateChangedEvent。
• 事件触发后通过 APHYPlayerState::HandleItemEquippedState 应用或回滚属性。
• 使用 AppliedEquipmentItems 防止同一个 ItemId 重复叠加。

2) 药品 Server RPC 使用链路

• 在 APHYPlayerCharacter 新增：
  • UFUNCTION(Server, Reliable) ServerUseConsumableByItemId(FGuid ItemId, int32 Count=1)
• 服务端流程：
  • 按 ItemId 在库存中查找道具
  • 扣减库存数量（RemoveItem）
  • 调用 APHYPlayerState::ApplyConsumableFromItem 应用恢复
• 当前默认读取道具动态属性标签：
  • GIS.Attribute.Item.Consumable.RestoreHealth
  • GIS.Attribute.Item.Consumable.RestoreInnerPower

设计

• 基于 GIS 的 UGIS_ItemDefinition + Fragment。
• 新增 UPHYItemFragment_PropertySet 作为统一“武器/装备/药品”属性片段。
• 道具实例创建时会把 BaseFloatModifiers / BaseIntegerModifiers 写入 UGIS_ItemInstance 动态属性。

主要能力

• 统一道具大类：EPHYItemArchetype
  • Weapon
  • Equipment
  • Consumable
  • Material
  • Quest
• 统一装备槽：EPHYEquipSlotType
• 药品效果载荷：FPHYConsumablePayload
  • RestoreHealth
  • RestoreInnerPower
  • DurationSeconds

GameplayTags 管理

标签已集中在 Source/PHYInventory/Private/GameplayTags/PHYInventoryItemTags.*，避免代码中散落字符串：

• GIS.Item.Type.Weapon
• GIS.Item.Type.Equipment
• GIS.Item.Type.Consumable
• GIS.Item.EquipSlot.MainHand 等
• GIS.Attribute.Item.Attack、GIS.Attribute.Item.CritRate 等

如何创建三类物品

1. 在编辑器创建 UGIS_ItemDefinition 资产。
2. 给该资产添加 Fragment：PHY Item Property Settings。
3. 按类型配置：
   • 武器：ItemArchetype=Weapon，EquipSlot=MainHand/OffHand，填写攻击/暴击等属性。
   • 装备：ItemArchetype=Equipment，设置对应 EquipSlot，填写防御/免伤/韧性等属性。
   • 药品：ItemArchetype=Consumable，填写 ConsumablePayload（回血/回内力）。
4. 把物品加入你的掉落表/默认背包配置。

蓝图辅助

UPHYItemBlueprintLibrary 提供：

• GetItemArchetype
• GetEquipSlotType
• IsWeaponItem
• IsEquipmentItem
• IsConsumableItem
• GetConsumablePayload

用于 UI 显示和使用逻辑分流。

备注

• 当前为 MVP：先打通类型与属性承载。
• 下一步可扩展：随机词条（Roll）、品质颜色、套装、与 GAS GameplayEffect 自动联动。