Muddery是一个用Python编写的在线文字游戏（如MUD）框架，所有的代码都是开源的，采用BSD许可证发布。它使用Evennia（一个MUD游戏框架）作为其内核。

特点 Muddery具有以下特点： 使用Python开发，可以跨平台使用，只需要花几分钟时间就能够安装它。 支持多人在线游戏，游戏内容主要以文字形式展现，但也可以扩展加入多媒体的内容。 内建有基本的任务系统、事件系统、对话系统等，便于游戏的创建。 自带有网页版的游戏编辑器，可以在网页上构建游戏世界。 自带网页客户端，可以轻松地发布游戏。 完全使用点击式的游戏操作模式，便于在智能手机、平板设备上使用。

Python3 的 Ubuntu 版本，如 18.04，安装：

Python应用程序通常会使用不在标准库内的软件包和模块。应用程序有时需要特定版本的库，因为应用程序可能需要修复特定的错误，或者可以使用库的过时版本的接口编写应用程序。

这意味着一个Python安装可能无法满足每个应用程序的要求。如果应用程序A需要特定模块的1.0版本但应用程序B需要2.0版本，则需求存在冲突，安装版本1.0或2.0将导致某一个应用程序无法运行。

这个问题的解决方案是创建一个 virtual environment，一个目录树，其中安装有特定Python版本，以及许多其他包。 创建虚拟环境 用于创建和管理虚拟环境的模块称为 venv。venv 通常会安装你可用的最新版本的 Python。如果您的系统上有多个版本的 Python，您可以通过运行 python3 或您想要的任何版本来选择特定的Python版本。

要创建虚拟环境，请确定要放置它的目录，并将 venv 模块作为脚本运行目录路径:

python3 -m venv tutorial-env 如果它不存在，这将创建 tutorial-env 目录，并在其中创建包含Python解释器，标准库和各种支持文件的副本的目录。

创建虚拟环境后，您可以激活它。

在Windows上，运行:

tutorial-env\Scripts\activate.bat 在Unix或MacOS上，运行:

source tutorial-env/bin/activate

启动示例程序

补充知识：

你可以使用一个名为 pip 的程序来安装、升级和移除软件包。默认情况下 pip 将从 Python Package Index https://pypi.org 安装软件包。你可以在浏览器中访问 Python Package Index 或是使用 pip 受限的搜索功能:

pip 有许多子命令：“search”、“install”、“uninstall”、“freeze”等等。（请参阅 安装 Python 模块 指南以了解 pip 的完整文档。）

您可以通过指定包的名称来安装最新版本的包：

您还可以通过提供包名称后跟 == 和版本号来安装特定版本的包：

如果你重新运行这个命令，pip 会注意到已经安装了所请求的版本并且什么都不做。您可以提供不同的版本号来获取该版本，或者您可以运行 pip install --upgrade 将软件包升级到最新版本：

pip uninstall 后跟一个或多个包名称将从虚拟环境中删除包。

pip show 将显示有关特定包的信息：

pip list 将显示虚拟环境中安装的所有软件包：

(tutorial-env) $ pip list novas (3.1.1.3) numpy (1.9.2) pip (7.0.3) requests (2.7.0) setuptools (16.0) pip freeze` 将生成一个类似的已安装包列表，但输出使用 pip install 期望的格式。一个常见的约定是将此列表放在 requirements.txt 文件中：

然后可以将 requirements.txt 提交给版本控制并作为应用程序的一部分提供。然后用户可以使用 install -r 安装所有必需的包：

更新 Muddery 代码 Muddery 的代码是发布在 Github 上的，用户可以随时从 Github 上获取最新的代码。

进入 Muddery 代码所在的目录，执行 git pull 这样就可以从 Github 上拉取最新的代码，并且和你本地的代码进行合并。

请注意，如果你修改过本地的 Muddery 代码，可能会造成合并、更新失败。所以不建议用户直接修改 Muddery 目录中的代码。如果想给系统添加自定义的内容，可以在用户自己的游戏目录中创建派生类，在派生类添加自己的内容。具体的修改方法之后会有详细的教程。

升级游戏 当 Muddery 系统的数据库结构发生了变化或者有其他重大更新时，用户不止要更新 Muddery 系统，还要升级已创建好的游戏才能让游戏正常运行。

游戏对应的系统版本号和模版记录在游戏目录的 game.cfg 文件中，系统会以此判断游戏的版本是否需要升级。

进入游戏目录，输入命令 muddery start 启动游戏。如果游戏没有启动，而是显示出以下信息： Your game’s version is too old. Please run:

就说明游戏目录必须升级。

你只需要在游戏目录中执行 muddery --upgrade 系统就会自动升级。

在升级前，升级程序会先备份当前的游戏目录，备份目录和当前游戏目录在同级目录中，备份目录的名字为游戏目录名加上 _bak_日期。用户可以在这个文件夹中找到所有升级前的文件。如果用户觉得升级有问题，只要将备份目录的名字改为原来的名字就可以回退。

请注意，有时在升级游戏之后，某些游戏数据无法自动同步到新的游戏中，这时就需要手工将数据补充到新的游戏数据库中。如果用户使用的是默认的Sqlite3数据库，数据库文件会随其他文件一起拷贝到备份目录中，而如果使用的是MySQL或其他数据库，则需要在升级之前先手工备份数据库。