Home
Softono
evennia

evennia

Open source BSD-3-Clause Python
Website GitHub
2.1K
Stars
767
Forks
143
Issues
128
Watchers
4 weeks
Last Commit
Game Engines

About evennia

Evennia is a modern Python library for creating online multiplayer text games, including MUDs, MUSHes, MUXes, MUCKs, and MOOs. It provides a flexible framework that handles networking and common infrastructure, allowing creators to focus on designing unique game mechanics, settings, and features without being constrained to a particular style or genre. Game logic is written using standard Python modules imported into the server at runtime. Evennia includes a built-in web interface and supports traditional telnet-based MUD clients. An automated game website is generated upon setup. Installation is straightforward via pip: pip install evennia, followed by commands to initialize, migrate, and start the game server. Once running, users can connect through a web browser on port 4001 or use a MUD client on localhost port 4000. Evennia features extensive official documentation, an active community, discussion forums, and a Discord server for support and collaboration. It is suitable for hobbyists, educators teaching

Platforms

Web Self-hosted

Languages

Python

Links

Website Source Code
e
Published by
evennia
Visit View Profile

README.md

View on GitHub

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!