📃 docs(模组包): 新增报错排查手册 (#209)
All checks were successful
continuous-integration/drone/push Build is passing

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

🐞 fix(更新图片):

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

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

* feat(报错排查): 添加 HMCL 汉医堂求助方式,提供更多支持渠道
This commit is contained in:
LIPiston 2025-05-25 22:09:11 +08:00 committed by GitHub
parent 7c10881d3f
commit a6e67656c1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
9 changed files with 87 additions and 9 deletions

View File

@ -54,7 +54,7 @@ __想必你注意到我了记住上面讲的话__
## 关于游戏的资源包
下载完了,也玩了会
总有人讲啥 “啥啥啥 `材质包` 很好看”
总有人讲啥 “什么 `材质包` 很好看”
`材质包` 一般是单指修改了游戏材质的 `资源包` ,正式译名为 `纹理包`
@ -76,7 +76,7 @@ mods 是基于 mod_loader 的一个从文件上更改游戏的内容的外置组
在 [此文](/launcher/auto-installing.html#%E5%AE%89%E8%A3%85-mod-%E5%90%8E%E6%B8%B8%E6%88%8F%E6%8A%A5%E9%94%99%E6%97%A0%E6%B3%95%E5%90%AF%E5%8A%A8) 末尾中的确讲到了一定的解决方法
但是还是建议看看更为详细的内容 [注:目前未写该教程,请等待]()
请前往错误手册中查看 [跳转](/modpack/error-handbook.html)
## 关于游戏的 Java 选择

View File

@ -15,11 +15,11 @@ toc: true
## 使用方式
进入 hmcl 的`设置`
![](\assets\img\docs\Global-version-isolation\img.png)
![](\assets\img\docs\Global-version-isolation\img.webp)
在全局设置中找到 `版本隔离`
改为 `各版本独立`
![](\assets\img\docs\Global-version-isolation\img1.png)
这时候 minecraft 的文件结构就会有所改变
![](\assets\img\docs\Global-version-isolation\img2.webp)
这时候 minecraft 的文件结构就会有所改变,如下方
```
.minecraft
|*asstes
@ -32,15 +32,15 @@ toc: true
|*logs
|*mods
|*config
......
...
```
并非在 .minecraft 文件夹中存储一切的 mod 和 资源包**而是各版本的资源互相独立**
这样你就可以在一个目录下,安装多个客户端
## 往后的使用
在做完版本隔离的设置后hmcl 的快速打开各个游戏文件夹的功能就会显得十分重要
![](/assets/img/docs/Global-version-isolation/img2.png)
在做完版本隔离的设置后hmcl 的快速打开各个游戏文件夹的功能就会显得十分好用
![](/assets/img/docs/Global-version-isolation/img1.png)
善用该功能也可为你的磁盘剩下不少的空间
~~善用该功能也可为你的磁盘剩下不少的空间~~,现在反思过来其实都差不多

View File

@ -0,0 +1,78 @@
---
title: "模组包报错排查手册"
permalink: /modpack/error-handbook.html
date: 2025-05-24 13:39:36 +0800
categories: 整合包
toc: true
---
> 本文由 LIiston 编写。
# 模组包报错排查手册
## 文件夹结构
首先我们需要先认识Minecraft的文件夹结构
如果你开启了 [版本隔离](launcher/global-version-isolation.html) 那么你的文件夹结构如下
```text
.minecraft
|*asstes
|*libraries
|*versions
\1.16.5-optifine
|1.16.5-optifine.jar
|*saves
|*resourcepacks
|*logs
|*mods
|*config
|*saves
|*crash-reports
...
```
如果你没有开启则是这样
```text
.minecraft
|*asstes
|*libraries
|*saves
|*resourcepacks
|*logs
|*mods
|*config
|*saves
|*crash-reports
|*versions
\1.16.5-optifine
|1.16.5-optifine.jar
...
```
我们极力推荐您打开版本隔离,因为这样能避免模组之间的一部分冲突 [跳转](/launcher/global-version-isolation.html)
## 简单排查
在遇到报错时,您可以通过以下两种方式进行初步分析:
1. **使用社区分析工具**
访问 [CrashMC 报错分析器](https://www.crashmc.com/analyzer),将崩溃报告内容粘贴进去,工具会自动分析常见问题并给出建议。
2. **借助 AI 辅助分析**
可以将崩溃日志粘贴到 [DeepSeek Chat](https://chat.deepseek.com/),让 AI 帮助你解读报错内容和可能的解决方法。
3. **进入 HMCL 汉医堂**
可以在 HMCL 急诊群中向群友们寻求帮助,他们通常有丰富的经验,能够协助你分析报错并提供解决方案。
> qq : 666546887
这三种方式都能帮助您快速定位问题,提高排查效率。
## 求助他人
*游戏崩的时候会有个窗口,里面可以导出一个压缩包,可以发给别人让别人帮你看,你千万别截图那个窗口 *磕头*
![报错示例截图](/assets/img/docs/error-handbook/image.png)
在向他人求助时,建议将 `.minecraft` 文件夹下的 `crash-reports` 文件夹和 `logs` 文件夹中的相关文件(如最新的崩溃报告和日志文件)一并打包发送。
这样可以让对方更全面地了解你的运行环境和报错详情,从而更高效地帮助你分析和解决问题。请注意,发送前可先检查日志内容,避免泄露个人隐私信息。

Binary file not shown.

Before

Width:  |  Height:  |  Size: 120 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 118 KiB

After

Width:  |  Height:  |  Size: 204 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 132 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB