英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

泥浆派

一个简单的基于文本的多人地牢（MUD）游戏，可以在树莓派或其他低端服务器上运行。

需求

你需要在希望运行服务器的地方安装Python（2.7或3.3）。Windows和Mac的安装程序可以在http://www.python.org/download/找到。Linux也有压缩包，不过在Linux上安装的最佳方式是通过包管理器。

为了允许玩家远程连接，服务器还需要连接到互联网。

要连接到服务器，您需要一个telnet客户端。在Mac、Linux以及Windows Vista之前的版本中，telnet客户端通常默认安装。对于Windows Vista、7、8或更高版本，您可能需要按照本指南来安装它。

运行服务器

在 Windows 上

双击 simplemud.py —— 文件将使用 Python 解释器打开。要停止服务器，只需关闭终端窗口。

在 Mac OSX 和 Linux（包括 Raspberry Pi）上

在终端中，切换到包含脚本的目录并运行

python simplemud.py

请注意，如果你通过 SSH 连接到机器，你会发现当你退出 SSH 会话时，脚本会停止运行。让脚本继续运行的一种简单方法是使用一个名为 screen 的工具。像往常一样通过 SSH 连接，然后运行 screen。你将进入看起来像普通 shell 提示符的界面，但现在你可以启动 Python 脚本并按 ctl+a，然后按 d，让 screen 在后台运行。下次连接时，你可以使用 screen -r 重新连接到你的 screen 会话。或者，你也可以 创建一个守护进程脚本，让脚本在每次服务器启动时在后台运行。

连接到服务器

如果服务器运行在 NAT 后面，例如家庭路由器，你需要将端口 1234 设置为转发到运行服务器的机器。请参阅你的路由器说明了解如何设置。在这里有大量不同型号路由器的设置指南：http://portforward.com/english/routers/port_forwarding/

你需要知道运行服务器的机器的外部 IP 地址。可以通过从该机器访问 http://www.whatsmyip.org 来发现。

要连接到服务器，请打开操作系统的终端或命令提示符，并通过运行以下命令启动 telnet 客户端：

telnet <ip address> 1234

其中 <ip address> 是服务器的外部 IP 地址，如上所述。1234 是服务器监听的端口号。

如果您使用的是 Windows Vista、7、8 或更高版本，并收到以下消息：

'telnet' is not recognized as an internal or external command, operable
program or batch file.

然后按照 此指南 安装 Windows Telnet 客户端。

如果一切顺利，您应该会看到该消息

What is your name?

要退出 telnet 客户端，按 ctl + ] 进入提示符，然后输入 quit。

什么是 Telnet？

Telnet 是一种简单的基于文本的网络通信协议，发明于1969年，此后已被其他更安全的协议所取代。然而，它在一些特殊用途上仍然流行，MUD 游戏就是其中之一。有关 Telnet 协议的长期（且枯燥）历史可以在这里找到：http://www.cs.utexas.edu/users/chris/think/ARPANET/Telnet/Telnet.shtml

什么是MUD？

MUD 是多用户地下城（Multi-User Dungeon）的缩写。MUD 是一种基于文本的在线角色扮演游戏。MUD 在 80 年代初非常流行，是我们今天所玩的图形化大型多人在线角色扮演游戏（如《魔兽世界》）的先驱。http://www.mudconnect.com 是一个了解 MUD 的很棒的网站。

扩展游戏

MUD Pi 是一个免费且开源的项目（这里的“免费”是指“自由”）。这意味着源码是包含在内的，你可以自由地阅读、复制、扩展它，并用它作为你自己的 MUD 游戏或任何其他项目的起点。更多信息请参见 licence.md。

MUD Pi 是用 Python 编程语言编写的。如果你以前从未使用过 Python，或者对编程完全不熟悉，可以尝试在线教程，例如 http://www.learnpython.org/。

项目中有 2 个源文件。mudserver.py 是一个包含 MudServer 类的模块——一个基础服务器脚本，用于处理玩家连接以及消息的发送和接收。simplemud.py 是一个使用 MudServer 的示例游戏，具有玩家聊天功能和可移动的房间。

开始调整游戏的最佳位置是查看 simplemud.py。为什么不尝试为游戏世界添加更多房间呢？你会在源码中找到更多可尝试的想法。

当然，如果你更有冒险精神，也可以看看 mudserver.py 中稍微复杂一点的网络代码。

基于 MUD-Pi 的项目

以下是一些人们用 MUD-Pi 制作的很酷的项目：

• ESP8266 MUD 由 Barry Ruffner 制作 - 一个完全在 ESP8266 微芯片上运行的 MUD，使用 MicroPython
• MuddySwamp 由佛罗里达大学开源俱乐部制作 - 一个以 UF 为主题的 MUD
• Dumserver 由 Bartek Radwanski 制作 - 一个功能丰富的 MUD 引擎

作者

MUD Pi 是由 Mark Frimston 编写的

如需反馈，请发送电子邮件至 mfrimston@gmail.com 或在项目的 Github 页面 添加评论