<p>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 <aclass="reference internal"href="Installation.html"><spanclass="doc std std-doc">Installation</span></a> instructions and copy
<p>Prior to 1.0, all Evennia installs were <aclass="reference internal"href="Installation-Git.html"><spanclass="doc std std-doc">Git-installs</span></a>. These instructions
assume that you have a cloned <codeclass="docutils literal notranslate"><spanclass="pre">evennia</span></code> repo and use a virtualenv (best practices).</p>
<ulclass="simple">
<li><p>Make sure to stop Evennia 0.9.5 entirely with <codeclass="docutils literal notranslate"><spanclass="pre">evennia</span><spanclass="pre">stop</span></code>.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">deactivate</span></code> to leave your active virtualenv.</p></li>
<li><p>Make a <em>backup</em> of your entire <codeclass="docutils literal notranslate"><spanclass="pre">mygame</span></code> folder, just to be sure!</p></li>
<li><p>Install Python 3.11 (recommended). Follow the <aclass="reference internal"href="Installation-Git.html"><spanclass="doc std std-doc">Git-installation</span></a> for your OS if needed.</p></li>
<li><p>Delete the old virtualenv <codeclass="docutils literal notranslate"><spanclass="pre">evenv</span></code> folder, or rename it (in case you want to keep using 0.9.5 for a while).</p></li>
<li><p>Make <em>new</em><codeclass="docutils literal notranslate"><spanclass="pre">evenv</span></code> virtualenv (see the <aclass="reference internal"href="Installation-Git.html#virtualenv"><spanclass="std std-doc">virtualenv instructions</span></a> for help)</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">cd</span></code> into your <codeclass="docutils literal notranslate"><spanclass="pre">evennia/</span></code> root folder (you want to see the <codeclass="docutils literal notranslate"><spanclass="pre">docs/</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">bin/</span></code> directories as well as a nested <codeclass="docutils literal notranslate"><spanclass="pre">evennia/</span></code> folder)</p></li>
<li><p>If you want the optional extra libs (needed by some contribs), do <codeclass="docutils literal notranslate"><spanclass="pre">pip</span><spanclass="pre">install</span><spanclass="pre">-e</span><spanclass="pre">.[extra]</span></code></p></li>
<p>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 <aclass="reference internal"href="Installation.html"><spanclass="doc std std-doc">install instructions</span></a>. If you want to keep/convert your existing
game dir, continue below.</p>
<ulclass="simple">
<li><p>First, make a backup of your exising game dir! If you use version control, make sure to commit your current state.</p></li>
<li><p><codeclass="docutils literal notranslate"><spanclass="pre">cd</span></code> to your existing 0.9.5-based game folder (like <codeclass="docutils literal notranslate"><spanclass="pre">mygame</span></code>.)</p></li>
<li><p>If you have changed <codeclass="docutils literal notranslate"><spanclass="pre">mygame/web</span></code>, <em>rename</em> the folder to <codeclass="docutils literal notranslate"><spanclass="pre">web_0.9.5</span></code>. If you didn’t change anything (or don’t have anything you want to keep), you can <em>delete</em> it entirely.</p></li>
<li><p>Copy <codeclass="docutils literal notranslate"><spanclass="pre">evennia/evennia/game_template/web</span></code> to <codeclass="docutils literal notranslate"><spanclass="pre">mygame/</span></code> (e.g. using <codeclass="docutils literal notranslate"><spanclass="pre">cp</span><spanclass="pre">-Rf</span></code> or a file manager). This new <codeclass="docutils literal notranslate"><spanclass="pre">web</span></code> folder <em>replaces the old one</em> and has a very different structure.</p></li>
<aclass="reference external"href="https://docs.djangoproject.com/en/3.2/ref/urls/#url"><codeclass="docutils literal notranslate"><spanclass="pre">django.conf.urls</span></code></a>. The new way to call it is <aclass="reference external"href="https://docs.djangoproject.com/en/4.0/ref/urls/#django.urls.re_path">available here</a>.</p></li>
<p>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:</p>
<li><p>The <codeclass="docutils literal notranslate"><spanclass="pre">evennia/contrib/</span></code> folder changed structure - there are now categorized sub-folders, so you have to update your imports.</p></li>
<li><p>Any <codeclass="docutils literal notranslate"><spanclass="pre">web</span></code> changes need to be moved back from your backup into the new structure of <codeclass="docutils literal notranslate"><spanclass="pre">web/</span></code> manually.</p></li>
<li><p>See the <aclass="reference internal"href="../Coding/Changelog.html"><spanclass="doc std std-doc">Evennia 1.0 Changelog</span></a> for all changes.</p></li>
