如何更新 Minecraft 服务器

更新之前

• 检查插件或模组。到每个插件或模组的下载页查看是否已支持新的 Minecraft 版本。只要缺一个插件，就可能导致服务器无法启动，或某个功能失效。
• 检查服务端软件。Minecraft 新版本发布后，Paper、Fabric 和 NeoForge 往往需要几天甚至几周才会推出稳定构建。
• 阅读更新日志，留意会影响玩家的变化：新的世界生成、被移除的功能、改动的命令。
• 选一个人少的时间，并提前告诉玩家服务器会停机几分钟。

不必着急。在你更新之前，玩家可以在 Minecraft Launcher 的 Installations 中选择与服务器相同的版本继续加入。

第 1 步：备份所有内容

更新是一条单行道。世界一旦在新版本中打开，就会被转换为新格式，旧版本可能拒绝加载它，甚至将其损坏。PaperMC 在每次版本发布公告中都明确指出：备份是必须的，世界升级后就无法降级。

至少备份以下内容：

• 世界文件夹 world，如果服务器把下界和末地存放在单独的文件夹中，还要备份 world_nether 和 world_the_end；
• plugins 或 mods 文件夹及其配置；
• server.properties、白名单、管理员（ops）和封禁列表。

先停止服务器，确保世界完整保存，然后再备份。在托管服务器上，请使用面板的备份功能，为保险起见再下载一份副本。

第 2a 步：更新 Vanilla 服务器

1. 停止服务器。
2. 从官方 Minecraft 服务端下载页面下载新的 server.jar。
3. 用它替换旧的 jar，并保持启动命令所用的文件名不变。
4. 检查 Java 版本：Minecraft 26.x 需要 Java 25，1.21 需要 Java 21。
5. 启动服务器并观察控制台，直到出现 Done。

第 2b 步：更新 Paper 服务器

Paper 按通道发布构建。对于新的 Minecraft 版本，最初的构建是 beta（实验性），下载页面会把它们隐藏在一个开关后面。例如目前，Paper 的稳定构建对应 26.2，而 26.3 仍处于 beta 阶段。只在服务器副本上运行 beta 构建，或者在有了最新备份之后再运行。

1. 先更新插件：下载适配新 Minecraft 版本的插件，放入 plugins/update/。Paper 会在下次启动时替换它们。
2. 停止服务器，然后用新构建替换 Paper jar。切勿在服务器运行时替换 jar。
3. 启动并查看日志。某个插件报错通常意味着它还没有适配此版本：移除它或者等待更新。

在同一个 Minecraft 版本内也要保持 Paper 为最新：新构建会带来修复，Paper 建议至少每周更新一次。插件的安装方法见如何安装 Minecraft 插件。

第 2c 步：更新模组服务器

模组服务器最难更新，因为每个模组都必须有对应新版本的版本：

• Fabric：更新加载器和每一个模组，包括 Fabric API。为某个 Minecraft 版本制作的模组，在下一个版本上往往无法加载。
• NeoForge 和 Forge：加载器版本与 Minecraft 版本绑定，因此新的 Minecraft 版本意味着新的加载器以及所有模组的新版本。
• 整合包：等待整合包作者发布更新，并使用他们新的服务端文件。不要混用两个整合包版本的模组。

玩家必须把客户端模组更新到相同版本，否则无法加入。如果整合包里某个重要模组还没更新，就继续使用当前版本；很多模组服务器会直接跳过某些 Minecraft 版本。更多内容见如何搭建模组 Minecraft 服务器。

在 HytHost 上点几下即可更新

在 HytHost Minecraft 主机上，面板的 Version 选项卡可以为你安装任意服务端软件和 Minecraft 版本，并自动设置匹配的 Java 版本。

1. 在 Backups 选项卡中创建备份。Version 选项卡不会替你备份。
2. 从控制台停止服务器，让世界保存。安装程序会立即关闭服务器，尚未保存的内容都会丢失。
3. 打开 Version，选择软件（Paper、Vanilla、Fabric、NeoForge 等）、Minecraft 版本和构建。构建会标注为 stable 或 beta；快照版本默认隐藏，除非你手动开启。
4. 保持 Wipe Server Files 关闭。关闭时只会替换服务端软件；你的世界、插件、模组和设置都保持原样。
5. 安装，启动服务器并观察控制台。

插件和模组不会自动更新：请按上文所述，换成适配新版本的版本。

出了问题：不要降级

如果新版本出了问题，不要直接把旧版本安装到已更新的世界上。Minecraft 不支持将世界降级，游戏本身也会警告这样做可能损坏世界。服务器面板也不会阻止你这样做。

正确的做法是恢复更新前做的备份，并同时安装旧版服务端。这正是要先备份的原因。

另外，除非有明确的理由，否则不要使用 --forceUpgrade 启动参数。它会一次性转换所有区块，之后世界就无法在旧版本中打开了。通常 Minecraft 会在玩家访问区块时逐步升级它们，这就足够了。