extends Node ## Network OpCodes - Message Type Identifiers ## ## This file defines all message types (opcodes) used for client-server communication. ## Each opcode represents a specific type of message or action. # ===== Keepalive / Connection Management (1-9) ===== ## Echo test message - server echoes back the received payload const ECHO = 1 ## Server -> Client: Keepalive ping to prevent idle timeout ## Client should automatically respond with PONG const PING = 2 ## Client -> Server: Response to PING message ## Handled automatically by network.gd const PONG = 3 # ===== Authentication (100-119) ===== ## Client -> Server: Register new account const AUTH_REGISTER = 100 ## Server -> Client: Registration result const AUTH_REGISTER_RESULT = 101 ## Client -> Server: Login with username and password const AUTH_LOGIN = 110 ## Server -> Client: Login result const AUTH_LOGIN_RESULT = 111 ## Client -> Server: Authenticate using stored session token const AUTH_WITH_TOKEN = 112 ## Server -> Client: Token authentication result const AUTH_WITH_TOKEN_RESULT = 113 # ===== Hub / Character Selection (200-249) ===== ## Server -> Client: Hub state with character info const HUB_STATE = 200 ## Client -> Server: Allocate stat points const STAT_ALLOCATE = 201 ## Client -> Server: Create new character const CHAR_CREATE = 202 ## Server -> Client: Character creation result const CHAR_CREATE_RESULT = 203 ## Client -> Server: Select character to play const CHAR_SELECT = 204 ## Server -> Client: Character selection result const CHAR_SELECT_RESULT = 205 # ===== Inventory Management (250-259) ===== ## Client -> Server: Request current inventory state const INVENTORY_REQUEST = 250 ## Server -> Client: Current inventory state const INVENTORY_STATE = 251 ## Client -> Server: Equip an item const EQUIP_ITEM = 252 ## Client -> Server: Unequip an item const UNEQUIP_ITEM = 253 ## Client -> Server: Use a consumable item const USE_ITEM = 254 ## Client -> Server: Drop an item from inventory const DROP_ITEM = 255 ## Client -> Server: Assign item to hotbar slot const HOTBAR_ASSIGN = 256 ## Client -> Server: Stack two consumable items together const STACK_ITEMS = 257 ## Client -> Server: Move/swap item between inventory slots const MOVE_ITEM = 258 ## Client -> Server: Auto-stack all stackable items in inventory const AUTO_STACK_INVENTORY = 259 # ===== Chat (260-269) ===== ## Client -> Server: Send chat message const CHAT_SEND = 260 ## Server -> Client: Chat message from player const CHAT_MESSAGE = 261 # ===== Loot Chests (270-279) ===== ## Client -> Server: Open a loot chest const LOOT_CHEST_OPEN = 270 ## Server -> Client: Loot chest contents const LOOT_CHEST_STATE = 271 ## Client -> Server: Take specific item from chest const LOOT_CHEST_TAKE_ITEM = 272 ## Client -> Server: Take all items from chest const LOOT_CHEST_TAKE_ALL = 273 ## Client -> Server: Close loot chest UI const LOOT_CHEST_CLOSE = 274 ## Server -> Client: New loot chest spawned in dungeon const LOOT_CHEST_SPAWNED = 275 ## Server -> Client: Loot chest removed/destroyed const LOOT_CHEST_REMOVED = 276 # ===== Player Death (280-289) ===== ## Server -> Client: Notify player what loot they lost on death const PLAYER_DEATH_LOOT_LOST = 280 # ===== Mob Loot (290-299) ===== ## Client -> Server: Request loot from a dead mob const MOB_LOOT_REQUEST = 290 ## Server -> Client: Mob loot contents response const MOB_LOOT_STATE = 291 ## Client -> Server: Take specific item from mob const MOB_LOOT_TAKE_ITEM = 292 ## Client -> Server: Take all items from mob const MOB_LOOT_TAKE_ALL = 293 # ===== Dungeon Core (300-309) ===== ## Client -> Server: Request to enter a dungeon const DUNGEON_ENTER = 300 ## Server -> Client: Dungeon entry result const DUNGEON_ENTER_RESULT = 301 ## Server -> Client: Current dungeon state snapshot const DUNGEON_STATE = 302 ## Client -> Server: Leave current dungeon const DUNGEON_LEAVE = 303 ## Server -> Client: Dungeon has been cleared (boss defeated) const DUNGEON_CLEARED = 304 ## Server -> Client: Tile update (door opened, destructible destroyed, etc.) const DUNGEON_TILE_UPDATE = 305 # ===== Dungeon Browser (310-319) ===== ## Client -> Server: Request list of available dungeons const DUNGEON_LIST_REQUEST = 310 ## Server -> Client: List of dungeons const DUNGEON_LIST_RESPONSE = 311 ## Client -> Server: Create a new dungeon instance const DUNGEON_CREATE = 312 ## Client -> Server: Join an existing dungeon const DUNGEON_JOIN = 313 # ===== Asset Management (320-329) ===== ## Client -> Server: Request asset manifest (sprites, tilesets, etc.) const ASSET_MANIFEST_REQUEST = 320 ## Server -> Client: Asset manifest response const ASSET_MANIFEST_RESPONSE = 321 # ===== Crafting System (330-349) ===== ## Client -> Server: Request crafting skills state const CRAFTING_SKILLS_REQUEST = 330 ## Server -> Client: Crafting skills state const CRAFTING_SKILLS_STATE = 331 ## Client -> Server: Request known crafting recipes const CRAFTING_RECIPES_REQUEST = 332 ## Server -> Client: Crafting recipes state const CRAFTING_RECIPES_STATE = 333 ## Client -> Server: Attempt to craft an item const CRAFTING_ATTEMPT = 334 ## Server -> Client: Crafting attempt result const CRAFTING_RESULT = 335 ## Server -> Client: Crafting skill leveled up const CRAFTING_SKILL_LEVELUP = 336 ## Server -> Client: New recipe discovered const RECIPE_DISCOVERED = 337 ## Client -> Server: Use a recipe scroll to learn recipe const RECIPE_SCROLL_USE = 338 # ===== Dungeon Input / Actions (400-449) ===== ## Client -> Server: Movement input const INPUT_MOVE = 400 ## Client -> Server: Attack action const INPUT_ATTACK = 401 ## Client -> Server: Pickup item from ground const INPUT_PICKUP = 402 ## Client -> Server: Interact with chest const INPUT_CHEST = 403 ## Client -> Server: Use portal const INPUT_PORTAL = 404 ## Client -> Server: Fire projectile (bow, crossbow, throwable) const INPUT_FIRE_PROJECTILE = 405 # ===== Escape / Portal (450-459) ===== ## Client -> Server: Start escape channel (return to hub) const ESCAPE_START = 450 ## Client -> Server: Cancel escape channel const ESCAPE_CANCEL = 451 ## Server -> Client: Escape interrupted (took damage) const ESCAPE_INTERRUPTED = 452 ## Server -> Client: Escape successful, returning to hub const ESCAPE_SUCCESS = 453 ## Server -> Client: Portal successfully used const PORTAL_USED = 454 # ===== Game Events (500-599) ===== ## Server -> Client: Damage event occurred const EVENT_DAMAGE = 500 ## Server -> Client: Entity died const EVENT_DEATH = 501 ## Server -> Client: Player leveled up const EVENT_LEVELUP = 502 ## Server -> Client: Loot obtained const EVENT_LOOT = 503 ## Server -> Client: Projectile spawned in dungeon const EVENT_PROJECTILE_SPAWNED = 504 ## Server -> Client: Projectile hit target (mob/player) const EVENT_PROJECTILE_HIT = 505 ## Server -> Client: Projectile expired (max range or wall collision) const EVENT_PROJECTILE_EXPIRED = 506 ## Server -> Client: Damage number for floating text const EVENT_DAMAGE_NUMBER = 507 # ===== Server Broadcasts (600-609) ===== ## Server -> All Clients: Server-wide broadcast message const SERVER_BROADCAST = 600 # ===== Stash System - VIP Feature (610-619) ===== ## Client -> Server: Request stash contents const STASH_REQUEST = 610 ## Server -> Client: Stash contents const STASH_STATE = 611 ## Client -> Server: Deposit item from inventory to stash const STASH_DEPOSIT = 612 ## Client -> Server: Withdraw item from stash to inventory const STASH_WITHDRAW = 613 ## Server -> Client: Stash operation result const STASH_RESULT = 614 # ===== Errors (900-999) ===== ## Server -> Client: Error message const ERROR = 900 # ===== Legacy / Deprecated ===== ## Legacy loot notification (consider consolidating with EVENT_LOOT) const LOOT_RECEIVED = 160