崩溃助手

在 Minecraft 崩溃后显示一个图形界面，立即展示所有受影响的游戏/启动器日志、崩溃报告或 hs_err 文件。提供一键式解决方案来上传它们、复制链接并执行其他操作，以便更容易地报告、调试和排除故障。分析日志中许多已知的崩溃原因。提供许多有用的分析工具。如果有独立 GPU 可用但 Minecraft 运行在集成 GPU 上时会发出警告。包含针对许多常见问题的自动修复。

模组仅在客户端。在服务端上不会起任何作用。

如果您有任何疑问，欢迎加入我的 Discord 服务器：https://discord.gg/dV8WFrJZK6

功能：

图形界面：

支持拖放。您可以直接从图形界面将文件移动到任何想要的位置，或通过从“可用日志文件：”标签上拖放来一次性拖放所有日志。

日志分析：

分析日志中许多已知的崩溃原因。如果检测到已知问题，它会显示一个对话框，其中包含问题描述和详细解决方案。

支持的分析：

hs_err (JVM 崩溃)：

• AlLibAlcCleanup (某些与 RAM 分配相关的诡异问题)
• atio6axx.dll (AMD 驱动问题)
• glfw.dll (通用 GPU 驱动问题)
• ig7icd64.dll (旧版 Intel 集成 GPU 驱动问题)
• InsufficientMemory (系统物理 RAM 或交换空间不足)
• JavaTooHigh (例如，Spark 模组在 Java ≥ 22 上崩溃)
• jemalloc.dll (jemalloc 内存分配器问题)
• jvm.dll (潜在的硬件问题或 JVM 本身的错误)
• libglfw.so / libopenal.so (常见的 Linux 库问题)
• libGLProgrammability.dylib (macOS 上不兼容的着色器包)
• ~StubRoutines::SafeFetch32 (在 Apple Silicon 上使用错误的 JDK 运行 macOS)
• nglMultiDrawElementsBaseVertex / 0x0000 (GPU 驱动问题)
• nvoglv64.dll (Nvidia 驱动问题)

log / crash-report：

• ConnectorIncompatibleFabricMods (检测使用 Sinytra Connector 时，如 Sodium/Iris 等不兼容的 Fabric 模组)
• Create6Addons (Create 版本与其附属之间的不兼容问题，提供一键查找所有不兼容模组的方法)
• CtovWithoutLithostitched (ChoiceTheorem's Overhauled Village 模组缺少必需的依赖)
• CurseForgeCorrupted (来自 CurseForge 启动器的 Minecraft/加载器安装损坏)
• DiskSpaceEnded (系统磁盘空间已耗尽)
• DuplicatedMods (安装了同一模组的多个版本)
• EpicFightAddons (Epic Fight 版本与其附属之间的不兼容问题，提供一键查找所有不兼容模组的方法)
• FeatureOrderCycle (世界生成特征的循环依赖)
• FerriteCoreNeighborTable (检测到模组不当访问 FerriteCore 的 neighbor table，提供临时配置解决方法)
• GeckoLibOculusCompat (警告在 Minecraft 1.20.1+ 上不再需要 GeckoLib Oculus Compat 模组，并会导致崩溃)
• GroovyModLoaderIPv6 (GML 因 IPv6 问题下载映射失败，包含自动修复功能，一键修复问题或查找所有依赖 GML 的模组)
• KubeJSDataPack (使用 KubeJS 加载数据包时出错)
• LanguageProviderMismatch (模组需要不同版本的 Forge/NeoForge)
• LegacyTooManyIds (在旧版 Minecraft 如 1.12.2 上超出方块/物品 ID 限制)
• MixinApply (检测由 Mixin 冲突或错误引起的各种崩溃，包括缺失类检测和自动修复功能，以查找依赖缺失类的模组)
• MissingEmbeddiumForOculus (安装了 Oculus 模组但没有其必需的依赖 Embeddium)
• MissingIndium (某个模组需要 Indium 以实现 Fabric 渲染器 API 兼容性，但未安装)
• MissingUnsupportedDependencies (Forge/NeoForge 检测到的通用依赖冲突)
• ModernFixWatchDog (集成服务器死锁)
• NeoForgeVersion1_20_1 (通知用户在 1.20.1 上的 NeoForge 已被废弃并导致许多崩溃，官方推荐在该版本上切换回 Forge)
• ModuleFind / ModuleResolution (Java 模块系统错误，通常由依赖冲突引起，能立即找出是哪个模组导致的问题，无需像以前那样需要二进制搜索来排查)
• Optifine (警告 OptiFine 已知会导致许多不兼容问题，并推荐现代替代品)
• OutOfMemoryError (Minecraft 使用了超出分配的 RAM)
• ResourceLocationException (资源名称包含无效字符，通常由非英文系统设置引起)
• Rubidium (警告 Rubidium 已被废弃并导致问题，推荐 Embeddium)
• ServerConfigCorrupted (服务端配置文件格式错误)
• UnsupportedClassVersion (模组由比当前使用的 Java 更新版本的版本编译)
• UsedByAnotherProcess (文件被另一个程序锁定)
• Version1_21 (警告 Minecraft 1.21 已过时并导致许多问题，建议切换到 1.21.1)

win_event (Windows 事件日志)：

• WasClosedByWindows (游戏卡住并被操作系统终止，通常是由于加载过程中的用户输入)

Codex 日志分析器集成：

• 上传后，每个受支持的日志都会由 mclo.gs 的 Codex 日志分析器进行分析。有时 Codex 的消息对普通用户来说可能不够清晰。在这种情况下，会显示一条包含如何修复的详细指南的信息：
  • 出错的方块/实体

这大大减轻了整合包支持人员的负担，因为很大比例的（超过 75%）问题是常见且容易解决的。如果需要，您可以在配置中禁用任何分析。

分析工具

Crash Assistant 包含一套强大的分析工具，可从 GUI 菜单访问：

• Create/Epic Fight 附属兼容性：扫描您的模组，查找与您安装的 Create 或 Epic Fight 版本不兼容的附属。
• MCreator 模组检测器：列出所有使用 MCreator 工具制作的模组。
• 包/类查找器：搜索所有模组，找出包含特定 Java 类或包的那个。
• Jdeps 依赖分析：识别哪些模组依赖于特定的类或包，帮助调试 NoClassDefFoundError 崩溃。

集成 GPU 检测：

在存在更强大的独立 GPU 可用时，检查游戏是否运行在集成 GPU 上，并显示警告。包含一个一键式 自动修复 按钮，用于配置 Windows 为 Java 启用正确的 GPU。

Intel 芯片错误警告：

检测您的 CPU 是否属于已知存在严重稳定性错误的 Intel 第 13/14 代型号。它会检查您的微码版本，并提供详细的警告和建议。

兼容性：

该模组旨在实现最大的兼容性和稳定性。它在一个独立的进程中运行，等待 Minecraft JVM 停止。它作为 Coremod (Forge) 或 LanguageAdapter (Fabric/Quilt) 极早加载，使其能够捕获甚至是在启动初期发生的崩溃。

一键上传所有日志并复制链接：

您可以一键上传所有可用的日志，并获取一个格式整齐的信息，准备好在 GitHub 或 Discord 上粘贴。如果您是整合包作者，您将始终知道所有日志都是最新的，并包含所有可用信息，无需再请求额外的文件。

加入预配置 Discord 链接的按钮：

您的整合包玩家可以轻松地一键找到您的 Discord，并在崩溃后立即请求帮助。结合日志上传的极其简便性，这显著增加了报告单个崩溃的概率。对于个人下载或未配置的情况下，它会将用户引导到相应模组加载器的 Discord 服务器。

模组列表：

每次整合包作者启动游戏时，都会保存整合包的模组列表。您也可以使用 /crash_assistant modlist save 命令手动保存模组列表。它对于整合包和个人下载的工作方式不同：

整合包：

生成的消息包含最终用户相较于官方整合包列表添加、移除或更新的模组列表。

个人下载 / 整合包作者：

跟踪自上次成功启动以来的模组列表更改，如果您点击了“全部更新”按钮或添加了有问题的模组并忘记了是哪些，这将非常有用。

配置：

完全可配置：您可以启用或禁用任何功能，更改 Discord 链接，以及自定义标签、按钮等的文本。

本地化：

完全本地化。目前支持的语言：

• 英语
• 德语
• 俄语
• 中文
• 西班牙语
• 意大利语

没有硬编码字符串（除了日志记录）。您可以更改所有可见的字符串。有关更多本地化信息，或如果您想添加新语言，请阅读 lang README。

崩溃命令：

/crash_assistant crash 有 3 个选项：

• game - 使 Minecraft 崩溃并生成崩溃报告。
• jvm - 使 JVM 崩溃并生成 hs_err_pid 文件。
• no_crash - 应用附加参数但不进行崩溃。

在崩溃目标之后，您可以使用额外的参数：

• --withThreadDump - 在日志中生成线程转储。
• --withHeapDump - 生成堆转储文件。
• --GCBeforeHeapDump - 在堆转储前执行垃圾回收。

有问题的模组配置：

添加一个配置文件 problematic_mods_config.json，允许您将模组标记为与您的整合包不兼容。它有两种模式：如果检测到不兼容的模组，它可以使游戏崩溃，或者仅通知用户。添加了该模组的最终用户将收到一条预先配置的消息，解释其不兼容的原因，并提供一个按钮来移除它。

合作伙伴

YourKit 使用创新且智能的工具支持开源项目，用于监控和分析 Java 和 .NET 应用程序。 YourKit 是 YourKit Java Profiler、YourKit .NET Profiler 和 YourKit YouMonitor 的创造者。

隐私

日志 仅在用户明确点击“上传”按钮时 上传，并直接发送到 mclo.gs，这是一个由 Aternos 运营的日志共享服务。

在发布前，mclo.gs 会自动编辑敏感数据——例如访问令牌、IP 地址、系统用户名等——以确保粘贴内容的安全分享。

有关保留期限、谁可以访问日志以及您的 GDPR 权利的完整信息，请参阅他们的 隐私政策。

由于 mclo.gs 的移动端 UI 可能不太方便，Crash Assistant 默认情况下会通过 gnomebot.dev 包装 返回的 URL（例如 https://mclo.gs/X → https://gnomebot.dev/paste/mclogs/X）。您可以在设置中禁用此行为。 gnomebot.dev 是一个由 Latvian Modder 创建的开源在线日志查看器；它从 mclo.gs 获取数据并以便捷的格式显示给用户，将粘贴内容缓存在 RAM 中 五分钟（从最后一次访问算起），然后丢弃。

Crash Assistant 本身完全是客户端的——它没有服务器，也从未接收过您的日志副本。

这是一个简短的隐私说明。完整的隐私政策可以在 Crash Assistant 的隐私菜单中找到。在您首次尝试上传日志时，Crash Assistant 会提示您阅读并接受我们的隐私政策。