Files
systemrevivalserver/pending-clientChanges.md
T

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`)