Files
systemrevivalserver/pending-clientChanges.md
T

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

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

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, version
    • tiles[] with { x, y, sheetId, frameIndex, isWalkable, isInvisiblePaywall }
    • objects[] with placement + definition id
    • npcs[] 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)