3.1 KiB
3.1 KiB
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
npcsarray added to top-level dungeon state.- NPC payload fields:
id,definitionId,namex,y,rotationlevel,health,maxHealth,isAliveisKillable,canShop,hasDialogbehavior,onAttackBehaviorcurrentAnimation,spriteConfig,tintColor,scale
Interaction payloads
DUNGEON_INPUT_NPC_INTERACTrequest:{ npcId }
DUNGEON_INPUT_NPC_DIALOG_SELECTrequest:{ npcId, optionId }
DUNGEON_INPUT_NPC_SHOP_ACTIONrequest:{ npcId, action: "buy", slotIndex, quantity }
Dialog payloads
NPC_DIALOG_STATE:successnpcIdnode:{ 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
errorwhen blocked/invalid.
Shop payloads
NPC_SHOP_STATE:successshop:{ id, name, items[] }- each item:
{ slotIndex, itemDefinitionId, itemName, quantity, priceGold, restocks, restockIntervalSeconds }
NPC_SHOP_RESULT:success,npcId,action,itemDefinitionId,quantity,totalPrice,remainingGold,remainingStock- or
errorfor 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)
Overworld Live Editing (Planned)
- Browser editor needs world hierarchy selection:
- region -> zone -> chunk
- optional full-zone load mode
- Region minimap support:
- zone outlines for the full region
- selected zone/chunk highlight
Tile editing requirements
- Tile picker flow:
- select sprite sheet
- select frame index
- set
isWalkable(bool) - set
isInvisiblePaywall(bool)
- Live placement and erase should apply immediately via proximity-safe delta updates.
Object/NPC editing requirements
- Place/move/remove object instances from filterable definition lists.
- Place/move/remove NPC spawns from filterable NPC definition lists.
- Changes should be chunk-scoped and include version numbers to prevent stale overwrites.
Proposed payload additions
- Chunk state payload:
regionId,zoneId,chunkX,chunkY,versiontiles[]with{ x, y, sheetId, frameIndex, isWalkable, isInvisiblePaywall }objects[]with placement + definition idnpcs[]with spawn placement + npc definition id
- Delta update payload:
regionId,zoneId,chunkX,chunkY,fromVersion,toVersion- operations list (tile upsert/remove, object upsert/remove, npc upsert/remove)