故障排除 — 指南

关于命令、数据包、建筑和服务器性能的实用指南，也讲解数据包、资源包和整合包无法加载时如何找出原因，以及常见物品的合成方法。每篇文章都配有可直接完成任务的工具，读完就能在浏览器里动手操作，无需安装任何软件。

大多数被拒绝导入的 .mcaddon 其实是一个有效的 zip，只是有一行头部信息写错了，而错误提示从来不会指出到底是哪个字段出了问题，常见原因还包括头部与模块 UUID 重复，以及压缩包里多套了一层文件夹。

把 .mrpack 重命名为 .zip 后，你得到的只是一个 manifest 和一个 overrides 文件夹，而不是模组——jar 文件存放在 Modrinth 的 CDN 上，通过哈希值获取。

那个数字什么都说明不了。它上面那一行才说明一切，而那一行早就躺在你的日志文件夹里了，举例来说，退出代码 137 通常并不是崩溃，而是操作系统因为内存不足才强行终止了这个进程，并不是程序本身出了什么问题。

Minecraft 内置了 454 条闪烁标语。其中恰好有一条出现了两次，而且正是你会猜到的那个笑话。407 条以感叹号结尾，最短的只有四个字符，最长的有 97 个字符；还有一条在游戏载入列表时就被丢弃，永远不会显示。

极限模式下的死亡不过是 level.dat 里的一个布尔值。本文介绍这个文件里都存了什么、存档损坏是什么样子，以及检查能恢复什么——以及它诚实的极限，游玩规则现在移到了 game_rules.dat 中，不再存在 level.dat 里面。

.mrpack 是一份清单，而不是模组压缩包。解压它只会得到一个 JSON 文件，没有任何 jar。下面说明它内部到底有什么，以及转换器必须做哪些事，转换器必须核对清单里的 sha512 校验值，否则可能混入被篡改或损坏的 jar 文件。

一个字段填错，Minecraft 就会把你的数据包/资源包置灰。这里说明 26.x 要求的格式、如何用一个文件同时兼容新旧版本，以及文件必须放在哪里，资源包和数据包用的是两套不同的编号，26.3 的资源包是 97，数据包则是 121。

一个没有出现在 /datapack list 里的数据包，问题出在路径上，而不是代码上。这里是确切的目录树、命名空间规则，以及那些被改名的文件夹，旧的 functions 文件夹现在改成了单数形式 function，这是常被忽略的改名之一。