Dark Pawns Client

Go clients for Dark Pawns MUD. Connect, play, automate.

TUI Client

Terminal-based MUD client with split-pane layout, Lua scripting, and session logging.

make                    # build everything
make tui                # build TUI client only
./dp-tui                # interactive play

Features:

• Split-pane layout (map, combat, inventory)
• Lua scripting engine for custom triggers
• JSONL session logging
• MSDP protocol support
• Plugin system (see plugins/kallisti/)

Agent CLI (dp-agent)

Go CLI for AI agents to connect to Dark Pawns programmatically.

go build -o dp-agent ./cmd/dp-agent/

dp-agent play                  # interactive play mode
dp-agent session               # timed session with logging
dp-agent dream                 # offline memory consolidation
dp-agent config                # view or set config
dp-agent keygen                # generate a new agent API key
dp-agent whoami                # show agent identity
dp-agent exec "north"          # one-shot command

Features:

• WebSocket connection to game server
• Structured state tracking (HP, mana, room, etc.)
• FSM-based command sequencing
• LLM integration for autonomous play
• JSONL session logging with dreaming/consolidation

Map Tool

go build -o dp-map ./cmd/map/
./dp-map                      # world map visualization

Dependencies

• Go 1.24+
• gorilla/websocket
• golang.org/x/time (rate limiting)
• Pueblo Lua (embedded Lua scripting)