66 lines
1.9 KiB
Markdown
66 lines
1.9 KiB
Markdown
# 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`)
|