https://darkpawns.labz0rz.com/docs/development/ Recent content in Development on Dark Pawns Hugo en Wed, 22 Apr 2026 00:00:00 +0000 https://darkpawns.labz0rz.com/docs/development/architecture/ Wed, 22 Apr 2026 00:00:00 +0000 https://darkpawns.labz0rz.com/docs/development/architecture/ <h1 id="architecture-reference">Architecture Reference</h1> <p><strong>Last updated:</strong> 2026-05-16</p> <p>This page documents the internal architecture of the Dark Pawns Go server, covering the data flow from client connection to command dispatch, the concurrency model, and the package breakdown. The full source is in <code>docs/architecture/ARCHITECTURE.md</code> in the repository.</p> <hr> <h2 id="overview">Overview</h2> <p>Dark Pawns is a Go MUD server faithful to ROM 2.4b / Dark Pawns C source. It reads unmodified <code>.wld</code>, <code>.mob</code>, <code>.obj</code>, and <code>.zon</code> area files via a custom parser, then serves the game over WebSocket (primary) and telnet (legacy). Concurrency is goroutine-per-connection with a shared <code>sync.RWMutex</code> on the world state, a 2-second combat ticker, and serialized Lua scripting via a single <code>gopher-lua</code> VM. The design prioritizes behavioral fidelity to the original C codebase — same command set, same combat formulas, same Lua script API — while replacing the single-threaded C event loop with Go&rsquo;s concurrency primitives.</p>