Python MUD/MUX/MUSH/MU* development system http://www.evennia.com
Find a file
2019-08-26 20:12:18 +02:00
.github Update github contribute instructions for new branch layout 2017-09-23 14:27:42 +02:00
.travis Test to pass SET NAMES to init_command 2019-03-24 15:31:43 +01:00
bin Resolve support for Django 2.0 2019-03-25 21:45:34 +01:00
evennia Fix typo in objects command. Resolve #1892. 2019-08-26 20:12:18 +02:00
.gitignore Changed ignores to not use linux-type paths. 2015-05-26 00:15:36 +02:00
.travis.yml Fix typo 2019-04-06 09:32:22 +02:00
CHANGELOG.md Update CHANGELOG with Spanish translation 2019-08-19 08:11:51 +02:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2017-10-01 18:44:00 +02:00
CODING_STYLE.md Update CODING_STYLE.md 2018-04-25 21:53:28 +02:00
CONTRIBUTING.md Minor adjustments to text 2018-10-27 21:19:41 +02:00
Dockerfile Dockerfile: Only expose external ports 2019-04-22 12:45:06 +12:00
INSTALL.md Change default ports and add clearer default to gamedir template, as per #1365. 2017-07-21 13:40:48 +02:00
LICENSE.txt Fixed errors in the ExtendedRoom contrib, pertaining to the detail command. Resolves #741. 2015-04-29 16:07:57 +02:00
README.md Update README with new screenshot 2017-09-23 15:53:05 +02:00
requirements.txt Security update; Increase rec Django version to 2.2.4 2019-08-09 18:03:02 +02:00
setup.py Make PEP8 cleanup of line spaces and character distances as well as indents 2017-08-19 23:16:36 +02:00
win_requirements.txt Security update; Increase rec Django version to 2.2.4 2019-08-09 18:03:02 +02:00

Evennia MUD/MU* Creation System evennia logo

Build Status Coverage Status

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 is made available under the very friendly BSD license.

http://www.evennia.com is the main hub tracking all things Evennia.

Features and Philosophy

The Evennia library aims for you to have a fully functioning, if empty, online game up and running in minutes. Rather than imposing a particular style, genre or game mechanic we offer a framework on which you build the game of your dreams. The idea is to allow you to concentrate on designing the bits that make your game unique.

Coding in Evennia is done using normal Python modules imported into the server at runtime. All library code is heavily documented and Evennia comes with extensive manuals and tutorials. You use Python classes to represent your objects, scripts, players, in-game channels and so on. The database layer is abstracted away. This makes it possible to create the game using modern code practices using the full flexibility and power of Python.

screenshot

Evennia offers extensive connectivity options, including traditional telnet connections. Evennia is also its own web server: A default website as well as a browser-based mud client (html5 websockets, with fallback to AJAX) runs by default. Due to our Django and Twisted foundations, web integration is easy since the same code powering the game is also used to run its web presence.

Whereas Evennia is intentionally empty of game content from the onset, we do offer some defaults you can build from. The code base comes with basic classes for objects, exits, rooms and characters. There are systems for handling puppeting, scripting, timers, dynamic games states etc. A default command set (completely replaceable with your own syntax and functionality) handles administration, building, chat channels, poses and so on. The default setup is enough to run a 'Talker' or some other social-style game out of the box. We also have a contributions folder with optional plugins and examples of more game-specific systems.

Current Status

The codebase is currently in Beta. While development continues, Evennia is already stable enough to be suitable for prototyping and development of your own games.

Where to go from here

If this piqued your interest, there is a lengthier introduction to read.

To learn how to get your hands on the code base, the Getting started page is the way to go. Otherwise you could browse the Documentation or why not come join the Evennia Community forum or join us in our development chat. Welcome!