evennia/evennia/game_template
2022-02-08 13:03:52 +01:00
..
commands Run black reformatter on code 2022-02-08 13:03:52 +01:00
server Clean up docs and more funcparser fixes 2021-03-27 23:43:46 +01:00
typeclasses Run black reformatter on code 2022-02-08 13:03:52 +01:00
web Run black reformatter on code 2022-02-08 13:03:52 +01:00
world Run black reformatter on code 2022-02-08 13:03:52 +01:00
__init__.py Added better docstrings to subpackages and cleaned out some places which were unclear. 2015-02-23 17:46:42 +01:00
gitignore Start restructuring web presences 2021-05-16 16:01:39 +02:00
README.md Change default ports and add clearer default to gamedir template, as per #1365. 2017-07-21 13:40:48 +02: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!