huanghongxun/HMCL-docs
1
0
Fork 0
mirror of https://gitee.com/huanghongxun/HMCL-docs.git synced 2026-03-19 08:15:26 +08:00
Code Issues Projects Releases Wiki Activity
pages
HMCL-docs/modpack/error-handbook.html
github-actions[bot] aab7c19a80 deploy: 2026-03-15 12:44:04 UTC
2026-03-15 12:44:04 +00:00

28 lines
10 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html><html lang="zh" class="no-js"><head><meta charset="utf-8"><title>模组包报错排查手册 - HMCL 文档</title><meta name="description" content="排查和解决整合包相关问题"><meta property="og:type" content="article"><meta property="og:locale" content="zh"><meta property="og:site_name" content="HMCL 文档"><meta property="og:title" content="模组包报错排查手册"><meta property="og:url" content="https://docs.hmcl.net/modpack/error-handbook.html"><meta property="og:description" content="排查和解决整合包相关问题"><meta property="article:published_time" content="2025-05-24T13:39:36+08:00"><link rel="canonical" href="https://docs.hmcl.net/modpack/error-handbook.html"><link href="/feed.xml" type="application/atom+xml" rel="alternate" title="HMCL 文档 Feed"><meta name="viewport" content="width=device-width, initial-scale=1.0"> <script> document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; window.enable_copy_code_button = true; </script><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"> <noscript><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"></noscript> <script src="/assets/js/settings.js"></script> <script src="/assets/js/theme.js"></script><link rel="shortcut icon" href="/favicon.ico"><link rel="stylesheet" id="skin"></head><body class="layout--document" dir="ltr"><nav class="skip-links"><ul><li><a href="#site-nav" class="screen-reader-shortcut">转到主导航栏</a></li><li><a href="#main" class="screen-reader-shortcut">转到内容</a></li><li><a href="#footer" class="screen-reader-shortcut">转到底部</a></li></ul></nav><div class="masthead"><div class="masthead__inner-wrap"><div class="masthead__menu"><nav id="site-nav" class="greedy-nav"> <a class="site-logo" href="/"><img src="/assets/img/hmcl.png" alt="HMCL 文档"></a> <a class="site-title" href="/"> HMCL 文档 </a><ul class="visible-links"><li class="masthead__menu-item"> <a href="/settings.html" >设置</a></li></ul><button class="greedy-nav__toggle hidden" type="button"> <span class="visually-hidden">切换菜单</span><div class="navicon"></div></button><ul class="hidden-links hidden"></ul></nav></div></div></div><div class="initial-content"><div id="main" role="main"><div class="sidebar sticky"><nav class="nav__list"> <input id="ac-toc" name="accordion-toc" type="checkbox" /> <label for="ac-toc">切换菜单</label><ul class="nav__items"><li> <span class="nav__sub-title">问题集合</span><ul><li><a href="/faq.html">常见问题</a></li><li><a href="/launcher/">启动器使用相关</a></li><li><a href="/modpack/">整合包帮助</a></li><li><a href="/multiplayer/">多人联机帮助</a></li></ul></li><li> <span class="nav__sub-title">使用者帮助</span><ul><li><a href="/launcher/isolation.html">版本隔离</a></li><li><a href="/launcher/offline-skin.html">设置离线皮肤</a></li><li><a href="/launcher/auto-installing.html">HMCL 的自动安装使用教程</a></li><li><a href="/launcher/shader.html">安装光影</a></li><li><a href="/launcher/set-item-details.html">设置项详解</a></li></ul></li><li> <span class="nav__sub-title">开发者帮助</span><ul><li><a href="/launcher/datapack.html">制作 HMCL 格式的数据包</a></li><li><a href="/modpack/serverpack.html">制作整合包</a></li><li><a href="/launcher/authlib-injector.html">添加默认 authlib-injector 验证服务器</a></li></ul></li><li> <span class="nav__sub-title">更新日志</span><ul><li><a href="/changelog/stable.html">稳定版</a></li><li><a href="/changelog/dev.html">开发版</a></li></ul></li><li> <span class="nav__sub-title">其他</span><ul><li><a href="/eula/hmcl.html">用户协议</a></li><li><a href="/contribution.html">贡献指南</a></li><li><a href="https://hmcl.huangyuhui.net">项目官网</a></li><li><a href="https://github.com/HMCL-dev/HMCL">项目仓库</a></li><li><a href="https://github.com/HMCL-dev/HMCL-docs">文档仓库</a></li></ul></li></ul></nav></div><article class="page" itemscope itemtype="https://schema.org/CreativeWork"><meta itemprop="headline" content="模组包报错排查手册"><meta itemprop="description" content="排查和解决整合包相关问题"><meta itemprop="datePublished" content="2025-05-24T13:39:36+08:00"><div class="page__inner-wrap"><header><h1 id="page-title" class="page__title" itemprop="headline"> <a href="https://docs.hmcl.net/modpack/error-handbook.html" itemprop="url">模组包报错排查手册 </a></h1></header><section class="page__content" itemprop="text"><aside class="sidebar__right sticky"><nav class="toc"><header><h4 class="nav__title"><i class="fas fa-file-alt"></i> 目录</h4></header><ul class="toc__menu"><li><a href="#文件夹结构">文件夹结构</a></li><li><a href="#简单排查">简单排查</a></li><li><a href="#求助他人">求助他人</a></li></ul></nav></aside><img src="https://hits.zkitefly.eu.org/?tag=https%3A%2F%2Fdocs.hmcl.net%2Fmodpack%2Ferror-handbook.html" alt="Hits" decoding="async"><div class="notice--info"><p>本文由 LIPiston 创建。</p></div><h2 id="文件夹结构">文件夹结构</h2><p>首先我们需要先认识Minecraft的文件夹结构<br> 如果你开启了 <a href="/launcher/isolation.html">版本隔离</a> 那么你的文件夹结构如下</p><div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>.minecraft
|*assets # 游戏资源文件夹，存放纹理、声音等资源
|*libraries # 依赖库文件夹，存放运行游戏所需的各种库
|*versions # 版本文件夹，包含所有已安装的Minecraft版本
\1.16.5-optifine
|1.16.5-optifine.jar # 该版本的主程序jar文件
|*saves # 存档文件夹，仅该版本可见
|*resourcepacks # 资源包文件夹，仅该版本可见
|*logs # 日志文件夹，仅该版本可见
|*mods # 模组文件夹，仅该版本可见
|*config # 配置文件夹，仅该版本可见
|*crash-reports # 崩溃报告文件夹，仅该版本可见
...
</code></pre></div></div><p>如果你没有开启则是这样</p><div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>.minecraft
|*assets # 游戏资源文件夹，存放纹理、声音等资源
|*libraries # 依赖库文件夹，存放运行游戏所需的各种库
|*saves # 存档文件夹，所有版本共用
|*resourcepacks # 资源包文件夹，所有版本共用
|*logs # 日志文件夹，所有版本共用
|*mods # 模组文件夹，所有版本共用
|*config # 配置文件夹，所有版本共用
|*crash-reports # 崩溃报告文件夹，所有版本共用
|*versions # 版本文件夹，包含所有已安装的Minecraft版本
\1.16.5-optifine
|1.16.5-optifine.jar # 该版本的主程序jar文件
...
</code></pre></div></div><p>我们极力推荐您打开版本隔离，因为这样能避免模组之间的一部分冲突 <a href="/launcher/isolation.html">跳转</a></p><h2 id="简单排查">简单排查</h2><p>在遇到报错时，您可以通过以下两种方式进行初步分析：</p><ol><li><p><strong>使用社区分析工具</strong><br> 访问 <a href="https://www.crashmc.com/analyzer">CrashMC 报错分析器</a>，将崩溃报告内容粘贴进去，工具会自动分析常见问题并给出建议。</p></li><li><p><strong>借助 AI 辅助分析</strong><br> 可以将崩溃日志粘贴到 <a href="https://chat.deepseek.com/">DeepSeek Chat</a>，让 AI 帮助你解读报错内容和可能的解决方法。</p></li><li><p><strong>进入 HMCL 汉医堂</strong> 可以在 HMCL 急诊群中向群友们寻求帮助，他们通常有丰富的经验，能够协助你分析报错并提供解决方案。</p><blockquote><p>qq : 666546887</p></blockquote></li></ol><p>这三种方式都能帮助您快速定位问题，提高排查效率。</p><h2 id="求助他人">求助他人</h2><p><em>游戏崩的时候会有个窗口，里面可以导出一个压缩包，可以发给别人让别人帮你看，你千万别截图那个窗口 *磕头</em></p><p><img src="/assets/img/docs/error-handbook/image.png" alt="报错示例截图"> 在向他人求助时，建议将 <code class="language-plaintext highlighter-rouge">.minecraft</code> 文件夹下的 <code class="language-plaintext highlighter-rouge">crash-reports</code> 文件夹和 <code class="language-plaintext highlighter-rouge">logs</code> 文件夹中的相关文件（如最新的崩溃报告和日志文件）一并打包发送。<br> 这样可以让对方更全面地了解你的运行环境和报错详情，从而更高效地帮助你分析和解决问题。请注意，发送前可先检查日志内容，避免泄露个人隐私信息。</p></section><footer class="page__meta"><p class="page__date"><strong><i class="fas fa-fw fa-calendar-alt" aria-hidden="true"></i> 更新时间:</strong> <time class="dt-published" datetime="2025-05-24T13:39:36+08:00">2025-05-24</time></p></footer><nav class="pagination"> <a href="/modpack/serverpack3.html" class="pagination--pager" title="配置客户端自动更新 (Nginx)">上一页</a> <a href="#" class="pagination--pager disabled">下一页</a></nav></div></article></div></div><div id="footer" class="page__footer"><footer><div class="page__footer-follow"><ul class="social-icons"><li><strong>关注:</strong></li><li><a href="https://github.com/HMCL-dev/HMCL" rel="nofollow noopener noreferrer"><i class="fab fa-fw fa-github" aria-hidden="true"></i> Github</a></li><li><a href="https://beian.miit.gov.cn" rel="nofollow noopener noreferrer"><i class="fas fa-link" aria-hidden="true"></i> 粤ICP备18071565号</a></li><li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li></ul></div><div class="page__footer-copyright">&copy; 2026 <a href="mailto:hmcl@huangyuhui.net">huanghongxun</a>. 技术来自于 <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/jekyll-themes/minimal-mistakes/" rel="nofollow">Minimal Mistakes</a>.</div></footer></div><script src="/assets/js/main.min.js"></script> <script src="/assets/js/plugins/jquery.auto-redirect.js"></script></body></html>
Reference in New Issue View Git Blame Copy Permalink