Python MUD/MUX/MUSH/MU* development system
Find a file
2025-11-19 20:33:01 +01:00
.github Update doc build script 2025-08-15 18:47:44 +02:00
bin Format code imports 2022-11-10 22:21:12 +01:00
docs More fixes to install docs 2025-11-12 13:45:02 +01:00
evennia Django RESTFramework version to 3.16 (security update) 2025-11-19 20:31:28 +01: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 Update security.md and release process 2024-03-31 11:58:31 +02:00
CHANGELOG.md Update CHANGELOG 2025-11-19 20:33:01 +01: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 Bugfix. Fixes evennia/evennia#3336 2023-11-23 22:02:34 -05: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 Evennia 1.0.1 bug fix release 2022-12-07 20:39:44 +01:00
pyproject.toml Django RESTFramework version to 3.16 (security update) 2025-11-19 20:31:28 +01:00
README.md docs: clarify Windows py launcher usage during installation 2025-11-14 22:08:55 +01:00
SECURITY.md Evennia 5.0.0 major release 2025-07-01 10:12:08 +02:00
setup.py Support install from pypi (rc1) 2022-11-19 01:25:55 +01: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!