Files
systemrevivalserver/pending-clientChanges.md
T

1.9 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

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