Skip to content
托管 · 故障排查

模组无法加载

什么会阻止模组在服务器上启动:模组端、加载器版本、依赖项,以及 mixin 冲突。

更新于 2026年8月13日

检查

  1. 模组端。 客户端模组放在服务器上要么毫无作用,要么会导致启动崩溃——客户端模组与服务端模组。
  2. 加载器。 为 Forge 构建的模组无法在 Fabric 上运行,反之亦然;Forge 与 NeoForge 同样互不兼容——NeoForge。
  3. 游戏版本。 适用于 1.20.1 的模组无法在 1.21 的整合包中运行。
  4. 加载器版本。 Forge 和 NeoForge 需要特定的构建版本——核心与版本。
  5. 依赖项。 Fabric API,以及 Architectury、Cloth Config 等库——缺少依赖。
  6. Mixin 冲突,与其他模组发生冲突——Mixin 应用失败。

日志中的内容

行含义
Incompatible mod set模组列表与客户端不匹配——详细解析
Missing or unsupported mandatory dependencies缺少依赖
LoadingFailedExceptionForge 的一般性故障,附带原因列表——详细解析
Mixin apply failed冲突

找出罪魁祸首

将 mods 文件夹对半拆分——模组冲突。移除模组时,也要一并移除它的库文件。

模组已加载但不工作

检查它在 config 和 defaultconfigs 中的配置:有些功能默认是关闭的。另外请记住,服务端模组不会产生视觉效果——这些效果由玩家机器上的客户端处理。

Minecraft 托管您离线时服务器仍在运行创建服务器