Python MUD/MUX/MUSH/MU* development system
  • Python 96.4%
  • JavaScript 1.8%
  • HTML 1%
  • CSS 0.5%
  • Shell 0.2%
Find a file
2026-04-11 18:17:17 +02:00
.agents Read default MSSP server name from SERVERNAME instead 2026-04-11 17:56:55 +02:00
.claude Add small /ev skill for pr/issue reviewing 2026-04-11 09:32:11 +02:00
.github CI: More tweaking to speed up PostgreSQL ci test runs 2026-02-14 22:10:47 +01:00
bin Format code imports 2022-11-10 22:21:12 +01:00
docs Update documentation 2026-04-11 18:17:17 +02:00
evennia Read default MSSP server name from SERVERNAME instead 2026-04-11 17:56:55 +02:00
.flake8 Cleanup combat syntax, add flake8 config for legacy compat 2023-04-09 20:33:22 +02:00
.gitignore Minor tweak to .gitignore 2024-02-04 22:11:36 +01:00
.release.sh Evennia 6.0.0 major release 2026-02-15 18:57:12 +01:00
AGENTS.md Add small /ev skill for pr/issue reviewing 2026-04-11 09:32:11 +02:00
CHANGELOG.md Read default MSSP server name from SERVERNAME instead 2026-04-11 17:56:55 +02:00
CLAUDE.md Add agent scaffolding for those wanting to work in the Evennia repo 2026-04-11 00:30:13 +02:00
CODE_OF_CONDUCT.md More updates 2022-10-20 23:57:12 +02:00
CODING_STYLE.md Cleaned up Coding and style guides, improved contribs 2022-11-25 19:47:32 +01:00
CONTRIBUTING.md Broken links pointed to latest 2023-07-27 08:50:51 +02:00
Dockerfile CI: Update Dockerimage. 2026-02-15 00:42:28 +01:00
INSTALL.md Update INSTALL.md link to latest docs 2023-04-20 16:44:47 +02:00
LICENSE.txt More cleanup again 2022-07-25 09:18:20 +02:00
Makefile Add agent scaffolding for those wanting to work in the Evennia repo 2026-04-11 00:30:13 +02:00
pyproject.toml Merge pull request #3884 from jaborsh/pr-3802 2026-04-11 11:23:20 +02:00
README.md docs: clarify Windows py launcher usage during installation 2025-11-14 22:08:55 +01:00
SECURITY.md Evennia 6.0.0 major release 2026-02-15 18:57:12 +01:00
setup.py Support install from pypi (rc1) 2022-11-19 01:25:55 +01:00
uv.lock Using existing re.sub() should correctly handle replacing without a custom function 2026-04-11 12:45:00 +02:00

Evennia MUD/MU* Creation System

unittestciimg Coverage Status Pypi Version

Evennia is a modern library for creating online multiplayer text games (MUD, MUSH, MUX, MUCK, MOO etc) in pure Python. It allows game creators to design and flesh out their ideas with great freedom.

Evennia does not impose a particular style, genre or game mechanic. Instead it solves the boring networking and basic stuff all online games need. It provides a framework and tools for you to build the game you want. Coding in Evennia is done using normal Python modules imported into the server at runtime.

Evennia has extensive documentation. It also has a very active community with discussion forums and a discord server to help and support you!

Installation

pip install evennia
    (windows users once: py -m evennia)
    (note: Windows users with multiple Python versions should prefer `py -3.11` instead of `python` when creating virtual environments)
evennia --init mygame
cd mygame
evennia migrate
evennia start / stop / reload

See the full installation instructions for more help.

Next, browse to http://localhost:4001 or use your third-party mud client to connect to localhost, port 4000 to see your working (if empty) game!

screenshot A game website is created automatically. Connect to your Evennia game from your web browser as well as using traditional third-party clients.

Where to go next

If this piqued your interest, there is a lengthier introduction to read. You can also read our Evennia in pictures overview. After that, why not check out the Evennia Beginner tutorial.

Welcome!