evennia/evennia/game_template
2017-08-19 23:16:36 +02:00
..
commands Make PEP8 cleanup of line spaces and character distances as well as indents 2017-08-19 23:16:36 +02:00
server Make PEP8 cleanup of line spaces and character distances as well as indents 2017-08-19 23:16:36 +02:00
typeclasses Make PEP8 cleanup of line spaces and character distances as well as indents 2017-08-19 23:16:36 +02:00
web Cleaned up the game_template directory to match the web layout better. 2016-05-22 20:49:46 +02:00
world Make PEP8 cleanup of line spaces and character distances as well as indents 2017-08-19 23:16:36 +02: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 Add secret_settings and mechanisms for managing it. This allows for easier hiding game- and server-specific settings when sharing the game dir with others. 2017-06-04 22:55:28 +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!