准备

在开始之前，我们需要做一些准备。

一些需要的知识

● 无论是 MCDR 还是 Minecraft 服务端都要求你有一定的电脑基础。例如，在当前文件夹打开命令提示符、编辑简单的 Batch 批处理文件（Windows），或终端操作的基本命令（Linux）。

● MCDR 是一个 Minecraft 服务端守护进程。因此，你需要先了解 Minecraft 服务端的相关基本知识。

● MCDR 及其插件的配置文件一般使用 YAML 或 JSON。你可以在以下链接中快速学习它们：

    ○ https://learnxinyminutes.com/docs/zh-cn/yaml-cn

        或 https://www.runoob.com/w3cnote/yaml-intro.html

    ○ https://learnxinyminutes.com/docs/zh-cn/json-cn

        或 https://www.runoob.com/json/json-syntax.html

文本编辑器

⛔【警告：不要使用记事本】无论什么时候，都不要使用 Windows 记事本编辑文件。

这里，我推荐 Notepad2 和 Notepad3，它们都是轻量开源的文本编辑器。

另外，使用 Notepad Replacer 可以将 Windows 记事本替换为你喜欢的编辑器。

    ● https://github.com/zufuliu/notepad2

    ● https://github.com/rizonesoft/Notepad3

    ● https://www.binaryfortress.com/NotepadReplacer

服务端

MCDR 是一个 Minecraft 服务端守护进程。因此，我们需要准备一个可以正常启动的服务端。

例如，这是一个准备好的 Fabric 服务端（部分文件未列出）：

它的启动命令如下：

安装 Python

MCDR 需要 Python 作为运行环境。因此，我们需要安装 Python。

为了方便和稳定，这里推荐安装 Miniconda（一个集成式 Python 环境）而不是 Python 本体，因为 Miniconda 总是跟随最新一个稳定的 Python 版本，可以避免一些兼容性问题。这是 Miniconda 最新版本的官方和镜像下载链接：

    【官网】https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

    【国内镜像】https://mirrors.bfsu.edu.cn/anaconda/miniconda/Miniconda-latest-Windows-x86_64.exe

安装过程如图：

安装完成后，打开终端测试是否能够激活 Python：

安装 MCDR

准备工作完成后，我们就可以正式安装 MCDR 了。

⛔【警告：不要使用源码启动】从 1.0 版本开始，MCDR 的部署不再需要下载和解压源码 ZIP，请不要这样做。 对于普通用户，源码启动会导致 MCDR 无法正常更新，部分插件无法正常使用。

pip 是 Python 的包管理器，我们要用它安装 MCDR，以及一些插件的前置模块。

在国内访问 pip 的官方源速度十分缓慢，因此我们需要设置 pip 国内源。

在终端中运行以下命令：pip config set global.index-url https://mirrors.bfsu.edu.cn/pypi/web/simple 

然后，安装 MCDR：pip install mcdreforged

安装时，你可能会遇到 报错—— ValueError: check_hostname requires server_hostname。此时的解决方法如下图：

部署和配置

安装完成后，我们可以开始部署 MCDR 了。

新建一个空文件夹作为 MCDR 根目录（这里以 mcdr 为例），并在那里打开终端，输入命令：python -m mcdreforged init

MCDR 将生成默认的配置文件、权限文件，以及一些默认的文件夹。此时的路径结构将会如下所示：

记得之前准备的 Minecraft 服务端吗？将它整个复制到 server 文件夹。

此时的文件结构类似这样（部分文件未列出）：

之后，我们打开 MCDR 的配置文件（ config.yml ），修改一些基本配置：

⚠️【注意：若启动命令中包含引号等非法字符】可以使用「多行文本」填写：

启动 MCDR

现在，万事俱备，让我们来启动 MCDR。在 MCDR 根目录中打开终端，输入命令：

    python -m mcdreforged

看，它跑起来了！

测试和简化

接下来，我们做点测试，确定 MCDR 是否已经开始工作。

● MCDR 及其插件的指令一般 以 !!（两个感叹号）开头。MCDR 内置了一系列以 !!MCDR 开头的指令以进行一些基本操作。在客户端和控制台分别执行 !!MCDR，观察是否被正常回复：

● 接下来，测试 MCDR 是否能够正常解析中文。在客户端发送一句中文，观察 MCDR 是否报错：

使用 UTF-8

如果一切正常，恭喜！你的操作系统和 MCDR 的相性很好，你可以选择跳过这一部分。

如果没有反应或者出现乱码，也不必担心——使用 UTF-8 即可解决这一问题。

首先，修改 Minecraft 服务端启动命令，在 Java 可执行文件后添加 -Dfile.encoding=UTF-8 。修改后的指令类似这样：

然后，将 MCDR 的配置文件（config.yml）中的编解码器设置为 utf8：

这样，服务端输入输出、MCDR 的编解码都会使用 UTF-8。

现在，重启 MCDR，测试是否仍有问题。

简化启动方式（Windows）

为了使启动更简单，你可以在 MCDR 根目录新建一个 .bat 格式的文件（例如 start.bat），输入以下内容：

@echo off ＆ python -m mcdreforged ＆ pause

以后，你就可以双击这个文件来启动 MCDR，而不必手输命令。