A next-generation MUD/MOO-like virtual world engine in Python
Python HTML JavaScript CSS Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
antioch
bin
conf
doc/img
.dockerignore
.gitignore
ChangeLog.md
Dockerfile
INSTALL.md
LICENSE.md
MANIFEST.in
README.md
docker-compose.override.yml
docker-compose.override.yml.example
docker-compose.yml
manage.py
requirements.txt
setup.py

README.md

antioch

(c) Phil Christensen, phil@bubblehouse.org

28 December 2015

Introduction

antioch is a next-generation MUD/MOO-like virtual world engine. A scalable architecture lays the foundation for huge, highly customizable virtual worlds, while sandboxed code execution allows users to author content in a secure and robust environment.

screenshot

Feature Set

  • Django-powered, standards-compliant web interface using Bootstrap, jQuery, REST and COMET

  • Sandboxed Pure-Python execution enables live programming of in-game code

  • PostgreSQL-backed object store scales to million of objects and provides transactional security during verb execution

  • Flexible plugin system, highly scalable execution layer using Celery and Redis

antioch is made available under the MIT/X Consortium license.

The included LICENSE file describes this in detail.

Running

You'll need a local installation of Docker Compose, perferably via Docker Toolbox.

To install:

git clone ssh://git@github.com/philchristensen/antioch.git
cd antioch
docker-compose up

After first install, and after model or static file changes, you'll need to run migrate and/or collectstatic:

docker-compose run web manage.py migrate
docker-compose run web manage.py collectstatic

Finally, the first time you run, set up a basic database with some sample objects and users:

docker-compose run web manage.py mkspace

This build uses port 80/443 on your docker machine, but you can use whatever domain name to refer to it. I have a docker alias setup in my /etc/hosts file for this purpose. To find out the address of your docker machine, you can run:

docker-machine ip default

Connect to the docker machine via your browser, and login with username/passwd wizard:wizard.