Minecraft 崩溃助手模组说明
功能概述
该模组会在Minecraft崩溃后立即显示一个图形用户界面(GUI),展示所有相关的游戏日志、启动器日志、崩溃报告以及hs_err
等文件,并提供一键上传日志、复制链接以及其他便捷功能,以便于问题报告、调试和解决问题。
注意:该模组为客户端专用(Client-only),在服务器端无任何功能。
如有任何疑问,请加入作者的 Discord 服务器:https://discord.gg/dV8WFrJZK6。
模组功能详情
界面(GUI)
支持文件拖放操作。用户可直接从界面中拖动文件到目标位置,或者直接拖动所有日志文件(从“可用日志文件”标签中进行拖放)。
日志分析功能
能够自动分析常见的崩溃原因。如果检测到问题,会显示解决方案的弹窗对话框。以下是支持的分析内容及常见问题:
崩溃原因分析
hs_err
文件:- AlLibAlcCleanup:某些与RAM分配相关的崩溃问题。
- atio6axx.dll:AMD驱动相关问题。
- glfw.dll:GPU驱动相关问题。
- ig7icd64.dll:非常旧版本的英特尔集成显卡驱动问题。
- Java运行环境内存不足。
- libasyncProfiler.so.tmp:Java ≥ 22 版本下某些Spark崩溃问题。
- jemalloc.dll:某些内存分配器(
jemalloc
)的诡异问题。 - jvm.dll:硬件问题或JVM自身的Bug。
- libglfw.so:常见的Linux问题。
- libopenal.so:常见的Linux问题。
- libGLProgrammability.dylib:用户尝试使用与macOS不兼容的着色器包。
- StubRoutines::SafeFetch32:macOS ARM架构的错误JDK版本问题。
- nglMultiDrawElementsBaseVertex:GPU驱动问题。
- nvoglv64.dll:Nvidia驱动问题。
- 日志文件问题
- Create模组的多个附加件不兼容问题。
- 检测模组安装文件夹损坏。
- 磁盘空间耗尽。
- 模组文件重复问题。
- KubeJSDataPack:加载数据包时出现KubeJS相关错误。
- 语言支持不匹配。
- Oculus模组缺少依赖问题。
- 多种模组加载失败问题。
- OptiFine(该模组已知会引发许多问题,建议替代方案)。
- Rubidium(该模组已停更多年,存在大量问题)。
- Java运行内存不足(
OutOfMemoryError
)。 - 资源定位问题(
ResourceLocationException
)。 - 版本兼容性(例如1.21版本建议升级至1.21.1 / 1.21.4 / 1.21.5)。
Codex日志分析器集成
支持一键上传日志并自动分析崩溃原因,分析结果会以详细信息显示,并提供修复问题的指导。尤其对于普通用户不熟悉的错误信息,将展示清晰的解决方案。例如:
- 错误区块或实体问题。
此功能大幅减少模组包支持团队的工作量,解决超过50%的常见问题。
集成显卡检测功能
检查游戏是否在集成显卡运行,而显示设备中有可用的独立显卡。
通用兼容性设计
模组独立运行于一个单独的进程,等待Minecraft的JVM退出后才启用其功能模块。其逻辑仅用于命令注册和保存模组列表,因此不会破坏任何崩溃报告或日志文件,且完全无兼容性问题。
日志上传与分享
支持一键上传所有可用日志,并生成一条格式化的消息,方便用来分享至GitHub或Discord。模组包创建者可以确保获取到完整的日志信息,而无需用户提供额外日志。无需再烦恼向用户索要崩溃报告。
快速加入Discord功能
模组包玩家可以一键访问预设的Discord服务器以请求帮助,该功能结合自动上传和分享日志的便捷性,大幅提高了用户报告问题的概率。如果未单独配置链接,将默认引导用户至模组加载器的Discord支持频道。
模组列表保存功能
每次游戏启动时,将保存模组包内的模组列表。该功能同时支持手动保存模组列表(命令:/crash_assistant modlist save
)。
不同下载方式的工作机制:
- 模组包玩家:生成的消息会包含玩家自行添加、移除或更新的模组列表。
- 模组包创建者或独立下载:追踪从最后一次正常启动后的模组变化,尤其适用于出现问题但忘记添加哪些模组时,无需进行繁琐的二分检查。
配置与语言支持
模组支持完全自定义配置,包括启用或禁用任意功能、修改Discord链接、定制按钮/标签文字等。
目前支持以下语言:
- 英语
- 俄语
- 中文
- 西班牙语
无硬编码字符串(除日志外),所有可见文本均可修改。如果希望添加其他语言或调整文字内容,请参考lang
设置文件。
崩溃命令
/crash_assistant crash
提供以下3种选项:
game
:触发Minecraft崩溃并生成崩溃报告。jvm
:触发JVM崩溃并生成hs_err_pid
文件。no_crash
:添加额外参数但不会触发崩溃。
命令支持以下附加参数属性:
--withThreadDump
:生成线程转储。--withHeapDump
:生成堆转储。--GCBeforeHeapDump
:在生成堆转储之前触发垃圾回收。
通过该模组,玩家能够在Minecraft崩溃后快速上传相关日志文件、定位问题根源,并获得有效的解决方案,同时模组包创建者和技术支持团队也可显著提升问题处理效率。
- 如果不会安装Mod,请点击查看我的世界Mod安装教程。
- 如发现网盘资源被吞,或者网盘资源不存在,请在下方评论中说明,我们将会尽快进行修复。