Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Muddery is an online text game (like MUD) framework in Python. It is licensed under 3-clause BSD license. Muddery bases on Evennia which is a MUD/MU* creation system.

Our chinese website is (欢迎访问中文网站:

#Features Muddery is still under construction. It will have following features.

  1. It is in Python, so it can run on multiple platforms. Users can install it in just several minutes.

  2. It uses webpage as client. The data between server and client are in JSON. The client is responsible for display, so users can customize the display style by modifying the webpage. Muddery can support simple images and sounds, but it does not support Telnet and other common MUD clients. We may build native app client for it in the future.

  3. It will provide a series of modules, such as battle system, skill system, equipment system, etc. Users can use these modules to build their own game.

  4. It provides an online game editor. Game designers who know little about programing also can use Muddery to build their games.


  1. Install Python3.7+ and GIT. Start a Console/Terminal.
  2. cd to some place you want to do your development.
  3. git clone
  4. python -m venv mudenv
  5. source mudenv/bin/activate (Linux, Mac) or mudenv\Scripts\activate (Windows)
  6. pip install -e muddery
  7. muddery --init mygame
  8. cd mygame
  9. muddery start

Muddery should now be running and you can connect to it by pointing your web browser to http://localhost:8000.

If you want to stop the server, you can use muddery stop.