命令行免安装版
体积最小modcheck--cli-standalone.zip
- 体积
- 约 18 MB，解压后是一个免安装目录
- 依赖
- 零第三方依赖，只用标准库
- 适合谁
- 想写脚本、要进 CI、在意体积；服务器上不方便装图形环境的时候
- 怎么启动
- 解压后双击
启动CLI.cmd - 卸载
- 删掉文件夹就算卸载
免安装、绿色便携。配置和清单都在它自己旁边的 config 目录里。
下载
下载 modcheck
升级服务端之前，先用它把模组查一遍 —— 别等开不了服才发现。
追求极致轻量化选命令行版；普通用户选图形界面版。两个版本读同一份配置、同一份清单，随时可以换着用。
下面两张卡里，命令行免安装版标了「体积最小」——那说的是体积，不是「最适合你」。它在服务器上、在脚本里最省事；如果你是第一次用，图形界面版更直观。
选择
下载选择
两个跑的都是同一份判定逻辑。差别只在体积和你怎么操作它。
模组下载
它不只是告诉你，还能替你下
查完之后，把「建议使用」的那些版本一次性取回来 —— 不用你再去一个个翻模组的发布页。
这正是升级前的准备工作里最费时间的一段
一个 30 个模组的服，手动下载意味着打开 30 个发布页、分辨正式版还是测试版、确认加载器和游戏版本对不对得上、还要躲开那些「看起来最新其实不能用」的版本。modcheck 在检查时已经把这些都判断完了 —— 下载只是把结论落地。
怎么触发
- 图形界面版：检查完成后，点底部的「下载建议版本…」。还没检查过就点，它会提示你先跑一次检查 —— 它不会凭空猜。
- 命令行版：在检查完之后，主菜单里选「下载建议版本」。
- 只下载 就绪 与 需注意 两类里「建议你使用」的那一个版本。仅存测试版 一律跳过，阻塞 没有可下的东西。
它替你省掉的判断
- 只取主文件：拿 Modrinth 标记为 primary 的那个
.jar；源码包、文档包不下载（有几个模组带附加文件，它会在汇总里告诉你）。 - 不会给你测试版：快照版不下、alpha/beta 不下。想连测试版一起算，得你自己在检查时打开
--pre。 - 走官方直链：文件来自 Modrinth 官方 CDN，本项目不重新分发任何模组文件。
它不会动你的 mods 文件夹
下载需要你点那一下，而且只往你自己指定的文件夹里写。新版本会落在一个单独的地方，换不换、什么时候换，仍然是你的事 —— 这也是它默认不覆盖同名文件、遇到重名先问你的原因。
环境
系统要求
打包产物开箱即用，不需要先装运行环境。
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 及以上；Linux |
| Python | 打包产物不需要。只有从源码运行时才需要 Python 3.11+ |
| 图形界面版额外要求 | 无 —— PyQt6 已经打包进产物 |
| 磁盘占用 | 命令行版约 18 MB；图形界面版解压后约 70 MB |
| 网络 | 需要。识别和判定要查询 Modrinth、CurseForge 和 Mojang 官方版本清单 |
| 权限 | 只需要读你的 mods 文件夹 —— 不写入、不修改、不删除 |
安全
校验与安全
- 只从本项目的 Releases 页面下载。官网不提供任何网盘镜像，也没有第三方安装器；在别处看到的 modcheck 安装包不是我们放的。
- 本工具不重新分发模组文件。它只查询版本信息。模组本体请从 Modrinth 官方 CDN 直链或你原来的来源获取。
- 版本号写在文件名里。下载前对一眼文件名，能挡掉大部分拿错版本的情况。
边界
已知限制
先说清楚，省得你在用到一半的时候才发现。
- 需要联网。判定要查询 Modrinth 公开 API、CurseForge 和 Mojang 官方版本清单。
- 离线时只能靠 jar 内信息识别。能读出文件名和 jar 里的元数据，但拿不到平台上「哪个模组版本支持哪个游戏版本」的对应关系，所以绝大多数条目会停在「未判定」。
- 不做快照版本检查。判定只针对正式版。
- 不做依赖递归解析。清单里有什么就查什么，不会顺着前置一层层往下查。
- 平台没收录的模组只能报「未判定」。它不会替你猜一个版本填上去。