MC 一键诊断

双击一次，把整合包该查的全查完，最后拿到一张能直接发给其他帮助者的图。

Windows 免安装、不需要管理员权限、不修改你的任何游戏文件。 客户不用选、不用打字、不用填路径 —— 只会双击左键和读一小段话的人也走得下去。

---

它查什么

检查	查出来的是什么
Java 环境	机器上装了哪些 Java、这个整合包该用哪个、内存该给多少（附 Aikar 参数）
模组依赖	缺前置、装重复、jar 损坏、游戏版本对不上
模组安全	mods 里有没有已公开披露的模组后门特征（v1.5 新增，见下）
崩溃日志	游戏为什么崩，把英文报错翻成中文结论（25 条规则，分确定 / 可能 / 提示）
网络环境	网卡、到路由器的延迟丢包、DNS、出口公网 IP、是不是在 CGNAT 后面、IPv6
联机线路	三段链路延迟、游戏端口通不通、路径 MTU、路由追踪（要先填一个联机地址）

前五项全程不问任何东西。最后一项必须先有"联机地址"，所以单独放在第二个入口 联机助手.bat 里 —— 主流程一个字都不问，只在结尾提一句"同目录还有个联机助手"。

模组安全这一项查什么（v1.5）

2026-10 社区曝光了模组后门（Simple-AutoClicker，作者 Sansrus）：开关标记伪装成 ~/.ssh/unknown_hosts，命中特定聊天口令就写入/删除它，还往 log4j 塞过滤器删日志。

现在它会拿公开披露的特征扫 mods 里每一个 class，并看一眼那个标记文件：

命中	判定
jar 里出现 unknown_hosts	确定 —— 正常模组没有任何理由引用这个路径
出现公开的触发哈希 6fd719ce… / 68d64631…	确定
~/.ssh/unknown_hosts 存在且写着 power=true	确定 —— 并直接告诉你怎么删
模组元数据里声明的作者在已知风险名单里	提示（重名/冒用都可能，不替你定性）

嵌在 META-INF/jars/、jarjar/ 里的子 jar 也一起扫。它只认已知特征： 新变种认不出来，一个特征都没命中时写的是"没有发现已知后门特征"， 不是"这个包很安全"。

怎么用

1. 解压，得到一个「MC一键诊断」文件夹（不要在压缩包里直接双击）
2. 把这个文件夹整个放进你要检查的整合包文件夹里 （启动器 versions\ 下面那个、里面有一个 mods 文件夹的）
3. 进到整合包文件夹里，双击 MC一键诊断\双击我.bat，等它跑完（四项检查，一般几十秒）
4. 照屏幕上写的三步做：把图片拖进聊天窗口 → Ctrl+V 粘贴文字 → 发送
5. 联机有问题的时候，双击 联机助手.bat，按菜单选： 1 我的联机地址通不通 / 2 我该用哪种联机方式

为什么要放进去：一台机器上通常有好几个整合包。工具放在整合包文件夹里， 它从自己所在目录往上找一层就命中，不会认错包；放在桌面或下载文件夹， 就只能靠"挑最近改过的那个"，那只是兜底。

也可以不搬：把整合包文件夹直接拖到 双击我.bat 上，效果一样。

跑完程序会自动做三件事：把摘要放进剪贴板 → 打开文件夹并选中卡片图 → 在窗口里用大字写「第 1 步 / 第 2 步 / 第 3 步」。

产出

文件	是什么
发给帮助者.png	780 px 宽的卡片图，按严重程度红 / 黄 / 灰分级，拖进聊天窗口就能发
发给帮助者.txt	聊天版摘要，同时自动进剪贴板
诊断报告.txt	完整报告，客户留着备查

联机助手产出的是另外几个名字：联机发给帮助者.png / 联机发给帮助者.txt / 联机检测报告.txt / 联机方案.txt。

只有 TXT 和 PNG 两种形态，是因为闲鱼这类聊天窗口发不了文件，只能发图片和文字。 PDF 因此被砍掉了 —— 客户发不回来，等于白做。

运行条件

系统	Windows 10 / 11
软件	不需要额外安装，PowerShell 是系统自带的
权限	普通用户即可，不需要管理员权限
网络	检查"网络环境"那一步会联网（问一次出口 IP）；填了联机地址之后才会去测那条线路
启动方式	双击 .bat，不要直接双击 .ps1（会被执行策略拦住）

程序主体是一个 C# 编译的 dll，客户双击的是 .bat —— 所以不会弹 SmartScreen 蓝框， 也不需要装 .NET SDK。

隐私

• 只读：不修改、不移动、不删除你的任何游戏文件，也不读存档。
• 不上传任何文件。联网只做两件事：查一次"我出去的公网地址是什么"， 以及你主动填了联机地址之后测那条线路。
• 图片和报告里只写整合包的名字，不写路径；报告里出现用户目录的地方会被换成 …， Windows 用户名不会跟着图片发出去。

常见问题

杀毒软件报警？ 误报。这个工具的主体是 C# 编译的库文件（.dll），客户端双击的是 .bat， 源码在 GitHub 上公开，可以自己看。

双击了没反应 / 一闪就没了？ 先确认是从解压出来的文件夹里双击的（不能在压缩包里直接双击）。 另外这个工具要放进整合包文件夹里才能找到整合包，放桌面上双击会提示找不到。 正常应该停在「按回车键关闭这个窗口」。

会不会偷我的东西？ 不会。它只读日志和 mods 文件夹，不上传任何东西。

为什么图里看不到我电脑的路径？ 故意不写的 —— 交给帮助者也没用，还可能把你的 Windows 用户名带出去。

联机助手要我填地址，我不知道填什么？ 填你在游戏里「多人游戏 → 直接连接」用的那个地址，找房主要。 实在不知道就直接回车跳过，它会告诉你没法测。

更新日志

v1.8（2026-10-13）

• 新增检查存档（主流程第 5 步）：直接读世界存档（不启动游戏），报世界名、存档版本、 区块数、体积、上次游玩时间
• 顺带查两件真会出事、平时又想不到的：某个存档文件夹缺 level.dat（复制存档只复制了一半）； 存档比当前游戏版本新 —— 低版本游戏打开高版本存档，轻则方块消失、重则崩在加载阶段， 而且崩过一次之后存档可能就修不回来了
• 新增第三个入口 存档助手.bat（要填坐标 / 键名的那几项，和联机助手一样不进主流程）： ① 看某个坐标上的方块实体 NBT（箱子里的东西、模组机器存的数值） ② 在存档里搜一个键名（例如 mana、BotLinkMana） ③ 列出某个玩家的背包与物品数据。全程只读，不改存档
• 存档读取兼容 1.7.10 ～ 1.21：区块内部结构按 DataVersion 自动判定 （1.7.10~1.8 没有这个字段；1.13~1.17 有 Level 包装；1.18 起方块实体改叫 block_entities、 实体挪进 entities\ 目录）；poi\*.mca 的结构完全不同，一律跳过
• 主流程从五步变六步
• 回归靶子新增四个合成存档（1.7.10 / 1.13 / 1.16.5 / 1.18）+ 三个真实存档（1.16.5 / 1.20.1 / 1.21.1）

v1.7（2026-10-12）

• 修好认不出游戏版本：1.7.10 ～ 1.12.2 的版本行只写在 fml-client-latest.log 里， 以前只读 latest.log，这类整合包一律报「没认出游戏版本，Java 只能按通用标准看」
• 修好读不到启动器版本清单：PCL / HMCL 的隔离实例把清单命名为「实例文件夹名.json」 而不是 version.json，而且里面的 id 常常是实例名；以前一看不是版本号就直接放弃， 现在会从 clientVersion / assets / assetIndex / Forge 库坐标里同时取版本和加载器
• 补上从 mods 里的模组元数据反推版本：刚下好、还没启动过、既没有日志也没有 版本清单的整合包现在也能认出来（抽样读模组元数据，至少两个模组互证才采纳）
• 加载器识别补上 1.20.1 之后的 fmlloader 坐标，Forge / NeoForge 版本号不再留空
• 本机 versions 下 11 个实例全部回归通过；改之前有 4 个识别不正确

v1.6（2026-10-11）

• 产出文件名和界面文案统一成「发给帮助者」 —— 发给帮助者.png / 发给帮助者.txt，联机那套是 联机发给帮助者.png / 联机发给帮助者.txt
• 打包脚本加了一条自检：分发包里的措辞不合规就直接拒绝打包

v1.5（2026-10-11）

• 新增检查模组安全：拿公开披露的特征扫 mods 里每一个 class （unknown_hosts 开关文件名、两个触发哈希），嵌在子 jar 里的也扫； 并检查用户目录下那个伪装成 SSH 的开关文件 ~/.ssh/unknown_hosts
• 只认已知特征，命中即报"确定"并直接给处理办法；没命中时只写"没有发现已知后门特征"
• 元数据里声明的作者在已知风险名单里时，只报"提示"，措辞里写明不替人定性

v1.4（2026-10-11）

• 用法改成：把「MC一键诊断」文件夹整个放进整合包文件夹里再双击 —— 机器上有好几个整合包时，这样才不会认错包
• 程序里"没找到整合包"那一屏同步改成上面的做法（拖拽那条路保留成备选）

v1.3（2026-10-11）

• 新增联机助手（第二个入口）：三段链路测量、游戏端口连通、路径 MTU、路由追踪
• 新增联机方案建议：回答三个问题，给出该用哪种联机方式
• 原有四项全自动检查客户依然什么都不用填

v1.2（日期忘了）

• 卡片上写清到底缺哪个模组（原来只有一句泛泛的"缺少前置模组"）
• 同一件事不再在卡片上报两遍

v1.1（日期忘了）

• 新增网络环境评估：网卡、到路由器的延迟丢包、DNS、出口公网 IP、CGNAT、IPv6

v1.0（日期忘了）

• 首发：Java 环境、模组依赖、崩溃日志三项检查 + PNG 卡片 + 傻瓜化引导

许可证与版权

本项目采用 CC BY-NC-ND 4.0（署名 — 非商业性使用 — 禁止演绎 4.0 国际）：

• ✅ 可以原样转发这个压缩包，但必须注明作者和来源 GitHub https://github.com/beihongliangchu/mctools）
• ❌ 不得用于任何形式的盈利活动，包括打包售卖、付费代装、 随付费服务搭售、放入付费资源包或会员专享内容中分发
• ❌ 不得发布修改后的版本

该工具为免费发放，严禁二次打包售卖。

工具本身给出的全部是排查建议，不是保证。判断依据是模组元数据、崩溃日志和网络测量结果， 具体情况请以实际测试为准。使用本工具产生的任何后果由使用者自行承担。