Python MUD/MUX/MUSH/MU* development system
Find a file
Blightbow e8ef6a05c5
All checks were successful
Build Evennia Container Image / build (push) Successful in 11s
Fix context buffer 404 by using perception-stream API
The context-buffer endpoint was renamed to perception-stream but the
JavaScript wasn't updated. Map the new API field names to the expected
format used by the context buffer page.

Also update docstrings that still referenced the old endpoint name.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-15 05:44:59 -05:00
.claude Update building-game-code skill with testing patterns 2025-12-05 05:21:33 -05:00
.forgejo/workflows Configure git remote to use SSH instead of HTTPS in build workflow 2025-11-16 02:53:39 -05:00
.github Update doc build script 2025-08-15 18:47:44 +02:00
.mcp-servers Fix title block names to match base template 2025-11-15 06:53:47 -05:00
bin Move SSH host key scanning to setup_git() for persistence 2025-11-09 06:45:35 -05:00
docs Remove legacy Claude files 2025-12-08 02:35:21 -05:00
evennia Fix context buffer 404 by using perception-stream API 2025-12-15 05:44:59 -05:00
.flake8 Cleanup combat syntax, add flake8 config for legacy compat 2023-04-09 20:33:22 +02:00
.gitignore Remove personal scope ignore 2025-12-08 23:07:00 -05: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
CLAUDE.md Shift Claude memory files to skills 2025-12-02 10:40:44 -05: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 Add jsonschema package to Docker image 2025-12-02 01:59:40 -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
pytest.ini Add messaging integration tests (2/4 passing) 2025-11-23 14:01:33 -05: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
uv.lock Add uv.lock and update .gitignore 2025-11-11 01:58:53 -05: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!