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/launcher/auto-installing.html
github-actions[bot] aab7c19a80 deploy: 2026-03-15 12:44:04 UTC
2026-03-15 12:44:04 +00:00

2 lines
22 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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="安装 Forge、Fabric、LiteLoader、OptiFine 及模组的教程"><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/launcher/auto-installing.html"><meta property="og:description" content="安装 Forge、Fabric、LiteLoader、OptiFine 及模组的教程"><meta property="article:published_time" content="2025-11-02T09:06:30+08:00"><link rel="canonical" href="https://docs.hmcl.net/launcher/auto-installing.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" class="active">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="安装 Forge、Fabric、LiteLoader、OptiFine 及模组的教程"><meta itemprop="datePublished" content="2025-11-02T09:06:30+08:00"><div class="page__inner-wrap"><header><h1 id="page-title" class="page__title" itemprop="headline"> <a href="https://docs.hmcl.net/launcher/auto-installing.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><ul><li><a href="#模组加载器简介">模组加载器简介</a></li><li><a href="#安装新实例时安装模组加载器">安装新实例时安装模组加载器</a></li><li><a href="#为已有实例安装或更换模组加载器">为已有实例安装或更换模组加载器</a></li></ul></li><li><a href="#安装模组">安装模组</a><ul><li><a href="#自动安装-推荐">自动安装 (推荐)</a></li><li><a href="#安装optifine-或其它光影模组">安装OptiFine 或其它光影模组</a></li><li><a href="#手动安装">手动安装</a><ul><li><a href="#通过模组管理页面">通过模组管理页面</a></li><li><a href="#通过模组文件夹安装">通过模组文件夹安装</a></li></ul></li></ul></li><li><a href="#安装-mod-后游戏报错无法启动">安装 Mod 后游戏报错/无法启动</a></li><li><a href="#补充常见模组加载器简单介绍和支持版本一览">补充：常见模组加载器简单介绍和支持版本一览</a></li></ul></nav></aside><img src="https://hits.zkitefly.eu.org/?tag=https%3A%2F%2Fdocs.hmcl.net%2Flauncher%2Fauto-installing.html" alt="Hits" decoding="async"><div class="notice--info"><p>本文由 asdqp233,Mine-diamond 创建。</p></div><p>要为 Minecraft 安装模组，你首先需要安装一个“模组加载器”（例如 NeoForge 或 Fabric），然后再安装你想要的模组。HMCL 为这两个步骤都提供了强大的支持。</p><p>在安装前，最关键的一点是<strong>兼容性</strong>。请记住以下核心原则：</p><ul><li>通常，你只能为单个游戏实例安装一种模组加载器。</li><li>你下载的<strong>模组</strong>，必须同时兼容你的<strong>游戏版本</strong>（如 1.20.4）和<strong>模组加载器</strong>（如 Fabric）。</li></ul><p>简单来说，为游戏安装模组总共分三步，本指南将带你逐一完成：</p><ol><li>开启版本隔离，为模组创建一个独立干净的环境。</li><li>安装模组加载器（如 Forge, Fabric）。</li><li>安装你喜欢的模组。</li></ol><h2 id="启用版本隔离">启用版本隔离</h2><p>在安装模组之前，必须开启版本隔离以隔离为不同实例安装的模组：</p><p>在 HMCL 主界面，点击「设置」，在「全局游戏设置」选项卡中，找到「版本隔离」，点击「版本隔离」，选择「各实例独立」即可</p><p><img src="/assets/img/docs/auto-installing/Working_Directory.png" alt="Working_Directory"></p><p>更详细的介绍见 <a href="/launcher/isolation.html">全局版本隔离</a></p><h2 id="安装模组加载器">安装模组加载器</h2><h3 id="模组加载器简介">模组加载器简介</h3><p>常见的模组加载器有以下几个：</p><p><code class="language-plaintext highlighter-rouge">Forge</code>,<code class="language-plaintext highlighter-rouge">NeoForge</code>,<code class="language-plaintext highlighter-rouge">Fabric</code>,<code class="language-plaintext highlighter-rouge">Quilt</code>,<code class="language-plaintext highlighter-rouge">Cleanroom</code>,<code class="language-plaintext highlighter-rouge">LiteLoader</code> 是 6 个常见的 Mod 加载器。<br> <code class="language-plaintext highlighter-rouge">Fabric API</code>,<code class="language-plaintext highlighter-rouge">QSL/QFAPI</code> 是两个随 <code class="language-plaintext highlighter-rouge">Fabric</code> 与 <code class="language-plaintext highlighter-rouge">Quilt</code> 的官方 API（实际是模组）。</p><p><strong>兼容性：</strong></p><ul><li><strong><em>LiteLoader</em> 和 <em>Forge</em> 是兼容的 (<em>Forge</em> 较新版本和 <em>LiteLoader</em> 较老版本可能不兼容)，可以同时安装</strong></li><li><strong>其它所有模组加载器几乎互不兼容，即你无法同时安装两个模组加载器</strong></li></ul><p><strong>Fabric与Quilt 说明：</strong><br> 非常多的 <em>Fabric Mod</em> 需要 <em>Fabric API</em> 作为前置模组， <em>Quilt Mod</em> 需要 <em>QSL/QFAPI</em> 作为前置模组。<br> 在安装 <em>Fabric</em> 或 <em>Quilt</em> 加载器时候如果没有其它原因，建议安装 <em>Fabric API</em> 或 <em>QSL/QFAPI</em> , 否则很多 <em>Fabric Mod</em> 或 <em>Quilt Mod</em> 则有可能无法被加载!</p><h3 id="安装新实例时安装模组加载器">安装新实例时安装模组加载器</h3><p>当你在安装新的游戏客户端时候, 会看到其中有该版本支持的模组加载器安装选项，点击你想安装的模组加载器（根据你想安装模组所支持的加载器进行选择）</p><p><img src="/assets/img/docs/auto-installing/AutoInstaller_ModLoader.png" alt="AutoInstaller_ModLoader"></p><ul><li>点击你想要的加载器（如 Fabric）。</li><li>在弹出的版本选择页面，若无特殊需求，<strong>选择最新稳定版</strong>（通常是第一个）。</li><li>如果你选择 <code class="language-plaintext highlighter-rouge">Fabric</code> 或 <code class="language-plaintext highlighter-rouge">Quilt</code>，最好同时安装<code class="language-plaintext highlighter-rouge">Fabric API</code> 或 <code class="language-plaintext highlighter-rouge">QSL/QFAPI</code>。</li><li>点击「安装」即可。</li></ul><h3 id="为已有实例安装或更换模组加载器">为已有实例安装或更换模组加载器</h3><p>如果你想为已安装好的纯净版游戏添加加载器，或者更换、更新加载器版本：</p><ol><li>在 HMCL 主界面，点击「实例管理」，然后选择你想要修改的游戏实例。</li><li>在左侧菜单中，点击「自动安装」。</li></ol><p><img src="/assets/img/docs/auto-installing/Auto_Install_Page.png" alt="Auto_Install_Page"></p><ul><li> <strong>安装</strong>：点击你想要的加载器图标（如 Forge），选择版本（推荐最新版），然后点击安装。</li><li> <strong>更新</strong>：点击已安装的加载器，选择一个更新的版本，然后点击安装。</li><li> <strong>删除</strong>：点击加载器右侧的「X」按钮即可删除。</li><li> <strong>更换</strong>：先删除旧的加载器，再安装新的。</li></ul><blockquote><p><strong>注意</strong>：此处的自动安装页面不支持安装 <code class="language-plaintext highlighter-rouge">Fabric API</code> 或 <code class="language-plaintext highlighter-rouge">QSL/QFAPI</code>。请将它们当作普通模组进行安装。</p></blockquote><h2 id="安装模组">安装模组</h2><p>安装好加载器后，就可以开始添加模组了。你可以在下列网站获取模组信息，并在 HMCL 内下载和安装：</p><ul><li> <a href="https://www.mcmod.cn/">MC 百科</a> - 中文社区，资料详尽。</li><li> <a href="https://www.curseforge.com/minecraft/search?class=mc-mods">CurseForge</a> - 最大的模组发布站之一。</li><li> <a href="https://modrinth.com/mods">Modrinth</a> - 新兴的现代化模组发布站。</li></ul><p>在安装任何模组前，请先确认三件事：</p><ol><li> <strong>游戏版本</strong>：模组是否支持你当前的游戏版本？(例如, 1.20.4)</li><li> <strong>加载器类型</strong>：模组是给 Forge、Fabric 还是其它模组加载器用的？</li><li> <strong>前置模组</strong>：模组是否需要其他模组作为前置？（模组页面通常会说明）</li></ol><h3 id="自动安装-推荐">自动安装 (推荐)</h3><p>HMCL 内置了 CurseForge 和 Modrinth 的搜索和下载功能，非常方便。</p><ol><li>在 HMCL 主界面，点击「下载」-&gt;「模组」。</li><li>在搜索框输入模组名（支持中英文），然后点击搜索。如果搜不到，可以尝试切换右上角的下载源。</li><li>点击你想要的模组，进入版本列表页面。</li><li>根据<strong>游戏版本</strong>和<strong>加载器</strong>，找到你需要的版本，点击并选择「安装到当前实例」。</li><li>如果该模组有前置，HMCL 会自动提示，请先安装所有前置模组（但是请不要重复安装前置模组）。</li></ol><p>注：点击模组下载页面 上方的蓝色的链接可以到对应的网站查看模组的信息，这会告诉你模组的功能和有可能会提示你一些注意事项</p><p><strong>注意: 请查看你要下载的模组是否正常你要安装的游戏版本以及模组加载器，否则模组无法被正常加载!</strong></p><p><img src="/assets/img/docs/auto-installing/AutoInstaller_ModAutoAdding.png" alt="AddingModAutomatically"></p><h3 id="安装optifine-或其它光影模组">安装OptiFine 或其它光影模组</h3><p>光影的安装方式略有不同，请参考专门的指南 <a href="/launcher/shader.html">光影安装</a></p><h3 id="手动安装">手动安装</h3><p>当你在网站或其它位置手动下载了模组文件，你可以参照以下步骤完成安装：</p><p>一般的 Mod 文件后缀为 <code class="language-plaintext highlighter-rouge">jar</code> 或者 <code class="language-plaintext highlighter-rouge">litemod</code>，请确认后缀是正确的。其中<code class="language-plaintext highlighter-rouge">jar</code>为大多数模组加载器支持的格式，<code class="language-plaintext highlighter-rouge">litemod</code>仅<code class="language-plaintext highlighter-rouge">LiteLoader</code>支持。</p><h4 id="通过模组管理页面">通过模组管理页面</h4><ol><li>进入「实例管理」-&gt; 选择你的游戏实例 -&gt;「模组管理」。</li><li>点击「添加模组」并选择你的模组文件，或直接将文件拖拽到窗口内即可。</li></ol><h4 id="通过模组文件夹安装">通过模组文件夹安装</h4><ol><li>进入「实例管理」-&gt; 选择你的游戏实例 -&gt;「浏览」-&gt;「模组文件夹」。</li><li>这会打开该实例的 <code class="language-plaintext highlighter-rouge">mods</code> 文件夹。</li><li>将你下载的 <code class="language-plaintext highlighter-rouge">.jar</code> 模组文件复制或移动到这个文件夹里。 （如果 <code class="language-plaintext highlighter-rouge">mods</code> 文件夹不存在，请自行创建一个。）</li></ol><p><img src="/assets/img/docs/auto-installing/AutoInstaller_ModManualAdding.png" alt="AddingModManually"></p><h2 id="安装-mod-后游戏报错无法启动">安装 Mod 后游戏报错/无法启动</h2><p>造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。</p><p><strong>第一步：基础检查（最常见问题）</strong></p><ul><li> <strong>查看 HMCL 错误报告</strong>：新版 HMCL 会直接提示大部分常见错误，这是你的首选信息来源。</li><li> <strong>检查兼容性</strong>：确认模组版本、游戏版本、模组加载器三者是否匹配。</li><li> <strong>检查前置模组</strong>：是否忘记安装必要的API（如 Fabric API）或其他前置模组？</li></ul><p><strong>第二步：自己排查</strong></p><ul><li> <strong>使用“二分法”</strong>：在“模组管理”页面，先禁用一半的模组，看游戏能否启动或出错。如果可以，说明问题出在被禁用的那一半里。不断重复此过程，直到找到引发问题的具体模组。</li><li> <strong>查看日志文件</strong>：如果你有能力，可以自行查看游戏日志来定位问题。</li></ul><p><strong>第三步：有效求助</strong> 如果无法自行解决，你需要向社区求助。但请记住，一个有效的求助包含<strong>完整的日志文件</strong>。</p><p><strong>如何正确求助</strong>：</p><ol><li>在游戏崩溃后，点击 HMCL 弹出的错误窗口上的「<strong>导出游戏日志</strong>」按钮，它会生成一个 <code class="language-plaintext highlighter-rouge">minecraft-exported-crash-info-时间戳.zip</code> 文件。</li><li>带着<strong>这个文件</strong>去社区、论坛或群里提问，并具体描述你遇到的问题。</li></ol><blockquote><p><strong>重要</strong>：对于向他人求助，千万不要只截图，不要只说“游戏出错怎么办”这种及其笼统的话语。<strong>没有日志，谁也帮不了你。</strong></p></blockquote><p><img src="/assets/img/docs/auto-installing/Crash_Report_Page.png" alt="CrashReportPage"></p><h2 id="补充常见模组加载器简单介绍和支持版本一览">补充：常见模组加载器简单介绍和支持版本一览</h2><p>模组加载器简单介绍：</p><table><thead><tr><th>模组加载器</th><th>简单介绍</th></tr></thead><tbody><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/forge.png" alt="Forge icon" width="16"> Forge</span></td><td>老牌的模组加载器，功能强大，支持的模组众多，推荐在1.21之前安装。</td></tr><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/neoforge.png" alt="NeoForge icon" width="16"> NeoForge</span></td><td>1.20.1后Forge的继任者，推荐在1.21版本后安装NeoForge。</td></tr><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric icon" width="16"> Fabric</span></td><td>轻型模组加载器，非常适合安装优化模组或纯净生存增强类模组。</td></tr><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/quilt.png" alt="Quilt icon" width="16"> Quilt</span></td><td>Fabric的一个分支，同样轻量。</td></tr><tr><td> <span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric api icon" width="16"> Fabric API</span><br><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/quilt.png" alt="QSL/QFAPI icon" width="16"> QSL/QFAPI</span></td><td>由于<code class="language-plaintext highlighter-rouge">Fabric</code>和<code class="language-plaintext highlighter-rouge">Quilt</code>比较轻功能有限，因此提供了增强功能的api，很多模组依赖于此api。</td></tr><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/cleanroom.png" alt="Cleanroom icon" width="16"> Cleanroom</span></td><td>1.12.2版本Forge的一个优化代替，提供了相对更强的功能，仅支持1.12.2。</td></tr><tr><td><span style="white-space: nowrap;"><img src="/assets/img/docs/auto-installing/chicken.png" alt="LiteLoader icon" width="16"> LiteLoader</span></td><td>轻量模组加载器，为Forge的轻量代替，现在已停止维护。</td></tr></tbody></table><p>支持版本一览：</p><table><thead><tr><th>模组加载器</th><th>最老版本</th><th>最新版本</th></tr></thead><tbody><tr><td> <img src="/assets/img/docs/auto-installing/forge.png" alt="Forge icon" width="16"> Forge</td><td>1.5.2</td><td>游戏最新版本</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/neoforge.png" alt="NeoForge icon" width="16"> NeoForge</td><td>1.20.1</td><td>游戏最新版本</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric icon" width="16"> Fabric</td><td>1.16.3</td><td>游戏最新版本</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/fabric.png" alt="Fabric api icon" width="16"> Fabric api</td><td>1.16.3</td><td>游戏最新版本</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/quilt.png" alt="Quilt icon" width="16"> Quilt</td><td>1.16.3</td><td>游戏最新版本</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/quilt.png" alt="QSL/QFAPI icon" width="16"> QSL/QFAPI</td><td>1.18.2</td><td>1.21</td></tr><tr><td> <img src="/assets/img/docs/auto-installing/cleanroom.png" alt="Cleanroom icon" width="16"> Cleanroom</td><td>1.12.2</td><td> </td></tr><tr><td> <img src="/assets/img/docs/auto-installing/chicken.png" alt="LiteLoader icon" width="16"> LiteLoader</td><td>1.5.2</td><td>1.12.2</td></tr></tbody></table></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-11-02T09:06:30+08:00">2025-11-02</time></p></footer><nav class="pagination"> <a href="/launcher/jvm-options-and-env.html" class="pagination--pager" title="JVM 选项与环境变量">上一页</a> <a href="/launcher/offline-skin.html" class="pagination--pager" title="离线模式下更换皮肤">下一页</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