My MUD game based on the Evennia Python project https://howardabrams.com/cozy
Find a file
2026-04-23 08:21:25 -07:00
commands Hints for the Glittering Glade 2026-04-20 20:36:07 -07:00
personalities Animate the Wee Beastie and scrying into rooms 2026-04-16 17:09:15 -07:00
server New start screen. 2025-08-23 18:27:31 -07:00
transcripts Create a recorder 2026-02-27 20:09:04 -08:00
typeclasses Emergency bug fix 2026-04-23 08:21:25 -07:00
utils Create a recorder 2026-02-27 20:09:04 -08:00
web Make text more readable with extra space 2026-03-18 04:30:41 +00:00
world Minor bugs 2026-04-22 22:18:10 -07:00
.dir-locals.el Get the custom Emacs working 2025-03-30 14:33:10 -07:00
.envrc In the beginning was a tree... 2025-01-22 07:58:32 -08:00
.gitignore New puppetable NPCs are now Chatbot Agents 2026-03-16 21:03:40 -07:00
.python-version Update server on howardabrams.com/moss 2025-02-14 04:26:39 +00:00
README.md In the beginning was a tree... 2025-01-22 07:58:32 -08:00

Welcome to Evennia!

This is your game directory, set up to let you start with your new game right away. An overview of this directory is found here: https://github.com/evennia/evennia/wiki/Directory-Overview#the-game-directory

You can delete this readme file when you've read it and you can re-arrange things in this game-directory to suit your own sense of organisation (the only exception is the directory structure of the server/ directory, which Evennia expects). If you change the structure you must however also edit/add to your settings file to tell Evennia where to look for things.

Your game's main configuration file is found in server/conf/settings.py (but you don't need to change it to get started). If you just created this directory (which means you'll already have a virtualenv running if you followed the default instructions), cd to this directory then initialize a new database using

evennia migrate

To start the server, stand in this directory and run

evennia start

This will start the server, logging output to the console. Make sure to create a superuser when asked. By default you can now connect to your new game using a MUD client on localhost, port 4000. You can also log into the web client by pointing a browser to http://localhost:4001.

Getting started

From here on you might want to look at one of the beginner tutorials: http://github.com/evennia/evennia/wiki/Tutorials.

Evennia's documentation is here: https://github.com/evennia/evennia/wiki.

Enjoy!