Blame (Fabric)

作者：TelepathicGrunt

该死的崩溃日志，根本不说到底是哪个世界生成特性导致崩溃！

模组 Fabric 服务器工具

截图

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

准备好找出该怪谁了吗？

Forge 版本：https://www.curseforge.com/minecraft/mc-mods/blame

Blame 是一款诊断工具，只有在你遇到奇怪的地图生成崩溃，或命令出错却没有任何堆栈跟踪时才需要启用。启用 Blame 后，它会尝试收集更多信息，并将堆栈跟踪输出到 mods 文件夹上一级的 logs 文件夹中的 latest.log 文件里。那里更方便查看你需要的所有信息！请注意，Blame 仅适用于单人游戏或服务器，不适用于连接到服务器的客户端。

注意：如果想在 1.17+ 中更好地解析地图生成 JSON，请改用 Cyanide 模组： https://www.curseforge.com/minecraft/mc-mods/cyanide-fabric

以下是 Blame 目前提供的功能列表！

• 输出执行时崩溃的命令的堆栈跟踪。

（通常，模组命令崩溃时不会在日志中输出任何内容。）

• 在启动地图时检测并输出所有出错的命令。

（它会找出在 .then() 调用之外调用了 .executes() 的命令，因为这些命令无法正常工作。）

• 为地图生成过程中崩溃的特征或结构输出额外的详细信息。

• 记录所有未注册的 ConfiguredFeatures、ConfiguredStructures 和 ConfiguredCarvers。

（未注册这些内容的模组可能导致其他模组的内容出错，无法在地图生成时生成。）

• 检测 DynamicRegistry 是否被其他模组过早加载。

（这会导致其他模组注册的地图生成内容全部出错，例如出现“Unknown Biome ID”问题。）

• 记录具体是哪个模组或数据包中的地图生成 JSON 文件出错，并显示其 JSON 内容。

• 在尝试生成战利品时，记录所有缺失的战利品表！如果箱子是空的，可以查看日志，Blame 也许能帮你找到原因。

• 精简出错的配方和战利品表解析日志，方便分享日志并查看错误。

• 修复 MC-190122 错误，确保日志中显示的已加载配方实际数量正确，便于排查配方问题。 https://bugs.mojang.com/browse/MC-190122

• 输出崩溃结构的名称：当其间距值设为 0，或分离值大于或等于间距值时。

（上述任一条件成立都会导致游戏崩溃。）

• 如果自定义/平坦 ChunkGenerator 因结构未添加到 FlatGenerationSettings.STRUCTURES 而崩溃，将准确输出导致崩溃的结构。

• 如果拼图结构尝试访问不存在的模板池，会在日志中输出提示，方便你发现结构未能完整生成的情况。

• 如果模组或数据包尝试访问不存在的 nbt 文件，会在日志中记录，便于排查问题。

• 如果结构处理器在生成结构时崩溃，会输出导致崩溃的方块及其 nbt。

面向模组作者：在 Fabric 开发环境中使用 Blame

在 build.gradle 文件中添加此 Maven 仓库。Gradle 会从这里查找 Blame 的 jar 文件。
repositories {
maven {
url “https://nexus.resourcefulbees.com/repository/maven-public/“
}
}

然后将以下内容添加到依赖项代码块中。将 <version> 替换为你想使用的 Blame 版本，例如 `1.16.5-3.2.0-fabric`。请查看 CurseForge 页面了解最新版本。
dependencies {
…
modImplementation “com.telepathicgrunt:Blame-Fabric:1.16.5-3.0.1-fabric”
}