mirror/evennia
3
0
Fork 0
mirror of https://github.com/evennia/evennia.git synced 2025-10-29 19:35:56 +00:00
Code Issues Packages Projects Releases Wiki Activity
evennia/docs/source/Setup/Installation-Upgrade.md
Griatch 8787f8c34f Support install from pypi (rc1)
2022-11-19 01:25:55 +01:00

2.9 KiB
Raw Blame History

Upgrading an existing installation

This is relevant to you already having code in an older Evennia version. If you are new, or don't have much code yet, it may be easier to just start fresh with the Installation instructions and copy over things manually.

Evennia v0.9.5 to 1.0

Upgrading the Evennia library

Prior to 1.0, all Evennia installs were Git-installs. These instructions assume that you have a cloned evennia repo and use a virtualenv (best practices).

  • Make sure to stop Evennia 0.9.5 entirely with evennia stop.
  • deactivate to leave your active virtualenv.
  • Make a backup of your entire mygame folder, just to be sure!
  • Install Python 3.11 (recommended). Follow the Git-installation for your OS if needed.
  • Delete the old virtualenv evenv folder, or rename it (in case you want to keep using 0.9.5 for a while).
  • Make new evenv virtualenv (see the virtualenv instructions for help)
  • cd into your evennia/ root folder (you want to see the docs/ and bin/ directories as well as a nested evennia/ folder)
  • git pull
  • pip install -e .
  • If you want the optional extra libs (needed by some contribs), do pip install -e .[extra]
  • Test that you can run the evennia command.

Upgrading your game dir

If you don't have anything you want to keep in your existing game dir, you can just start a new onew using the normal install instructions. If you want to keep/convert your existing game dir, continue below.

  • First, make a backup of your exising game dir! If you use version control, make sure to commit your current state.
  • cd to your existing 0.9.5-based game folder (like mygame.)
  • If you have changed mygame/web, rename the folder to web_0.9.5. If you didn't change anything (or don't have anything you want to keep), you can delete it entirely.
  • Copy evennia/evennia/game_template/web to mygame/ (e.g. using cp -Rf or a file manager). This new web folder replaces the old one and has a very different structure.
  • It's possible you need to replace/comment out import and calls to the deprecated django.conf.urls. The new way to call it is available here.
  • Run evennia migrate
  • Run evennia start

If you made extensive work in your game dir, you may well find that you need to do some (hopefully minor) changes to your code before it will start with Evennia 1.0. Some important points:

  • The evennia/contrib/ folder changed structure - there are now categorized sub-folders, so you have to update your imports.
  • Any web changes need to be moved back from your backup into the new structure of web/ manually.
  • See the Evennia 1.0 Changelog for all changes.