modcheck
GitHub
中 EN

兼容性检查

升级之前，先看清哪个模组会拦住你

modcheck 会把你清单里的每个模组归到六种状态之一，并告诉你下一步该做什么。它不猜——查不到就写「未判定」。

看一遍演示 下载 modcheck

CLI 版约 18 MB · 零第三方依赖 · GPL-3.0

六种状态

六种状态，六种下一步

每个模组只会落在下面六种状态之一。没有第七种，也不会出现「大概能用」这种说法。

  • 就绪

    目标版本上有可用版本

    该做什么不用管

  • 需注意

    最新正式版不支持，但有更早的稳定版可用

    该做什么用那个旧稳定版，别下最新版

  • 仅存测试版

    只有 alpha/beta 支持目标版本

    该做什么自行评估风险，建议先备份存档

  • 阻塞

    目标版本上没有任何可用版本

    该做什么必须先解决，否则无法升级

  • 未判定

    没查到（不算失败）

    该做什么可稍后重跑；必要时手动指定平台项目

  • 已忽略

    你主动标记为不参与检查

    该做什么不参与判定

处理顺序：能直接处理的先做，要冒险的最后决定

  1. 可以直接处理

    就绪 的什么都不用做；需注意 的换成那个更早的稳定版就行。这两种不需要你判断。

  2. 需要你自己拍板

    仅存测试版 要不要冒这个险由你决定；未判定 的重跑一次，或者手动指定它的平台项目再查。

  3. 必须先解决

    阻塞 只要还剩一个，就别升级。等模组作者更新，或者先把它换掉。

它不会猜

未判定不是失败

查不到就写「未判定」——它不会为了让你看到一张填满的表，随便挑一个版本塞进去。

它不会从几十个历史版本里挑一个最像的填进「就绪」。那样填出来的就绪是假的：你照着它升级，服务器会在启动时直接崩掉，而你还以为万事俱备。

「未判定」只说明这一次没查到——平台的接口超时了、这个模组没有登记到 Modrinth 或 CurseForge、或者它登记的英文名和你本地文件对不上。你可以稍后重跑，也可以在配置里手动指定它的平台项目，让它下次能被认出来。

一个错误的「就绪」，比一个诚实的「未判定」危险得多。

可交互演示

点一下，看它给出什么结论

下面这个窗口是用 HTML 重画的，不是截图——所以它能点、能 Tab、能读屏。里面的数据是示例数据。

modcheck — 检查结果 示例数据
清单 服务器A
目标版本 26.3
加载器 Fabric

还没开始。点上面的「开始检查」，看它怎么跑。

点上面的「开始检查」，判定结果会一行一行出现在这里。

点上面任意一行，这里会告诉你它建议你怎么做。

等待开始

判定来自 Modrinth、CurseForge 和 Mojang 官方版本清单。清单、目标版本、加载器三项在演示里是固定的示例值；底部三个按钮按下去会说明真实客户端里会发生什么。

看演示时

注意这三件事

  1. 未判定：它没有假装知道

    把上面那个窗口切到「未判定」页签看看。这份示例数据里一个都没有；真实检查里出现未判定，意思是这一次没查到，而不是这个模组坏了。

  2. 需注意：别下最新版

    它的意思是「最新正式版不支持目标版本，但有一个更早的稳定版可用」。照着它给的那个版本下，就不会踩空。

  3. 点一行，看具体建议

    每一条状态后面都跟着「接下来做什么」——不用你自己去翻更新日志猜。用键盘也行：Tab 到表格里，上下键换行，回车选中。

演示用的是示例数据，你自己的服务器不是

把 modcheck 下下来，用它查你自己的清单。它只告诉你结论和该做什么——不会改你的 mods 文件夹，不会替你下载或替换模组文件，也不会替你决定要不要用测试版。

下载 modcheck 三分钟上手

CLI 版约 18 MB，免安装 · GUI 版约 70 MB，解压即用 · 配置存在程序同级的 config 目录