MMO Project rebuilds a legacy Macromedia Director/Shockwave-era multiplayer game on a modern, open-source stack. The goal is faithful recreation of the original game’s world, content, and core loop — with a secure authoritative backend, cross-platform Godot 4 desktop client, and a clean versioned WebSocket protocol replacing the original’s unsafe trust model. The Phase 2 prototype has verified the full path from login through world entry, authoritative movement, inventory/equipment interaction, and reconnect restoration. These docs cover the server, client, shared protocol, and the modernization decisions behind the rewrite.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/TaylorZaneKirk/MMO-Project/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Run the server and client locally end-to-end in minutes
Architecture
Understand the server, client, database, and protocol layers
Protocol Reference
Explore all WebSocket messages in protocol v1
Modernization Roadmap
Phase-by-phase plan from legacy preservation to modern release
What’s working now
The current prototype baseline covers the complete verified gameplay path:Login
A Godot
LoginScreen collects credentials and sends a login_request over WebSocket. The server validates against a PostgreSQL-backed account table and returns a session_id.Enter the world
After character load,
enter_world_response places the character at their last saved tile. A world_snapshot hydrates the local player state, NPC positions, remote players, inventory, equipment, and status bars.Move, interact, and manage items
Click-to-move sends
movement_intent; the server resolves authoritative A* pathing and responds with movement_applied. Inventory and equipment changes are transactional — equip, unequip, use, drop, and pickup are all server-authoritative.Stack at a glance
Godot 4 Client
GDScript, 2D tile renderer, right-click context menus, HUD controllers
.NET Backend
C# application services, WebSocket host, PostgreSQL repositories
Protocol v1
Versioned JSON messages over WebSocket with revisioned delta delivery