Toolbox 版本和 Minecraft 怎么配对，失灵闪退先看这里
本篇解释 Toolbox 版本号与 Minecraft 版本之间的配套关系，以及两边不配平时的典型症状。相关文档：装完没有M按钮的原因.md · M菜单功能有哪些.md
版本号是跟着游戏走的
Toolbox 的版本号形如 5.4.x，每一版对应一段 Minecraft 基岩版的适配区间——功能层要直接对上游戏的内核，游戏一升级，旧的挂钩就可能对不上号。举个可查的例子：5.4.57 那一版的更新说明写的就是「1.20.80 support」。所以两边的关系不是「越新越好」，而是「配平就行」。
不配平时的典型症状
- 功能失灵：发放物品点下去没反应，X-Ray 开了没效果；
- 进世界闪退，或菜单弹出一半崩掉；
- 提示本体缺失，但本体明明装着——这是功能层认不出新版内核的另一种表现。
怎么处理
- 看游戏当前版本（主界面或设置里可查）；
- 确认 Toolbox 的版本号，判断它适配的是不是这个区间；
- 游戏刚升而功能层没跟上时，等对应适配版本发布再更新功能层，不要反复重装旧版；
- 反过来，游戏长期没动、Toolbox 却升了好几级导致闪退的，把功能层退回与游戏同期的那一版。
一个省心的习惯
游戏升大版本之前，先把当前存档备份；升级后先别急着开功能层，确认两边版本配平、进单人世界验证 M 按钮正常，再继续玩。
安装包版本与本体适配的图文说明，整理在 Toolbox 介绍站 的「版本配套」一节；装完看不到按钮的排查顺序见 装完没有M按钮的原因.md。