服务端说明

使用 MCDReforged 管理 NeoForge 服务器

使用 Minecraft-QQBot 及其 mcdr 插件 实现 qq bot

服务端部署

mcdr

参考 mcdr 文档

这里选择使用 uv 管理 python 环境，参考 uv 文档 安装好 uv 之后，克隆此项目，在项目根目录执行下面的命令安装并初始化 mcdr：

uv sync
uv run mcdreforged init

neoforge

参考 neoforge 文档

执行下面的命令，在 mcdr 的 server 目录中安装 neoforge：

# 进入 mcdr 的 server 目录
cd server

# 下载 neoforge installer jar
wget https://maven.neoforged.net/releases/net/neoforged/neoforge/21.1.228/neoforge-21.1.228-installer.jar

# 安装
java -jar neoforge-21.1.228-installer.jar --installServer

# neoforge 安装时会覆盖 run.sh 文件，需要 restore 回去
git restore run.sh

# 回到项目根目录
cd ..

服务端配置

server/run.sh 文件中，使用的是 graalvm jdk，可以自行编辑 ，将 JAVA_BIN 修改为自己使用的 jdk 路径，如果不打算修改，需要自行下载 graalvm jdk 并放在对应位置

server/user_jvm_args.txt 中配置了与 graalvm jdk 相配合的一系列 jvm 参数，这里建议按照自己需求进行修改

为什么默认配置是这样的？

我不道啊，当时好像是在 Cubic Wiki 上看到 这里 有推荐 graalvm，然后又介绍了一堆 jvm 参数，于是抄了下来，又交给 ai 改了改，跑起来没什么问题，就一直用着了

总而言之，jdk 的选择和 jvm 的配置，还是自己多实验一下再决定好了

server/server/properties 中简单配置了一些东西，比如开启允许飞行，关闭正版验证，并打开了 rcon 功能用于配合 qq bot，这里也可以按照自己的需求修改

mc.service 文件是用于 systemd 的 service 文件，里面主要是 WorkingDirectory 需要修改成项目路径，如果不打算使用 systemd 的话不需要关心

服务端运行

手动启动

可以选择手动启动服务：

uv run mcdreforged

systemd

或者通过 systemd 管理服务

编辑项目根目录下的 mc.service 文件，修改 WorkingDirectory 的值为项目路径

将 mc.service 文件复制到 ~/.config/systemd/user/ 目录下，执行

# 加载服务
systemctl --user daemon-reload

# 设置服务开机自启，并立即启动服务
systemctl --user enable --now mc

之后可以通过 systemctl 命令来管理项目：

# 启动服务
systemctl --user start mc

# 关闭服务
systemctl --user stop mc

# 重启服务
systemctl --user restart mc

# 显示服务状态
systemctl --user status mc

# 重新加载 qq_bot 插件
systemctl --user reload mc

客户端使用

使用的是 HMCL 的服务端自动更新整合包，具体信息可参考 HMCL 文档的 服务端自动更新整合包制作教程

整合包使用方式：

HMCL 依次点开 实例列表 > 安装整合包 > 从互联网下载整合包

填入整合包链接：

• 完整整合包（因为包含了大量 voxy 缓存数据，完整整合包大小约为 4GB）

http://<此处插入地址>/modpack/server-manifest.json

• 轻量级整合包（去除了 voxy 和光影包等数据，大小只有几百 MB）

http://<此处插入地址>/modpack-lite/server-manifest.json

确定后即可自动下载导入，实例每次启动之后都会自动更新

贡献

server-manifest.json 中包含了客户端整合包中的所有文件（路径及其 sha1sum）

有相关改动时，用 scripts/update-manifest.py 同步清单（自动刷新 hash / 新增条目 / 删除失效条目，并自动去重排序）：

python3 scripts/update-manifest.py server/config/xxx.json

也可以直接编辑 server-manifest.json 的 files 列表，然后跑 scripts/dedup-manifest.py 确保内容不重复且有序