Open Source · Go + Svelte · Browser Native

Build Your
Text World

An open-source framework for building browser-based Multi-User Dungeons. Go backend. Svelte frontend. Zero telnet required.

veilspan.com — MUD Client
look
The Awakening Chamber [Catacombs] You lie on a cold stone slab in a dimly lit chamber. Ancient runes pulse with fading light along the walls. A narrow corridor leads north into darkness. Something hums deep below.   Exits: [north]  
north
Crumbling Corridor Dust motes dance in beams of pale light filtering through cracks above. The walls are scarred with claw marks. You hear skittering in the shadows.   A Skeletal Rat eyes you warily. Exits: [south] [east]  
attack rat
You strike the Skeletal Rat for 4 damage! The Skeletal Rat bites you for 2 damage. [HP: 18/20]  
The Framework

Everything you need to build a MUD

TalesMUD is a complete platform — not just an engine. Build, host, and play browser-based multiplayer RPGs without writing a line of boilerplate.

Modern Stack

Go 1.24 backend with Gin, Svelte 4 frontend with TailwindCSS, SQLite storage, WebSocket real-time communication. No telnet, no legacy protocols — just the browser.

🏰

Complete RPG Framework

Combat, character progression, quests, NPCs, dialog trees, items, merchants, and Lua scripting — all built-in and ready to customize for your world.

🌍

Genre-Agnostic

Fantasy, sci-fi, horror, steampunk — TalesMUD's systems are setting-neutral. Build any world you can imagine with flexible data-driven content authoring.

Architecture

Layered, clean, extensible

A well-defined layered architecture separates concerns cleanly. Real-time WebSocket for gameplay, REST API for content management, and a SQLite repository that needs zero external dependencies.

Browser
WebSocket + REST
HTTP API (Gin)
MUD Engine
WebSocket Handler
Users
Characters
Rooms
Items
NPCs
Quests
Scripts
Service Layer (Facade)
SQLite Repository (JSON Documents)
Browser Svelte game client + admin UI, connected via WebSocket for real-time play and REST API for data management.
Go Server Gin-based HTTP API, WebSocket MUD server, and game engine running concurrent goroutines for game loop and combat.
SQLite Single-file database with JSON document storage. No external database required — perfect for self-hosting.
Features

Everything in the box

No plugin hunting. No gluing systems together. TalesMUD ships with all core RPG systems production-ready.

⚔️

Turn-Based Combat

Initiative rolls (1d20 + DEX), auto-attack, 29+ class skills and spells, status effects, defensive stance, flee mechanics, and XP/loot distribution.

🗺️

World Building

Coordinate-based room system, zone maps, exits with directional navigation, room actions, background images, and a web-based visual room editor.

📜

Quest System

Data-driven quests with Kill, Collect, Deliver, Visit, Talk, and custom Lua objectives. Automatic progress tracking, prerequisites, chains, and NPC dialog integration.

🎭

NPCs & Dialogs

Branching dialog trees with variable substitution and conditional options. Merchant system with restock and pricing. Spawners with configurable respawn. Enemy AI states.

🔧

Lua Scripting

Extend gameplay with custom mechanics, puzzles, and events. 8 API modules covering items, rooms, characters, NPCs, dialogs, quests, game messaging, and utilities.

🎨

Content Editor

Web-based CRUD for all game entities — rooms, NPCs, items, quests, dialogs, skills, and scripts. Filterable tables, master-detail layout, live Lua script editor.

Tech Stack

Built with the right tools

Go 1.24
Svelte 4
TailwindCSS
SQLite
Docker
Lua 5.1
xterm.js
Auth0
Gin HTTP
WebSocket
Quick Start

Up and running in minutes

Clone, build, run. No external dependencies required beyond Go and Node.

bash
# Clone the repository
git clone https://github.com/TalesMUD/talesmud.git
cd talesmud

# Build everything (backend + frontend)
make build

# Start the server
make run-server

Open http://localhost:8010
Full Installation Guide →
Official Demo World

Play Veilspan

Veilspan is a fantasy adventure set in the world of Aethermoor — built entirely on TalesMUD. Explore the Catacombs, uncover the mystery of the Architects, and experience everything the framework has to offer.

Enter Veilspan
Community

Join the builders

TalesMUD is open source and built by a community of developers who love text-based games. Come build with us.

GitHub Stars

Built by atla and contributors

💬

GitHub Discussions

Ask questions, share ideas, and discuss TalesMUD development with the community.

🐛

Issue Tracker

Found a bug or have a feature request? Open an issue on GitHub to get it tracked.

🤝

Contribute

PRs welcome. Read the contributing guide to learn how to set up the development environment.