mirror of
https://github.com/evennia/evennia.git
synced 2026-03-19 22:36:31 +01:00
Python MUD/MUX/MUSH/MU* development system
http://www.evennia.com
baseddjangoenginegame-developmentgame-enginegamedevhacktoberfestmoomudmultiplayermushmuxpythontexttext-basedtext-based-adventuretwistedwebclientwebserver
d017ff0d39
I tried to test this on MySQL, but I can't get syncdb to work, either. (tsalaroth mking@arikel.net) |
||
|---|---|---|
| apps | ||
| doxygen | ||
| __init__.py | ||
| ABOUT | ||
| ansi.py | ||
| cmdhandler.py | ||
| commands_general.py | ||
| commands_privileged.py | ||
| commands_unloggedin.py | ||
| defines_global.py | ||
| evennia.vhost.apache | ||
| events.py | ||
| functions_db.py | ||
| functions_general.py | ||
| functions_help.py | ||
| gameconf.py | ||
| initial_setup.py | ||
| manage.py | ||
| README | ||
| scheduler.py | ||
| server.py | ||
| session.py | ||
| session_mgr.py | ||
| settings.py.dist | ||
| startup.sh | ||
| TODO | ||
| urls.py | ||
About Evennia ------------- Evennia is a proof-of-concept MU* server that aims to provide a functional base for developers. While there are quite a few codebases that do the same (and very well in many cases), we are taking a unique spin on the problem. Some of our flagship features include (or will one day include): * Extensive web integration. * The ability to build/administer through a web browser. * Shared accounts between the website and the game. * Optional web-based character creation. * Extremely easy-to-manipulate SQL database back-end via Django (djangoproject.com) * Simple and easily extensible design. * Very granular permissions. Individual and group based. The essential points here are the web integration and the SQL backing via Django. The Django framework has database abstraction abilities that give us many features free, such as: * The codebase will run transparently on MySQL, SQLite, or Postgres * At the time of this document's writing, our SQL-backed application here contains 0 lines of SQL. Django's database abstraction layer is absolutely simple yet very powerful. * For any model we outline for the server's use, we have the ability to more or less automatically generate a web-based admin interface for it with two lines of code. This lets you Create, Update, or Delete entries. * On the web-based side of things, features such as automatic form validation, abstraction of sessions and cookies, and access to whatever game data you desire are all attractive. Requirements ------------ * Python 2.5 strongly recommended, although may work just fine. * PySqlite2 * Django (Latest trunk from Subversion recommended) * Optional: Apache2 or equivalent webserver with a Python interpreter module. Required for web interface. Installation ------------ At this point in time, the codebase is changing so rapidly that writing installation instructions is pretty much pointless. When we get to that stage in development, we'll make sure to update this. But for the really determined (or stubborn), here's a rough outline: * Install Django. * Get a copy of the Evennia source. * Optional: Set up your apache2.conf to point mod-python to the settings.py file if you want the web features. * Copy settings.py.dist to settings.py. * Edit settings.py with your database info. * Run 'python manage.py syncdb' * Run startup.sh. This will start the MU* server on port 4000 by default. You may change this via the web interface or by editing the config table in SQL. * Login with the email address and password you provided to the syncdb script. Support and Development ----------------------- Since we're so early in development, we really can't hope to offer much support. However, if you'd like to report bugs, make suggestions, or help with the code work, visit either or both of the following links: * Evennia Webpage http://evennia.com * Evennia Code Page http://code.evennia.com * Evennia Test Game evennia.com port 4000