服务端起不来
模组加载到一半抛错，服务端进程直接退出。日志里只有一行看不懂的异常，你得靠二分法一个个停用模组，才能找到是哪一个。
开源 · GPL-3.0 · Windows 10+
升级服务端之前，先查清楚模组支不支持
给 Minecraft 服主用：modcheck 读你的 mods 文件夹，把每个模组拿到 Modrinth 上逐个查证（CurseForge 需自备 API Key），然后告诉你哪些能直接用、哪些要退回去用旧稳定版、哪些必须先解决。查不到就写「未判定」，它不会替你猜。
零第三方依赖 · 绿色便携 · 不修改你的 mods 文件夹
| 模组 | 判定 | 当前版本 → 目标版本可用 | 发布日期 |
|---|
打开完整检查页
示例数据 · 30 个模组中显示前 8 行
为什么需要它
升级本身不难，难的是升级完才发现出事
改一行版本号、重启服务端，本来十分钟的事。真正耗时间的是之后：某个模组没跟上新版本，轻则它自己悄悄失效，重则服务端根本起不来。而这时你已经在日志里翻了半小时。
起来了，但功能悄悄失效
有些模组不会让服务端崩，只是不再生效。等到玩家反馈「领地怎么没了」，存档已经跑了几十个小时，你也不知道从哪一天开始不对劲。
一个个翻发布页太慢
打开每个模组的发布页、翻版本列表、对游戏版本号、对加载器、判断是正式版还是测试版——30 个模组就是一晚上。而这件事每次升级都要重做一遍。
判定规则
六种状态，每一种都告诉你下一步做什么
真实情况很少是「支持」或「不支持」两档。模组常常是「只有测试版支持」「最新版反而不能用」。modcheck 把这些情况分开说清楚，而不是压成一个模糊的结论。
未判定 ≠ 失败
查不到某个模组在目标版本上的发布记录时，modcheck 不会从旧版本里挑一个看起来差不多的填上，也不会默认它「应该没问题」。它会如实写「未判定」，然后在总结里单独列出来，让你自己决定要不要手动查一下。
因为猜错一个版本的代价，是你在凌晨两点对着起不来的服务端翻日志。所以它宁可承认自己没查到。
它是怎么工作的
三步查清楚，第四步直接下
没有账号、没有云端同步、没有「智能推荐」。它做的事情你可以自己手动做完，只是要花一晚上。
-
读你的 mods 文件夹
扫描目录里的模组文件，认出每个模组是什么、你现在装的是哪个版本、面向哪个加载器。只读，不写。
-
联网逐个查证
拿每个模组去 Modrinth 上查：它在目标游戏版本、目标加载器下到底有哪些发布。目标版本的正式名称来自 Mojang 官方版本清单。
-
给出结论与建议
每个模组落到六种状态之一，各配一句「该做什么」；最后给一个整体结论：现在到底能不能升级。
-
把建议的版本替你下回来
这一步是可选的，但省下的时间最多：它只取 就绪 与 需注意 里建议你用的那个版本，跳过测试版和快照版，直接从 Modrinth 官方 CDN 下载到你指定的文件夹 —— 不动你的 mods 文件夹。
两个版本
CLI 还是 GUI
两个版本查的是同一批数据、给的是同一套六态判定。区别只在你怎么用它。
命令行版（CLI）
解压成一个免安装目录，双击启动脚本就能跑。没有界面，输出直接进终端。
- 体积约 24 MB
- 依赖零第三方依赖
- 形态免安装目录
- 适合写脚本、进 CI、远程服务器（需自备 Python）
图形界面版（GUI）
解压即用，双击打开。六态结果在一张表里，可以直接筛选、逐行看详情。
- 体积约 28 MB
- 依赖已打包，无需另装
- 形态解压即用
- 适合第一次用、想看清楚每一项
它不做什么
边界写在这里，省得你试
一个检查工具最该说清楚的，恰恰是它不会替你做的那些事。下面五条都是真的——不是谦虚，是设计选择。
-
不修改你的 mods 文件夹。它只读取，不移动、不重命名、不删除任何文件。
-
不自动替换或安装模组。它能把建议版本下载到你指定的文件夹，但不会去动你的 mods 目录。
-
不重新分发、也不代你安装。它可以按你的指令从 Modrinth 官方 CDN 下载建议版本，文件不经过我们托管；装不装、什么时候换，始终由你决定。
-
不做快照版本检查。快照（Snapshot）的兼容性变化太快，结论隔天就过期，所以它只对正式版负责。
-
不做依赖递归解析。它检查你 mods 文件夹里实际存在的模组，不会顺着依赖关系往下自动补全——那样得出的结论你没法核对。
三分钟上手
五步，第一次就能跑通
不用注册、不用配置环境变量、不用改服务端设置。整个过程里 modcheck 只做一件事：读。
-
下载并解压
CLI 版和 GUI 版都是解压即用，两个都不用安装，也不用装 Python。
-
指向你的 mods 文件夹
告诉 modcheck 你的 mods 文件夹在哪。它只读这个目录，改动不了任何东西。
-
选择目标版本与加载器
比如 26.3 + Fabric。版本号取自 Mojang 官方版本清单，不会让你手填一个不存在的版本。
-
等它查完
它会逐个模组去 Modrinth 查证。模组越多，时间越长。
-
按状态处理
阻塞的先解决，仅存测试版的自己权衡，未判定的稍后重跑。全部处理完再动手升级。
先查一遍，再决定要不要升级
两个版本查的是同一批数据。选哪个都不会少查一个模组，也不会多给你一个假的「就绪」。
GPL-3.0 · 绿色便携 · 配置存在程序同级的 config 目录