一个简单的 Minecraft Fabric Mod 版本适配检测工具。读取本地 Mod 文件,在 Modrinth 上查询每一个 Mod 是否已支持目标 MC 游戏版本,最后生成汇总报告。
- 安装 Python 3.10 或以上版本,或者安装 uv
- 能正常访问 Modrinth 的网络
- 将待检测的服务端、客户端的 Mod Jar 文件放到项目目录
mods文件夹下 - 双击
运行.bat运行 - 按提示输入要检查的目标 Minecraft 版本,例如
1.20.1或26.2.1 - 开始检测
检测结果报告会保存到 最新适配状况.md,包括已适配、尚未适配、未确认 Modrinth 项目和检查失败的模组列表
注意”未适配“不代表此Mod完全无法执行,只是在Modrinth上未发布对应版本的Jar。可能的例外情况:
- 项目只发布在CurseForge
- 项目只发布在GitHub仓库
- 项目未明确发布适配版本的jar,但是旧版模组恰好适配新版游戏,无需修改代码
- 项目确实还没有适配,但是GitHub仓库的issue或者PR中已经有社区贡献者贡献了适配版本
- ......
建议前往CurseForge以及项目GitHub仓库以进一步确认
也可以用命令行调用并指定版本和 Mod 目录,跳过交互
python check_mods.py --game-version 26.2.1 --mods-dir "D:/Minecraft/mods"更多参数查看 python check_mods.py --help。