准备开始


这篇文章将帮助你从头开始下载、安装、启动Evennia。

注意:你在运行和测试Evennia时并不需要向因特网开放自己的机器。除了安装和升级,你甚至不需要连接上网。当然,在你的网路游戏编写成熟之后你肯定需要让你的游戏上网,但在此之前,它可以完全在你安全且独立的本地机器上开发和运行。


快速开始

如果你已经等得不耐烦了,以下是通常安装运行Evennia的要点:
  1. 下载并安装Python和GIT,打开终端
  2. pip install virtualenv
  3. cd 到你想要放置虚拟环境的地方
  4. virtualenv pyenv
  5. source pyenv/bin/activate (Linux, Mac)或 pyenv\Scripts\activate (Windows)
  6. cd 到你想要放置evennia的地方
  7. git clone https://github.com/evennia/evennia.git 或
    git clone git@github.com:evennia/evennia.git
  8. cd evennia
  9. pip install -e . (注意在最后面有一个点!)
  10. cd 到你想要放置游戏的地方。
  11. evennia --init mygame
  12. cd mygame
  13. evennia migrate
  14. evennia -i start
    (请确认在要求创建superuser时创建了superuser)。Evennia现在应该在运行了,你可以通过网页浏览器访问 http://localhost:8000 或者使用MUD客户端连接到 localhost:4000

继续阅读以获得详细的指导。


必备软件

不论什么操作系统,只要能支持Python就行。
  • Linux/Unix
  • Windows (2000, XP, Vista, Win7, Win8)
  • Mac OSX (建议>=10.5)
如果你在运行中遇到了问题,或者在其他平台上成功运行了Evennia,请告知我们。

你需要以下最低版本的安装包以运行Evennia(其中大多数都不需要手动安装,请继续阅读):
  • Python (v2.7+, 不支持 v3.x).
  • Twisted (v12.0+)
    • ZopeInterface (v3.0+) —— 通常已经包含在Twisted安装包中了
    • Windows用户需要pywin32
  • Django (v1.7+,注意:最新的开发者版本很可能没有在Evennia上测试过)
    • Pillow (Python图像库)。它通常是和Django一起发布的。作为备用,你也可使试试更老的PIL,Pillow就是以它为基础的。
    • Pip (Python的安装工具),从Python 2.7.9起,已被包含在Python中。
  • virtualenv 这是在实际使用中,让不同版本的Python库在同一台机器共存而不产生冲突的标准方法。
  • GIT 版本控制软件,可以获取和更新Evennia。

可选:
  • PyPy (v1.7+)
    • 运行Python更快,在本文最后有如何在PyPy环境中运行Evennia。


第一步:安装必备软件

总的来说,你只需要手动下载和安装Python和GIT,其余的东西都可以由Python的安装工具处理。

Linux
大多数Linux系统已经附带了Python。Python 2.7.9及之后的版本还自带了安装管理工具pip。如果你的Python版本低于 2.7.9,你需要单独安装 pip 。在Debian衍生系统中(如Ubuntu,Mint)你可以这样做(需要root权限):
apt-get install python git python-pip
如果你没有root权限,你可以要求你的系统管理员帮你安装,这应该不难办到,因为这些都是标准的组件。如果之后你在安装 Pillow 时遇到缺少Python.h的错误,你可以执行
apt-get install python-dev

之后我们就可以使用 pip 来安装我们所需的其余python包了。前往你想要做python开发的地方:
cd /path/to/my/pythondevel/
pip install virtualenv
virtualenv pyenv

这会下载并安装 virtualenv 到我们所选的目录中,在这个例子中是 pyenv。这让我们可以安装新的Python包而不会影响到当前系统默认的包。激活虚拟环境:
source pyenv/bin/activate
“pyenv”的字样会出现在命令提示符边上,表示虚拟环境已经激活了(我们可以使用 deactivate 命令来关闭它)。如果我们想要启用与Evennia相关的环境,可以在每次打开新终端时像这样激活虚拟环境。但我们不必进入 pyenv 文件夹,只要环境被激活,我们就可以做各种事情而不用去管 pyenv。现在前往你想要创建evennia文件夹的地方,下载evennia:
git clone https://github.com/evennia/evennia.git
如果你在github上拥有SSH密钥你可能想用另一种方式:
git clone git@github.com:evennia/evennia.git

之后你就可以进入evennia目录并使用git pull命令来获取最近的更新了。接下来我们要安装Evennia:
cd evennia
pip install -e .
请注意在最后还有一个点(.)!这个点表示我们要从当前目录安装软件包。-e 表示通以链接的方式安装Evennia,这样你在通过更新了git仓库之后,软件包也会立即更新。

Evennia以及它所依赖的软件现在都安装好了。

MacOSX
在最新的MacOSX中,Python 2.7已经预装好了(这里有如何更新它的讨论)。Git可以通过git-osx-installer来获取,或者通过MacPorts按这里所述的方式获取。

sudo easy_install pip

然后使用 pip 获取virtualenv,按上文所述的Linux方式继续安装。

Windows
Windows用户首先需要知道Evennia服务器是在命令行中运行的,从我们收到的提问来看,这对Windows用户来说可能并不熟悉。在Windows开始菜单中找到“所有程序”->“附件”->“命令提示符”并运行,你就可以见到Windows的命令行界面了。在网上有很多关于Windows命令行的教程,这里就有一个。

从Python主页安装Python。你需要有Windows的管理员权限来安装它。你要安装Python 2.7+的版本(Evennia不支持Python3),最好是2.7.9或之后的版本。在安装时,要注意勾选所有的安装选项,特别是把Python添加到path中的那项(这可以让你在任何终端窗口中使用python,而不需要先找到python程序在你硬盘上的实际安装位置)。

你还需要下载并安装GIT。你可以使用默认的安装选项,但当你被问及 “Adjust your PATH environment” 时,你需要选择第二个选项 “Use Git from the Windows Command Prompt”,这样使用程序的地点可以更加灵活。

进入你想要放置Python开发环境的文件夹。如果你安装了Python 2.7.9 或之后的版本,pip应该已经可以使用了(否则,可以以管理员身份在终端里用 easy_install pip 单独下载它)。
cd path\to\my\pythondev
pip install virtualenv
virtualenv pyenv
一个新文件夹 pyenv 会创建在你的当前目录中。这是我们要安装Python包的地方。我们需要激活这个“虚拟环境”,让Python和pip知道要把东西安装到这里:
pyenv\Scripts\activate

如果命令提示符变成(pyenv),说明虚拟环境已经激活了(之后如果需要的话,你还可以使用 deactivate 命令来关闭它)。如果我们想要启用Python环境,可以在每次打开新终端时像这样激活虚拟环境。激活之后我们就不用再 pyenv 文件夹了,我们可以把其他的文件放在任何我们想放的地方。因此,在虚拟环境激活后,前往你想要安装evennia的地方并运行:
git clone https://github.com/evennia/evennia.git
如果你在github上拥有SSH密钥你可能想用另一种方式:
git clone git@github.com:evennia/evennia.git

一个新文件夹evennia会创建出来。以后你可以进入这个目录并使用git pull命令来获取最近的更新。现在我们要使用pip来安装Evennia:
cd evennia
pip install -e .
请注意在最后还有一个点(.)!这个点表示我们要从当前目录安装软件包。-e 表示通以链接的方式安装Evennia,这样你在通过更新了git仓库之后,软件包也会立即更新。

Evennia以及它所依赖的软件现在都安装好了。如果你没有安装过编译器(大多数Windows用户都没有),你可能会看到警告说"unoptimized(未经优化的)"模块及链接将要安装Visual C++编译器。这是可选的,到目前为止还没发现这些“未经优化的”模块对性能造成影响。

第二步:设置你的游戏

现在你已经安装好了Evennia库,只要处在安装了Evennia的虚拟环境中,你就可以通过终端使用evennia的命令。现在进入你想要创建新游戏的文件夹,请避免在evennia文件夹中创建游戏,这样可以将它们分隔开。你可以将游戏命令为任何你喜欢的名字,在这里我们把它称为“mygame”。
evennia --init mygame
一个新的mygame文件夹会创建出来,你还会看到一些信息文字。mygame文件夹(或任何你命名的文件夹)是创建所有与你游戏相关东西的地方。

请注意,此时你的游戏没有任何版本控制,如果你想要版本控制(强力建议你在开始开发的时候这么做),可以参考我们的指导

你的服务器的配置文件为 mygame/server/conf/settings.py 。如果你想要自定义Evennia的数据库设置,你可以现在就修改。如果你不确定该怎么做,你不用修改任何东西,Evennia会使用最佳的默认设置。
cd mygame
evennia migrate

你会看到数据库被创建出来。如果你在转换现有的Evennia数据库,你可能会被问及是否要移除某些模块,对这些问题都回答“yes”。

第三步:启动和停止服务器

要启动服务器,请确保你在 mygame 目录中,然后执行:
evennia -i start
-i 标志表示服务器会作为前台进程以交互模式启动,调试/日志消息会直接显示在终端窗口中而不是记录到文件中。这便于检查所有的东西是否都在正常工作。

你将会被要求创建一个超级用户,当你被问及,请你一定要创建超级用户,这将成为游戏中的超级用户(所有者)账号的登录名。你还会被要求提供电子邮件地址和密码,电子邮件地址不需要真实存在(evennia不对此做检查)。

输入超级用户信息后,服务器程序和接入程序将第一次启动。Evennia会快速地运行一些初始配置(特别是使用你的超级用户创建一个同名的游戏角色),经过一次重新启动后就开始运行了。

要停止Evennia运行,请执行:
evennia stop
控制Evennia进程的高级运行选项请参阅“运行Evennia”。


第四步:连接到服务器

Evennia服务器现在运行起来了。你可以通过任意一种传统的MUD客户端或telnet使用创建数据库时指定的名称和密码登录。如果你只是想在你的本地计算机上测试服务器,绝多数情况下服务器名称是localhost,默认使用端口4000。

如果没有改过默认值,Evennia会同时在端口8000上启动他自己的基于Twisted的web服务器。将Web浏览器连接到http://localhost:8000/,管理界面允许你在线编辑游戏数据库,你还可以通过使用我们的Web客户端直接连接到游戏。

欢迎来到Evennia!接下来何不尝试建造些东西呢?


可选:在PyPy下运行

Evennia也可以在PyPy(一个高速度的、可替代标准Python的选择)下运行。Evennia在PyPy下一般需要较长时间才能启动,但只要启动起来就可以更快地运行(到底快多少目前还没有测试过,欢迎你随时报告你的发现)。

首先你需要下载并安装PyPy。请看PyPy主页上的说明。这可能是最棘手的一步,需要依你的操作系统而定。请仔细阅读PyPy主页上的说明。

在pypy下安装Evennia最简单的方法是在一个单独的virtualenv环境中安装。首先如前面所述取得virtualenv程序,然后像这样创建虚拟环境:
virtualenv mudenv --python=/usr/bin/pypy
请将 usr/bin/pypy 替换为你系统中PyPy的二进制文件所在的完整路径。

接下来你按照正常的方式激活虚拟环境。请务必在虚拟环境中安装所有的必备软件。如果pip运行中止并且报告"dependence is already satisfied"(“依赖已满足”),请使用 --upgrade 选项,这样如果必备软件有针对PyPy的增强版本,将会被安装。

像往常一样下载并配置Evennia,然后用以下方式启动:
pypy evennia.py -i start
在游戏中你(作为超级用户)可以做以下操作来检测PyPy是否在工作:
@py import __pypy__
如果这个可以执行,说明Evennia在pypy下运行。如果你得到一个ImportError说明发生了些问题,仍然在使用普通的CPython。


(原文:https://github.com/evennia/evennia/wiki/Getting Started    翻译:卢铱俊)