Installation

Wed, 22 Apr 2026 00:00:00 +0000

Installation & Deployment Guide

This guide details the exact system requirements, compilation steps, command-line flags, and containerization structures required to build, run, and deploy the Dark Pawns MUD server.

System Requirements

To compile and execute the Go port of the Dark Pawns server, your environment must satisfy the following dependencies:

Go Compiler: Go 1.26.3+ is required (as specified in go.mod).
Database (Optional for sandbox, required for production): PostgreSQL 15+ is used for character persistence, agent decision capture logging, and audit storage.
- Graceful Fallback: If no database is available, the server boots in sandbox mode. Characters can connect and explore, but their stats and items will not persist across disconnects.
Operating System: Fully compatible with macOS, Linux, and FreeBSD (raw POSIX bindings are utilized).

Local Compilation

To clone, compile, and run the server locally:

Quick Start

Wed, 22 Apr 2026 00:00:00 +0000

Quick Start Guide

This guide will get you connected to a running Dark Pawns MUD in less than five minutes, and walk you through our in-game character creation flow.

5-Minute Setup

To get a local server up and running on your system:

1. Compile the Server

git clone https://github.com/zax0rz/darkpawns.git
cd darkpawns
go build -o server ./cmd/server

2. Start the Server in Sandbox Mode

./server -world ./lib/world -port 4350

3. Connect via Telnet

Open a second terminal window and execute:

Getting Started on Dark Pawns