启动！

现在你已经安装好了 MCDR，是时候启动它了

备注

MCDR 最常见的用途是控制 Minecraft 服务器，我们也就以此为例

小技巧

在用 MCDR 管理 Minecraft 服务器前，建议对常见的 Minecraft 服务端有些基础了解

换句话说，请先了解：

常见的 Minecraft 服务端：有哪些，该如何配置（了解其中一种即可）
Minecraft 服务端的启动命令：是什么，启动参数分别是什么意思
服务端控制台：它会输出什么，能接受什么命令
如何管理服务器：配置文件，mod / 插件等

不了解也没关系，请善用搜索引擎

准备

要用 MCDR 管理 Minecraft 服务器，你首先需要 配置好 一个 Minecraft 服务端

例如，这是典型的原版 Minecraft 服务端目录结构：

./
├── libraries/
├── logs/
├── versions/
├── world/
├── banned-ips.json
├── banned-players.json
├── eula.txt
├── ops.json
├── minecraft_server.jar
├── server.properties
├── usercache.json
└── whitelist.json

可以使用以下命令启动它：

java -Xms1G -Xmx2G -jar minecraft_server.jar nogui

当然，你也可以选择其他服务端，如 Fabric、Spigot、Paper 等

小技巧

在引入 MCDR 之前，请先配置并调试好服务端。否则，你将很难区分由 MCDR 和由服务端引起的问题

MCDR 是为 Minecraft Java 版常见服务端而诞生的。大多数插件以此为前提

当然，如果你不需要使用为 Java 版服务器设计的插件生态系统，那用 MCDR 跑啥都行

初始化

假设你要在名为 my_mcdr_server 的文件夹中启动 MCDR，那么你可以运行以下命令来初始化 MCDR 环境：

cd my_mcdr_server
mcdreforged init

MCDR 将生成一个如下所示的默认文件结构：

my_mcdr_server/
 ├─ config/
 ├─ logs/
 │   └─ MCDR.log
 ├─ plugins/
 ├─ server/
 ├─ config.yml
 └─ permission.yml

动画演示：

配置

服务端

还记得你准备的服务端吗？把它整份放到 server 文件夹中

    my_mcdr_server/
    ├─ config/
    ├─ logs/
    │   └─ MCDR.log
    ├─ plugins/
    ├─ server/
++  │   ├─ ...
++  │   ├─ minecraft_server.jar
++  │   └─ server.properties
    ├─ config.yml
    └─ permission.yml

配置文件

然后，你需要编辑 config.yml 文件来配置 MCDR。详见配置一章

对于大多数用户来说，有 4 个需要注意的配置项：

language：MCDR 使用的语言
start_command：MCDR 启动服务端的命令
handler：MCDR 处理服务端输出的方式
encoding, decoding：MCDR 编/解码服务端输入/输出流的方式

请仔细阅读这几节，确保填写正确

例如，对于 Java 21 的 Minecraft 1.21 原版服务端，需要关注的部分如下：

start_command: java -Dfile.encoding=UTF-8 -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -Xms1G -Xmx2G -jar minecraft_server.jar nogui

handler: vanilla_handler

encoding: utf8
decoding: utf8

如果你产生了 “为什么这命令相比上面的例子长了这么多” 的疑问，请再读读 encoding, decoding 一节

启动！

现在，你应该能够启动 MCDR，并且它应该能够正确地处理服务端

mcdreforged

如上配置的动画演示：

也请在游戏中测试 MCDR：