準(zhǔn)備

在開始之前，我們需要做一些準(zhǔn)備。

一些需要的知識(shí)

● 無論是 MCDR 還是 Minecraft 服務(wù)端都要求你有一定的電腦基礎(chǔ)。例如，在當(dāng)前文件夾打開命令提示符、編輯簡(jiǎn)單的 Batch 批處理文件（Windows），或終端操作的基本命令（Linux）。

● MCDR 是一個(gè) Minecraft 服務(wù)端守護(hù)進(jìn)程。因此，你需要先了解 Minecraft 服務(wù)端的相關(guān)基本知識(shí)。

● MCDR 及其插件的配置文件一般使用 YAML 或 JSON。你可以在以下鏈接中快速學(xué)習(xí)它們：

????○ 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

文本編輯器

?【警告：不要使用記事本】無論什么時(shí)候，都不要使用 Windows 記事本編輯文件。

這里，我推薦 Notepad2 和 Notepad3，它們都是輕量開源的文本編輯器。

另外，使用 Notepad Replacer 可以將 Windows 記事本替換為你喜歡的編輯器。

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

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

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

服務(wù)端

MCDR 是一個(gè) Minecraft 服務(wù)端守護(hù)進(jìn)程。因此，我們需要準(zhǔn)備一個(gè)可以正常啟動(dòng)的服務(wù)端。

例如，這是一個(gè)準(zhǔn)備好的 Fabric 服務(wù)端（部分文件未列出）：

它的啟動(dòng)命令如下：

安裝 Python

MCDR 需要 Python 作為運(yùn)行環(huán)境。因此，我們需要安裝 Python。

為了方便和穩(wěn)定，這里推薦安裝 Miniconda（一個(gè)集成式 Python 環(huán)境）而不是 Python 本體，因?yàn)?Miniconda 總是跟隨最新一個(gè)穩(wěn)定的 Python 版本，可以避免一些兼容性問題。這是 Miniconda 最新版本的官方和鏡像下載鏈接：

????【官網(wǎng)】https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

????【國(guó)內(nèi)鏡像】https://mirrors.bfsu.edu.cn/anaconda/miniconda/Miniconda-latest-Windows-x86_64.exe

安裝過程如圖：

安裝完成后，打開終端測(cè)試是否能夠激活 Python：

安裝 MCDR

準(zhǔn)備工作完成后，我們就可以正式安裝 MCDR 了。

?【警告：不要使用源碼啟動(dòng)】從 1.0 版本開始，MCDR 的部署不再需要下載和解壓源碼 ZIP，請(qǐng)不要這樣做。 對(duì)于普通用戶，源碼啟動(dòng)會(huì)導(dǎo)致 MCDR 無法正常更新，部分插件無法正常使用。

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

在國(guó)內(nèi)訪問 pip 的官方源速度十分緩慢，因此我們需要設(shè)置 pip 國(guó)內(nèi)源。

在終端中運(yùn)行以下命令：pip config set global.index-url https://mirrors.bfsu.edu.cn/pypi/web/simple?

然后，安裝 MCDR：pip install mcdreforged

安裝時(shí)，你可能會(huì)遇到?報(bào)錯(cuò)——?ValueError: check_hostname requires server_hostname。此時(shí)的解決方法如下圖：

部署和配置

安裝完成后，我們可以開始部署 MCDR 了。

新建一個(gè)空文件夾作為 MCDR 根目錄（這里以 mcdr 為例），并在那里打開終端，輸入命令：python -m mcdreforged init

MCDR 將生成默認(rèn)的配置文件、權(quán)限文件，以及一些默認(rèn)的文件夾。此時(shí)的路徑結(jié)構(gòu)將會(huì)如下所示：

記得之前準(zhǔn)備的 Minecraft 服務(wù)端嗎？將它整個(gè)復(fù)制到 server 文件夾。

此時(shí)的文件結(jié)構(gòu)類似這樣（部分文件未列出）：

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

??【注意：若啟動(dòng)命令中包含引號(hào)等非法字符】可以使用「多行文本」填寫：

啟動(dòng) MCDR

現(xiàn)在，萬事俱備，讓我們來啟動(dòng) MCDR。在 MCDR 根目錄中打開終端，輸入命令：

????python -m mcdreforged

看，它跑起來了！

測(cè)試和簡(jiǎn)化

接下來，我們做點(diǎn)測(cè)試，確定 MCDR 是否已經(jīng)開始工作。

●?MCDR 及其插件的指令一般 以?!!（兩個(gè)感嘆號(hào)）開頭。MCDR 內(nèi)置了一系列以?!!MCDR?開頭的指令以進(jìn)行一些基本操作。在客戶端和控制臺(tái)分別執(zhí)行?!!MCDR，觀察是否被正常回復(fù)：

● 接下來，測(cè)試?MCDR 是否能夠正常解析中文。在客戶端發(fā)送一句中文，觀察 MCDR?是否報(bào)錯(cuò)：

使用 UTF-8

如果一切正常，恭喜！你的操作系統(tǒng)和 MCDR 的相性很好，你可以選擇跳過這一部分。

如果沒有反應(yīng)或者出現(xiàn)亂碼，也不必?fù)?dān)心——使用 UTF-8 即可解決這一問題。

首先，修改 Minecraft 服務(wù)端啟動(dòng)命令，在 Java 可執(zhí)行文件后添加 -Dfile.encoding=UTF-8 。修改后的指令類似這樣：

然后，將?MCDR 的配置文件（config.yml）中的編解碼器設(shè)置為 utf8：

這樣，服務(wù)端輸入輸出、MCDR 的編解碼都會(huì)使用 UTF-8。

現(xiàn)在，重啟 MCDR，測(cè)試是否仍有問題。

簡(jiǎn)化啟動(dòng)方式（Windows）

為了使啟動(dòng)更簡(jiǎn)單，你可以在 MCDR 根目錄新建一個(gè) .bat 格式的文件（例如 start.bat），輸入以下內(nèi)容：

@echo off ＆?python -m mcdreforged ＆?pause

以后，你就可以雙擊這個(gè)文件來啟動(dòng) MCDR，而不必手輸命令。