mirror of https://gitee.com/huanghongxun/HMCL-docs.git synced 2025-06-04 06:54:02 +08:00

continuous-integration/drone/push Build is passing

Details

* 🐞 fix(启动器的版本隔离): 修正的图片并且添加了箭头指示

🐞 fix(更新图片):

* 📃 docs(模组包): 新增报错排查手册

* 🐞fix(全局版本隔离): 更新图片并修正链接，删除旧图片，添加新图片

* ✨feat(报错排查): 添加 HMCL 汉医堂求助方式，提供更多支持渠道

2025-05-25 22:09:11 +08:00

2.3 KiB

Raw Blame History

title	permalink	date	categories	toc
模组包报错排查手册	/modpack/error-handbook.html	2025-05-24 13:39:36 +0800	整合包	true

本文由 LIiston 编写。

模组包报错排查手册

文件夹结构

首先我们需要先认识Minecraft的文件夹结构
如果你开启了版本隔离那么你的文件夹结构如下

.minecraft
|*asstes
|*libraries
|*versions
    \1.16.5-optifine
        |1.16.5-optifine.jar
        |*saves
        |*resourcepacks
        |*logs
        |*mods
        |*config
        |*saves
        |*crash-reports
        ...

如果你没有开启则是这样

.minecraft
|*asstes
|*libraries
|*saves
|*resourcepacks
|*logs
|*mods
|*config
|*saves
|*crash-reports
|*versions
    \1.16.5-optifine
        |1.16.5-optifine.jar
        ...

我们极力推荐您打开版本隔离，因为这样能避免模组之间的一部分冲突跳转

简单排查

在遇到报错时，您可以通过以下两种方式进行初步分析：

使用社区分析工具
访问 CrashMC 报错分析器，将崩溃报告内容粘贴进去，工具会自动分析常见问题并给出建议。
借助 AI 辅助分析
可以将崩溃日志粘贴到 DeepSeek Chat，让 AI 帮助你解读报错内容和可能的解决方法。
进入 HMCL 汉医堂 可以在 HMCL 急诊群中向群友们寻求帮助，他们通常有丰富的经验，能够协助你分析报错并提供解决方案。

qq : 666546887

这三种方式都能帮助您快速定位问题，提高排查效率。

求助他人

*游戏崩的时候会有个窗口，里面可以导出一个压缩包，可以发给别人让别人帮你看，你千万别截图那个窗口磕头

在向他人求助时，建议将 .minecraft 文件夹下的 crash-reports 文件夹和 logs 文件夹中的相关文件（如最新的崩溃报告和日志文件）一并打包发送。
这样可以让对方更全面地了解你的运行环境和报错详情，从而更高效地帮助你分析和解决问题。请注意，发送前可先检查日志内容，避免泄露个人隐私信息。

2.3 KiB Raw Blame History

模组包报错排查手册

文件夹结构

简单排查

求助他人

2.3 KiB

Raw Blame History