AGENT SKILL
16-inventory-message-trigger
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
03 SKILL.md 正文
16-inventory-message-trigger
Status: ACTIVE AppliesTo: v10
Overview
Inventory 변동 알림 라우터다.
- 타입:
BaseTrigger<EntityId, INVENTORY_MESSAGE_TYPE> - ownerKey: subscriber-defined
EntityId - 실소유자는
InventoryManager다.
Contract
public sealed class InventoryMessageTrigger : BaseTrigger<EntityId, INVENTORY_MESSAGE_TYPE>
{
}
규칙:
- TriggerSystem은 순수 구독 라우터다.
- TriggerSystem 자체를 외부에 노출하지 않는다.
- 외부는
InventoryManagerhelper API로만 구독/해제한다. - publish(
Notify)는InventoryManager내부에서만 수행한다. - TriggerSystem 자체는 저장/재생/큐잉 책임이 없다.
Message Keys
INVENTORY_MESSAGE_TYPE enum(입력: input/Domains/Game/ENUM_ITEM.json)을 사용한다.
키:
NONEPASS_OWNERSHIP_CHANGEDCURRENCY_CHANGEDITEM_EQUIP_CHANGEDITEM_CARD_CHANGEDITEM_MATERIAL_CHANGEDITEM_HERO_CHANGEDITEM_EQUIP_LIST_CHANGEDITEM_CARD_LIST_CHANGEDITEM_MATERIAL_LIST_CHANGEDITEM_HERO_LIST_CHANGEDRENTAL_CHANGEDTREASURE_STATE_CHANGEDINVENTORY_SNAPSHOT_CHANGED
payload 규약:
PASS_OWNERSHIP_CHANGED:args[0] = string passId,args[1] = bool ownedCURRENCY_CHANGED:args[0] = CURRENCY_TYPE,args[1] = long delta,args[2] = long currentAmountITEM_EQUIP_CHANGED:args[0] = string itemUid,args[1] = string itemId,args[2] = AbilityItemEquip runtimeITEM_CARD_CHANGED:args[0] = string itemId,args[1] = AbilityItemCard runtimeITEM_MATERIAL_CHANGED:args[0] = string itemId,args[1] = AbilityItemMaterial runtimeITEM_HERO_CHANGED:args[0] = string itemId,args[1] = AbilityItemHero runtimeITEM_EQUIP_LIST_CHANGED:args[0] = INVENTORY_LIST_CHANGE_TYPE,args[1] = string itemUid,args[2] = string itemId,args[3] = AbilityItemEquip runtimeOrNullITEM_CARD_LIST_CHANGED:args[0] = INVENTORY_LIST_CHANGE_TYPE,args[1] = string itemId,args[2] = AbilityItemCard runtimeOrNullITEM_MATERIAL_LIST_CHANGED:args[0] = INVENTORY_LIST_CHANGE_TYPE,args[1] = string itemId,args[2] = AbilityItemMaterial runtimeOrNullITEM_HERO_LIST_CHANGED:args[0] = INVENTORY_LIST_CHANGE_TYPE,args[1] = string itemId,args[2] = AbilityItemHero runtimeOrNullRENTAL_CHANGED:args[0] = string itemId,args[1] = long expiresAtClientUtcMs,args[2] = bool activeTREASURE_STATE_CHANGED:args[0] = ITEM_GRADE_TYPE,args[1] = int deltaCount,args[2] = int currentCount,args[3] = int currentLevel,args[4] = int currentExpINVENTORY_SNAPSHOT_CHANGED:args[0] = INVENTORY_SNAPSHOT_CHANGE_REASON
Usage Rules
AchieveManager는ACHIEVE_PASS.req_pass_id조건 runtime의 WAIT 활성 전이를 위해 Inventory 메시지를 구독한다.InventoryManager는 item/currency 변경을 타입별*_CHANGEDkey로 발행한다.- item 목록 추가/삭제는 타입별
*_LIST_CHANGEDkey로 발행한다. - bulk load/import/clear는
INVENTORY_SNAPSHOT_CHANGED한 번으로 알린다. - 직접
InventoryMessageTrigger인스턴스를 참조/주입하지 않는다.