97 lines
3.5 KiB
Markdown
97 lines
3.5 KiB
Markdown
# 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 自动联动。
|