🕳 启动卡死排查

由于绝大多数模组托管在海外平台,部分模组作者会在代码中加入启动时的联网版本检查。受跨境网络环境影响,国内服务器请求海外更新接口时往往会出现高延迟或连接超时,从而导致服务端在启动阶段停滞不前。

若服务器启动时长时间卡住,且控制台最后几行日志中包含 check、update 等字样,请按对应游戏版本修改 Forge 配置文件以关闭版本检查,随后重启服务器:

  • Minecraft 1.13 及以上版本:
    进入面板 config 文件夹,打开 Forge 配置文件 fml.toml,将:

    versionCheck = true

    修改为:

    versionCheck = false
  • Minecraft 1.12.2 及以下版本:
    进入面板 config 文件夹,打开 forge.cfg,将 disableVersionCheck= 与 Global= 后方的 false 均修改为 true。

进阶处理方案

若完成上述修改后启动依然卡住,通常是由于个别模组内置了独立的强制联网请求(例如 Quark 模组在启动时拉取赞助者名单),或正在加载大体量数据。您可以采取以下措施:

  1. 安装屏蔽更新检查组件:强烈推荐在服务端安装我们专门开发的出站连接屏蔽组件,详见 ★ 模组更新检查卡死解决方案。
  2. 超时重开:若未安装屏蔽组件,只能耐心等待其超时跳过;若启动耗时超过 20 分钟仍未完成,请点击控制台的“停止”强制关闭服务器,再重新开机尝试。

注意:修改 Forge 原生配置仅对遵循标准接口的模组生效;部分模组需在其独立配置文件中关闭检查,甚至完全未提供关闭选项。


🕳 关服卡死处理

部分预置整合包在执行关服操作时,可能会长时间停留在 stopping... 状态(多见于 Minecraft 1.18 及以上版本,通常与高版本 Forge 兼容引导脚本的进程回收机制有关)。

遇到此类情况时,请先观察控制台日志,待屏幕输出以下数据保存完毕的提示后,再点击“强制关闭”按钮:

  • Saving chunks for level
  • Saving players
  • Saving worlds

重要警告:在控制台尚未出现上述保存提示前,切勿直接点击强制关闭,否则极易导致地图区块回档或玩家背包数据丢失!

作者:Azitate  创建时间:2023-09-02 08:28
最后编辑:admin  更新时间:2026-11-14 18:55