# Pending Client Changes ## NPC Interactions - New input opcodes: - `DUNGEON_INPUT_NPC_INTERACT` (`406`) - `DUNGEON_INPUT_NPC_DIALOG_SELECT` (`407`) - `DUNGEON_INPUT_NPC_SHOP_ACTION` (`408`) - New response opcodes: - `NPC_INTERACT_STATE` (`620`) - `NPC_DIALOG_STATE` (`621`) - `NPC_DIALOG_RESULT` (`622`) - `NPC_SHOP_STATE` (`623`) - `NPC_SHOP_RESULT` (`624`) ### DUNGEON_STATE additions - `npcs` array added to top-level dungeon state. - NPC payload fields: - `id`, `definitionId`, `name` - `x`, `y`, `rotation` - `level`, `health`, `maxHealth`, `isAlive` - `isKillable`, `canShop`, `hasDialog` - `behavior`, `onAttackBehavior` - `currentAnimation`, `spriteConfig`, `tintColor`, `scale` ### Interaction payloads - `DUNGEON_INPUT_NPC_INTERACT` request: - `{ npcId }` - `DUNGEON_INPUT_NPC_DIALOG_SELECT` request: - `{ npcId, optionId }` - `DUNGEON_INPUT_NPC_SHOP_ACTION` request: - `{ npcId, action: "buy", slotIndex, quantity }` ### Dialog payloads - `NPC_DIALOG_STATE`: - `success` - `npcId` - `node`: `{ id, text, isTerminal, rewardGold, rewardXp, rewardItemDefinitionId, rewardItemQuantity, rewardQuestKey }` - `options`: list of `{ id, text, nextNodeId }` that pass server-side conditions. - `NPC_DIALOG_RESULT`: - `success`, `npcId`, `nextNodeId`, `isTerminal` - or `error` when blocked/invalid. ### Shop payloads - `NPC_SHOP_STATE`: - `success` - `shop`: `{ id, name, items[] }` - each item: `{ slotIndex, itemDefinitionId, itemName, quantity, priceGold, restocks, restockIntervalSeconds }` - `NPC_SHOP_RESULT`: - `success`, `npcId`, `action`, `itemDefinitionId`, `quantity`, `totalPrice`, `remainingGold`, `remainingStock` - or `error` for failure states. ## Stash Access - Stash is no longer VIP-gated on server. - Existing stash opcodes are unchanged: - `STASH_REQUEST` (`610`) - `STASH_STATE` (`611`) - `STASH_DEPOSIT` (`612`) - `STASH_WITHDRAW` (`613`) - `STASH_RESULT` (`614`)