main | develop |
---|---|
Codebase is undergoing major refactoring - please join the ainneve on Discord if you wish to discuss ideas for Ainneve's future.
Welcome! The Evennia community has created Ainneve for you to use as a base to learn from and build off of. Ainneve currently is an early work in progress.
We recommended you look up Evennia's extensive documentation. It has several beginner-level tutorials and a thoroughly documented codebase.
To learn about Ainneve's game systems and world setting, check out our wiki.
The main configuration file is found in server/conf/settings.py
-
but you don't need to change it to get started. All of the necessary settings
come pre-configured
Once you have the ainneve directory, cd
into it in a shell and install the pip requirements.
(It's recommended you set up a python venv first!)
pip install -r requirements.txt
If you have trouble with installing the requirements, please check Evennia's troubleshooting guide
Next, initialize the game in evennia:
evennia migrate
To start the server, make sure you're in the ainneve directory and run:
evennia -i start
This will start the server so that it logs 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 or the built-in website - telnet at localhost:4000 or 127.0.0.1:4000 or your web browser at http://localhost:4001.
In flux: check out the design doc for an idea of the project's plans.
(To-do: write a to-do list)
If you're looking for what tasks we need help with, look at our current open issues. (NOTE: these need to be reviewed, so they may not be current!)
To let us know you're interested in helping out, you can also visit the #ainneve channel in the Evennia Discord
Please submit pull requests as feature branches rather than from your main branch -- see https://github.com/evennia/evennia/wiki/Version-Control#making-a-work-branch.
Ainneve uses the BSD license, the same as Evennia.
Legacy note: Originally, our game was based on Open Adventure, copyright 2014 Kyle Mecklem and released under the Creative Commons Attribution CC-by-SA license. It is no longer.