安装《我的世界》整合包：零基础详细教程

适用范围：Minecraft Java 版、Windows 为主；HMCL 另含 macOS/Linux 提示。
资料核对日期：2026 年 7 月 22 日。启动器更新后，少数按钮名称或位置可能略有变化，但操作逻辑不变。
本教程面向第一次接触 Java、模组加载器和整合包的玩家。

一、先看结论：最短安装路线

如果你只想先把游戏装起来，可以按下面做；遇到问题再阅读后面的详细章节。

• 1. 从整合包作者给出的官方页面或可信发布页下载正确版本，确认它适用于你的操作系统、Minecraft 版本和客户端。
• 2. 不要急着解压。.mrpack、标准 CurseForge .zip、MCBBS .zip 通常应该直接交给启动器导入。
• 3. 把 HMCL 或 PCL2 放进一个单独、路径简单的文件夹，例如：

D:\Minecraft\HMCL\
D:\Minecraft\PCL2\


• 4. 在启动器中登录：已购买 Java 版的玩家选微软正版登录；离线登录只适合无需正版验证的本地游戏或特定服务器。
• 5. 启用启动器的 Java 自动选择。若必须手动选择，请按本教程的 Java 表格设置。
• 6. 导入整合包：
  • HMCL：把整合包拖入主窗口，或找到“新建/添加实例（游戏）→ 导入整合包”。
  • PCL2：把整合包文件直接拖入 PCL 窗口，输入实例名称后确认。
• 7. 不要擅自更改启动器检测到的 Minecraft、Forge、Fabric 或 NeoForge 版本。
• 8. 内存先设为整合包作者建议值；没有说明时，中型包可先试 6 GB，但必须给系统留出内存。
• 9. 等待全部下载完成，选中新导入的实例，启动一次。
• 10. 第一次启动比以后慢很正常。进入主菜单后先退出，备份实例，再开始添加存档或调整设置。

最容易犯的三个错误：把标准整合包解压后再导入；使用了错误的 Java；把 Fabric 模组放进 Forge/NeoForge 实例。

二、开始前必须知道的概念

2.1 什么是整合包

整合包不是“很多模组随便放在一起”。一个完整整合包通常包含：

• 指定的 Minecraft 版本；
• 指定的模组加载器及精确版本；
• 一组经过搭配或测试的模组；
• 模组配置、按键、任务、脚本、资源包、光影预设等；
• 供启动器读取的清单文件。

因此，安装整合包最稳妥的方法是让启动器读取整合包清单并自动建立独立实例，而不是先安装一个游戏版本，再把文件乱复制进去。

2.2 什么是“实例”或“游戏版本”

启动器里的“实例”“版本”可以理解为一套独立游戏环境。例如：

原版 1.21.1
机械动力整合包 1.20.1 Forge
冒险整合包 1.21.1 NeoForge
轻量优化包 1.21.1 Fabric


每套环境应该拥有自己的 mods、config、saves 等目录。这样不同整合包不会互相污染。

2.3 启动器、Java、加载器、模组是什么关系

可以把它们想成以下关系：

HMCL / PCL2（管理和启动） ↓
Java（运行 Minecraft Java 版） ↓
Minecraft（游戏本体） ↓
Forge / Fabric / NeoForge（加载模组） ↓
具体模组、配置、脚本与资源包（整合包内容）


任何一层版本不匹配，都可能导致启动失败。

2.4 Forge、Fabric、NeoForge 的区别

• 加载器：Forge；常见特点：历史较久，老牌大型模组生态丰富；常见使用场景：1.7.10、1.12.2、1.16.5、1.18.2、1.20.1 等大量经典整合包；新手必须记住的事：Forge 模组只能放入对应 Forge 实例，并且还要匹配 Minecraft 版本
• 加载器：Fabric；常见特点：轻量、更新快，优化类和原版增强类模组很多；常见使用场景：新版本、轻量优化包、客户端增强包；新手必须记住的事：常需 Fabric API，但是否需要由模组/整合包决定
• 加载器：NeoForge；常见特点：从 Forge 生态发展出的独立加载器，新版本采用较多；常见使用场景：1.20.2 之后尤其常见的新整合包；新手必须记住的事：不要因为名字相似就把 Forge 和 NeoForge 模组混用

还有 Quilt、Cleanroom 等加载器，但原则完全相同：以整合包作者指定的加载器、Minecraft 版本和加载器版本为准。

不要做这些事：

• 不要把文件名里写着 fabric 的模组丢进 Forge 实例；
• 不要把 1.20.1 模组拿去运行 1.21.1；
• 不要在安装整合包时自行把 Forge 版本“升级到最新”；
• 不要看到 NeoForge 与 Forge 的版本号接近就互换；
• 不要随意替换整合包自带的 Fabric API、Architectury、Cloth Config 等前置模组。

三、安装前准备与安全检查

3.1 硬件与磁盘空间

建议至少准备：

• 64 位操作系统；现代 Minecraft 与大多数整合包不适合 32 位系统；
• 8 GB 系统内存可运行部分轻量包，16 GB 更适合大多数中大型包；
• 至少 10～30 GB 可用磁盘空间，大型整合包或多个实例需要更多；
• 支持当前 Minecraft 版本的显卡与驱动；
• 稳定网络，因为清单型整合包导入时还会继续下载游戏文件、依赖和模组。

3.2 建议的文件夹

Windows 新手建议在非系统盘建立纯英文目录：

D:\Minecraft\HMCL\
D:\Minecraft\PCL2\
D:\Minecraft\Downloads\
D:\Minecraft\Backups\


尽量避免：

C:\Program Files\...
C:\Windows\...
桌面\...
OneDrive\桌面\...
含有特殊符号、过长名称或生僻字符的路径
压缩软件的临时预览目录


中文路径并非在所有环境中一定出错，但旧版 Forge、旧模组、原生库或脚本可能处理不好。为了少踩坑，排错时优先换到纯英文、短路径。

3.3 下载来源与安全

优先级建议如下：

• 1. 整合包作者的 CurseForge、Modrinth 或官方项目页；
• 2. 作者明确给出的 GitHub Releases、网盘或服务器群文件；
• 3. 启动器内置的 CurseForge/Modrinth 检索页。

收到陌生人转发的“完整客户端”时要谨慎。标准清单型整合包通常主要是 JSON 清单、配置和资源，并不需要你运行来源不明的 .exe、.bat、.cmd、.ps1 或 .jar 安装器。

安全注意事项：

• 不要因为杀毒软件报警就直接关闭全部防护；先核对下载来源、文件哈希和作者公告。
• 不要从“高速下载器”或广告按钮下载整合包。
• 不要下载来历不明的 opengl32.dll 放进 Java 或游戏目录。
• 不要把微软账号密码直接输入启动器自制网页；正版登录应跳转到微软的授权页面或使用微软提供的设备代码流程。
• 分享日志前检查其中的用户名、电脑路径、服务器地址等隐私信息；不要分享账号缓存、访问令牌或启动器账户数据库。

3.4 下载完整性检查

下载结束后先看文件：

• 文件大小是否与发布页大致一致；
• 扩展名是不是作者说明的 .zip 或 .mrpack；
• 是否出现 xxx.zip.zip、xxx.mrpack.zip 之类被浏览器重复改名的情况；
• 压缩软件能否正常打开文件并执行“测试压缩包”；
• 作者提供 SHA-256 时，尽量核对哈希。

文件只有几 KB、打开提示“意外结束”、CRC 错误或解压失败，通常说明下载不完整，应重新下载，不要继续导入。

四、正版登录与离线登录

4.1 微软正版登录

适合：已经在微软账户下拥有 Minecraft: Java Edition 的玩家。

优势：

• 可通过 Mojang/Microsoft 正版验证；
• 可进入启用正版验证的多人服务器；
• 可正常使用正版皮肤、Realms 等服务；
• 玩家 UUID 和身份稳定。

一般流程：

• 1. 在启动器的账户区域选择“微软账户”或“正版登录”。
• 2. 浏览器打开微软官方页面后，核对域名属于微软登录服务。
• 3. 按提示登录并授权。
• 4. 回到启动器，确认显示的是正确的 Minecraft 角色名。

如果提示“账号未购买游戏”，先确认：

• 登录的是购买游戏的那个微软账户；
• 购买的是 Java 版或包含 Java 版的 PC 套装；
• 家庭组、未成年人账号权限或 Xbox 隐私设置没有限制多人游戏；
• 微软/Minecraft 服务当前可以访问。

4.2 离线登录

离线登录只是启动器在本地创建一个玩家名称，不等于拥有正版，也不会绕过服务器的正版验证。

适合：

• 本地单人测试；
• 局域网测试；
• 明确允许离线账号的特定服务器；
• 暂时不需要微软在线服务的环境。

限制与风险：

• 通常不能进入开启 online-mode 正版验证的服务器或 Realms；
• 默认不能从 Mojang 获取正版皮肤；
• 名称并不证明身份，别人可能使用相同名称；
• 更换离线名称可能导致世界中的玩家数据、背包或权限对应到不同 UUID；
• 某些整合包服务器只接受指定登录方式。

离线名称建议只用英文字母、数字和下划线，长度按启动器提示设置。不要在已经游玩很久的存档中随意更名。

4.3 HMCL 登录位置

在 HMCL 主界面的账户区域进入账户列表：

• 选择“微软账户”进行正版登录；
• 选择“离线登录”并填写玩家名称，创建离线账户。

HMCL 官方 FAQ 也给出了“账户 → 微软账户/离线登录”的路径。

4.4 PCL2 登录位置

在 PCL2 主界面的登录/角色区域选择登录方式：

• 已购买游戏：选择“正版”或“微软登录”；
• 本地测试：选择“离线”，填写玩家名。

如果整合包作者指定了外置登录，必须使用作者给出的认证地址和说明；不要自行在不可信网站输入密码。

五、Java 版本怎么选

5.1 最省心的做法

先使用 HMCL/PCL2 的“自动选择 Java”或“自动下载 Java”。现代启动器会根据 Minecraft 和加载器信息选择合适的运行时。只有出现明确报错、整合包作者指定版本，或自动识别失败时，再手动设置。

Java 版本不是越新越好。 老整合包常常只能稳定运行在旧 Java 上，新游戏又无法使用过旧 Java。

5.2 常用对应表

• Minecraft 版本：1.16.5 及更早的大多数整合包；备注：某些特殊整合包会明确要求其他 Java，以作者说明为准
• Minecraft 版本：1.17.x；备注：这是该代游戏的标准运行时；特定整合包可能适配 Java 17
• Minecraft 版本：1.18 ～ 1.20.4；备注：Minecraft 1.18 官方切换到 Java 17
• Minecraft 版本：1.20.5 ～ 1.21.11；备注：Minecraft 1.20.5 官方开始要求 Java 21
• Minecraft 版本：26.1（截至 2026 年 7 月的最新正式代际）；备注：Minecraft 26.1 官方开始要求 Java 25；后续版本仍应以启动器检测和官方说明为准

2026 年 Minecraft 已启用按年份命名的新版本号；26.1 是正式版本号，不是把 1.26.1 写漏了。

5.3 一定要使用 64 位 Java

现代整合包应使用 64 位 Java。32 位 Java 很难分配足够内存，常见报错包括：

Could not reserve enough space for object heap
Invalid maximum heap size


检查 Java 输出时，看到 64-Bit Server VM 通常表示位数正确。

5.4 从报错判断 Java 是否错误

常见关键词：

UnsupportedClassVersionError
class file version 61.0
class file version 65.0
class file version 69.0
only recognizes class file versions up to ...
Java Runtime incompatible


常见 class file 对应关系：

如果日志说某个类由更高版本 Java 编译，说明当前 Java 太旧；但也不要直接跳到最高版本，应先按 Minecraft 版本表选择。

5.5 在 HMCL 中设置 Java

推荐：

• 1. 打开“设置 → Java 管理”。
• 2. 保留或开启自动选择。
• 3. 没有合适 Java 时点击“下载 Java”，选择需要的主版本。
• 4. 若 Java 已安装但未识别，点击“添加 Java”，选择：

Windows: ...\bin\javaw.exe 或 ...\bin\java.exe
macOS/Linux: .../bin/java


• 5. 只给某个整合包指定 Java 时，进入该实例的“游戏设置”，启用实例独立设置，再选 Java。不要为了一个老包修改所有实例。

5.6 在 PCL2 中设置 Java

• 1. 先选中要启动的整合包实例。
• 2. 进入“版本设置 → 设置”，或进入“设置 → 启动选项”。
• 3. 在“游戏 Java”处选择自动检测到的正确版本。
• 4. 若列表没有正确 Java，使用搜索/导入 Java 功能，选中 Java 安装目录中的 bin\javaw.exe。
• 5. 修改后重新启动游戏，确认启动日志顶部显示的 Java 主版本正确。

PCL2 不同版本可能把全局和实例设置放在略有不同的位置。判断原则是：优先修改当前整合包的独立设置，不要无意影响其他实例。

六、内存怎么设置

6.1 内存不是分得越多越好

给游戏分配的内存是 Java 最大堆内存，不是“让电脑变快”的开关。分得太少会卡顿或内存溢出，分得太多会挤压 Windows、浏览器和显卡共享内存，还可能造成更长的垃圾回收停顿。

永远不要把全部物理内存都分给 Minecraft。

6.2 按整合包规模估算

• 类型：原版、轻量优化包；说明：高分辨率材质或远视距需要更多
• 类型：小型模组包；说明：约几十个模组
• 类型：中型整合包；说明：多数常见整合包可从这里试起
• 类型：大型任务/科技/魔法包；说明：优先遵循作者说明
• 类型：超大型包、高分辨率材质、重度光影；说明：需要足够物理内存和显存，不建议盲目提高

6.3 按电脑总内存估算

• 说明：关闭浏览器等程序；大型包可能不适合
• 说明：适合多数中大型包
• 说明：超大型包可按作者建议提高
• 说明：除非作者明确要求，不必一次分几十 GB

至少给系统和后台程序留出 3～4 GB；使用核显时还要考虑显存会占用系统内存。

6.4 调整方法

• HMCL：进入当前实例“游戏设置”，找到内存设置，优先使用自动分配；要手动设置时启用实例独立设置。
• PCL2：选中实例后进入“版本设置 → 设置”，找到内存；或在全局“设置 → 启动选项”中调整。

看到下面的报错时，分别处理：

• OutOfMemoryError: Java heap space：可能分配过少，也可能模组内存泄漏；先按 1～2 GB 小幅增加。
• Could not reserve enough space：可能分配过多、Java 为 32 位或系统剩余内存不足；应降低设置并改用 64 位 Java。
• 系统整体卡死、磁盘占用 100%：通常是把内存分得太满导致系统大量使用虚拟内存；应降低游戏内存并关闭后台程序。

不要从网上复制一长串所谓“万能 JVM 参数”。先保留启动器和整合包默认参数，只调整内存。

七、整合包格式与解压规则

7.1 CurseForge 整合包

常见扩展名：.zip

标准结构通常类似：

示例整合包.zip
├─ manifest.json
└─ overrides/ ├─ config/ ├─ defaultconfigs/ ├─ kubejs/ ├─ resourcepacks/ └─ 其他需要覆盖到实例目录的文件


manifest.json 记录 Minecraft、加载器以及要下载的 CurseForge 项目文件；overrides 中保存配置、脚本和不能只用清单描述的内容。

因此，一个 CurseForge 整合包压缩包看起来只有几十 MB，并不代表缺少模组。启动器导入时会根据清单继续下载。

处理方式：不要解压，直接把 .zip 导入 HMCL/PCL2。

7.2 Modrinth 整合包

常见扩展名：.mrpack

.mrpack 本质上是 ZIP 容器，标准结构类似：

示例整合包.mrpack
├─ modrinth.index.json
├─ overrides/
└─ client-overrides/ # 可选


modrinth.index.json 记录需要下载的文件、哈希、目标路径、Minecraft 和加载器依赖。overrides 内容会复制到实例根目录。

处理方式：保留 .mrpack 扩展名，直接导入。不要把它解压成普通文件夹。

7.3 MCBBS 整合包格式

常见扩展名：.zip

MCBBS v2 是历史上国内启动器常用的标准格式。常见识别文件包括：

mcbbs.packmeta
manifest.json
overrides/


HMCL 与 PCL2 都曾/仍提供该格式的兼容支持。由于它和 CurseForge 包同样可能以 .zip 结尾，不要只看扩展名判断格式，要看压缩包根目录的清单文件。

处理方式：通常不解压，直接导入。

7.4 HMCL、MultiMC 和其他启动器导出格式

还可能见到：

modpack.json # HMCL 类格式
mmc-pack.json # MultiMC/Prism 类格式
instance.cfg
.minecraft/


现代 HMCL 和 PCL2 对部分常见格式具有兼容能力，但是否成功仍取决于压缩包结构、加载器版本以及外部下载链接是否有效。

7.5 “完整客户端”或“解压即玩包”

这种包可能长这样：

整合包发布压缩文件.7z
└─ 整合包文件夹/ ├─ HMCL.exe 或 Plain Craft Launcher 2.exe ├─ .minecraft/ └─ 作者说明.txt


它与标准导入包不同。作者如果明确写着“先解压整个文件夹，再运行其中启动器”，就应先把最外层压缩包完整解压到普通目录，再运行。

注意：

• 不要直接在 WinRAR/7-Zip 的预览窗口里运行启动器；
• 不要只把 .exe 单独拖出来，旁边的游戏目录和配置也要保留；
• 完整客户端中的可执行文件风险更高，必须确认发布者可信；
• 如果完整客户端内部另有 modpack.zip 或 .mrpack，也可以考虑用自己的最新版启动器导入内层标准包。

7.6 如何判断到底要不要解压

• 你拿到的文件：.mrpack；通常做法：不解压，直接导入
• 你拿到的文件：根目录含 manifest.json 与 overrides/ 的 .zip；通常做法：不解压，直接导入
• 你拿到的文件：根目录含 mcbbs.packmeta 的 .zip；通常做法：不解压，直接导入
• 你拿到的文件：根目录含 mmc-pack.json 的 .zip；通常做法：不解压，尝试直接导入
• 你拿到的文件：作者明确写“解压后运行启动器”的 .7z/.rar/.zip；通常做法：完整解压最外层
• 你拿到的文件：解压后只有一个同名 .zip/.mrpack；通常做法：你可能下载了套娃包，应导入内层文件
• 你拿到的文件：解压后只有 mods/config/saves，无清单；通常做法：这是手动包，按作者说明复制；新手应优先找标准导入包

八、使用 HMCL 安装整合包

8.1 HMCL 适合哪些系统

HMCL 是跨平台启动器。官方提供 Windows 版本，以及适用于 Linux/FreeBSD、macOS 的构建。到 2026 年，HMCL 官方下载页标明：

• 普通 Windows 用户优先下载 Windows 版；
• Universal .jar 构建需要 Java 17 或更高版本来运行启动器本身；
• macOS 当前构建有相应系统版本要求，应以下载页实时说明为准。

这里要区分两件事：运行 HMCL 本身的 Java和运行某个 Minecraft 实例的 Java可以不是同一个版本。例如 HMCL 用 Java 17 打开，但 1.16.5 整合包仍可由 HMCL 指定 Java 8 启动。

8.2 下载与放置 HMCL

• 1. 打开 HMCL 官方下载页。
• 2. Windows 普通用户下载稳定版 Windows 构建。
• 3. 新建目录：

D:\Minecraft\HMCL\


• 4. 把下载的 HMCL 文件放入该目录后再运行。
• 5. 不要在压缩包、浏览器临时目录、系统目录中直接运行。
• 6. 若 Windows SmartScreen 提示，请先核对文件确实来自官方站点；不要对来源不明的副本强行放行。

macOS/Linux 用户若使用 .jar，需要先保证系统能用合适的 Java 打开它；官方 Universal 构建当前要求 Java 17+。游戏实例所需的 Java 可在 HMCL 内另行管理。

8.3 第一次运行与游戏目录

第一次打开后：

• 1. 选择简体中文。
• 2. 在“设置”中检查游戏目录。建议为整合包使用单独目录，而不是和其他启动器共用一个混乱的 .minecraft。
• 3. 开启版本/实例隔离，使每个实例使用独立的 mods、config、saves。
• 4. 在“设置 → Java 管理”保留自动选择。
• 5. 暂时保留默认下载源、线程数和 JVM 参数。

如果已经有重要存档，先备份再调整游戏目录或隔离设置。

8.4 添加账户

• 1. 点击主界面的账户区域。
• 2. 已购买游戏：选择“微软账户”，在微软页面完成授权。
• 3. 本地测试：选择“离线登录”，输入玩家名。
• 4. 回到主界面，确认当前选择的账户正确。

8.5 方法一：把本地整合包拖入 HMCL

这是最方便的方法。

• 1. 保持整合包为原始 .zip 或 .mrpack 文件。
• 2. 打开 HMCL 主窗口。
• 3. 从资源管理器把整合包文件拖到 HMCL 主页面。
• 4. 出现导入向导后，确认整合包名称和目标游戏目录。
• 5. 若向导识别出 Minecraft、Forge/Fabric/NeoForge 版本，保持默认值。
• 6. 点击安装/导入。
• 7. 等待游戏本体、加载器、依赖库和模组全部下载完成。

如果拖入没有反应，使用下一种菜单方法。

8.6 方法二：通过“导入整合包”入口安装

不同 HMCL 版本的入口可能显示为“新建游戏”“添加游戏”“新建实例”或加号按钮，常见流程是：

• 1. 在主界面打开新增游戏/实例菜单。
• 2. 选择“导入整合包”。
• 3. 选择“从本地文件导入”。
• 4. 找到下载好的 .zip 或 .mrpack。
• 5. 输入一个容易识别的实例名称，例如：

AllTheMods-1.20.1-原版配置
冒险包-1.21.1-NeoForge


• 6. 确认目标目录没有同名实例。
• 7. 开始安装并等待结束。

较新的 HMCL 还可能提供“从互联网下载整合包”的入口。它和下载页的逻辑相同：选择来源、项目和文件版本后安装为新实例。

8.7 方法三：在 HMCL 内搜索并安装

• 1. 打开下载/游戏内容页面。
• 2. 选择“整合包”。
• 3. 使用整合包英文名搜索通常更准确。
• 4. 核对项目作者、游戏版本、加载器和文件发布日期。
• 5. 打开文件列表，选择整合包作者推荐的 Release/稳定版本。
• 6. 点击“安装整合包”。
• 7. 输入实例名称并等待完成。

不要只看“最新版”三个字。一个项目的最新文件可能适用于另一个 Minecraft 大版本。

8.8 导入后的 HMCL 设置

• 1. 选中新实例，打开“实例管理/游戏设置”。
• 2. 检查加载器显示是否与发布页一致。
• 3. Java 保持自动；若错误则按第五章手动指定。
• 4. 内存按第六章和作者说明设置。
• 5. 不要第一次启动前批量更新模组。
• 6. 确认使用的是新实例，不是之前的原版实例。
• 7. 点击启动游戏。

8.9 HMCL 导入失败时先检查

• 压缩包是否完整；
• 是否把 .mrpack 改成了 .zip 或又套了一层压缩；
• 清单是否位于压缩包根目录，而不是 包名/包名/manifest.json；
• 目录是否包含 !、=、过长路径或特殊字符；
• 磁盘空间是否足够；
• 下载源是否暂时不可用；
• HMCL 是否为官方最新版稳定版；
• 是否有同名实例残留。

九、使用 PCL2 安装整合包

9.1 PCL2 的系统范围

PCL2（Plain Craft Launcher 2）主要面向 Windows。其他系统建议使用 HMCL 或适合该平台的启动器。

9.2 下载与放置 PCL2

• 1. 从 PCL 官方项目页 提供的官方链接获取正式版。
• 2. 新建目录：

D:\Minecraft\PCL2\


• 3. 如果下载的是压缩包，先完整解压；然后把 PCL 主程序放入该目录。
• 4. 双击启动，不要在压缩软件中直接运行。
• 5. 不要长期放在桌面、OneDrive、Program Files 或系统盘根目录。
• 6. 通常不需要“以管理员身份运行”。管理员权限反而可能使 Windows 阻止从普通权限的资源管理器向 PCL 窗口拖放文件。

9.3 第一次运行

• 1. 等待 PCL 创建自己的配置目录。
• 2. 检查游戏文件夹位置；建议使用 PCL 管理的独立 .minecraft。
• 3. 在“设置 → 启动选项”检查 Java 和内存，先保留自动设置。
• 4. 在登录区域添加正版或离线账户。
• 5. 保持版本隔离，尤其不要让多个整合包共用根目录下同一套 mods。

9.4 方法一：拖入本地整合包

PCL 官方帮助库给出的安装方式非常直接：

• 1. 下载好整合包文件，不要解压标准 .zip/.mrpack。
• 2. 打开 PCL 主窗口。
• 3. 把整合包文件从资源管理器拖入 PCL 窗口。
• 4. 输入版本/实例名称。
• 5. 点击“确定”。
• 6. 等待 PCL 安装 Minecraft、加载器、依赖和模组。
• 7. 返回主页面，在版本选择中选中新实例并启动。

如果鼠标显示禁止符号：

• 关闭 PCL；
• 确认没有勾选“以管理员身份运行此程序”；
• 以普通方式重新打开 PCL；
• 再从普通权限的资源管理器拖入。

也可以把整合包移动到 D:\Minecraft\Downloads\ 这类短路径后再拖入。

9.5 方法二：PCL 内置搜索并安装

根据 PCL 官方帮助库，常见流程为：

• 1. 点击顶部“下载”。
• 2. 在左侧“资源”分类中选择“整合包”。
• 3. 输入整合包英文名称。
• 4. 按来源、类型、Minecraft 版本和加载器筛选。
• 5. 打开项目，选择需要的文件版本。
• 6. 输入新实例名称并确认。
• 7. 等待安装完成。
• 8. 回到主页，从版本选择中选中新实例。

如果同名项目在 CurseForge 和 Modrinth 都有发布，优先使用作者项目页推荐的来源和文件版本。

9.6 导入后的 PCL2 设置

• 1. 在主页选中新导入实例。
• 2. 进入“版本设置”。
• 3. 检查 Minecraft 与加载器版本，保持整合包指定值。
• 4. 在“设置”中确认 Java 主版本。
• 5. 按作者建议设置内存。
• 6. 不要在“Mod 管理”里点击一键更新全部模组。
• 7. 返回主页启动。

9.7 PCL2 导入失败时先检查

• 是否真的把文件拖入窗口，而不是把解压后的文件夹拖入；
• PCL 是否以管理员身份运行，导致拖放被 Windows 阻止；
• 压缩包根目录是否存在 manifest.json、modrinth.index.json、mcbbs.packmeta 等识别文件；
• 是否下载了“服务器包”而不是“客户端整合包”；
• 是否为同名实例；
• 路径是否过长或含特殊字符；
• 下载依赖时是否有某个具体文件 403/404/超时；
• 当前 PCL 是否来自官方渠道并已更新。

十、第一次启动应该做什么

10.1 第一次启动很慢是正常的

第一次启动时，加载器可能会：

• 扫描全部模组；
• 生成或迁移配置文件；
• 建立资源缓存；
• 编译脚本；
• 处理数据包与资源包；
• 为显卡编译着色器；
• 在第一次进入世界时生成大量区块。

中大型整合包停留在加载界面几分钟并不罕见。只要窗口仍在响应、CPU/磁盘仍有活动、日志仍在更新，就先耐心等待。

不要连续点击“启动游戏”，否则可能同时开出多个 Java 进程。

10.2 第一次进入主菜单后的检查

进入主菜单后先检查：

• 左下角或模组页面显示的 Minecraft 与加载器版本是否正确；
• 模组数量是否与作者说明大致一致；
• 语言、分辨率、全屏和音量是否合适；
• 资源包是否按作者预设启用；
• 按键是否有大量冲突；
• 显卡是否选对，笔记本是否在使用独立显卡；
• 主菜单是否出现整合包自己的任务、指南或服务器入口。

然后正常退出一次，让配置完整写入磁盘。

10.3 建立测试世界

第一次不要立即打开唯一的重要存档。建议：

• 1. 创建一个临时测试世界。
• 2. 进入后等待 1～3 分钟。
• 3. 移动、打开背包、查看任务书、传送几个区块。
• 4. 正常保存并退出。
• 5. 再启动一次，确认能重新进入。

确认稳定后再导入旧世界。

10.4 旧世界迁移警告

把旧世界放入新整合包前必须备份。特别危险的情况：

• 跨 Minecraft 大版本；
• 更换 Forge/Fabric/NeoForge；
• 删除地形、维度、生物群系或方块模组；
• 更换整合包大版本；
• 旧世界使用实验性数据包。

世界一旦被新版本保存，通常不能安全降级。始终操作副本。

十一、客户端目录结构与日志位置

11.1 .minecraft 基础目录

典型结构：

.minecraft/
├─ assets/ # 声音、语言、纹理等官方资源
├─ libraries/ # Minecraft、加载器和依赖库
├─ versions/ # 各游戏版本/实例的核心文件
├─ launcher_profiles.json # 某些启动器使用的配置
└─ 其他启动器或全局文件


开启版本隔离后，某个实例的工作目录常见为：

.minecraft/versions/实例名称/


未隔离时，下面的 mods、config、saves 也可能直接位于 .minecraft/ 根目录。不要只凭固定路径猜，最好在启动器中对当前实例点击“打开游戏文件夹”。

11.2 单个整合包实例目录

常见结构：

实例目录/
├─ mods/ # 模组 .jar 文件
├─ config/ # 模组配置
├─ defaultconfigs/ # Forge/NeoForge 世界默认配置
├─ kubejs/ # KubeJS 脚本与资源（若整合包使用）
├─ scripts/ # CraftTweaker 等脚本（若使用）
├─ resourcepacks/ # 资源包/材质包
├─ shaderpacks/ # 光影包
├─ saves/ # 单人世界
├─ screenshots/ # 截图
├─ logs/ # 游戏运行日志
├─ crash-reports/ # 游戏生成的崩溃报告
├─ options.txt # 视频、声音、按键等游戏选项
└─ servers.dat # 多人服务器列表


部分文件夹不存在很正常，游戏或模组首次使用时才会创建。

11.3 最重要的日志

• 文件/位置：实例目录/logs/latest.log；用途：最近一次游戏运行日志，最常用
• 文件/位置：实例目录/logs/debug.log；用途：更详细日志；Forge/NeoForge 环境中常见，不一定每次都有
• 文件/位置：实例目录/crash-reports/crash-日期时间-client.txt；用途：Minecraft/模组主动生成的崩溃报告
• 文件/位置：实例目录/hs_err_pid数字.log；用途：JVM 或原生库崩溃，常与驱动、原生库、硬件、Java 有关
• 文件/位置：启动器导出的错误报告压缩包；用途：同时包含启动参数、启动器日志和游戏日志，求助时最方便

11.4 HMCL 日志

优先使用崩溃窗口中的“导出游戏崩溃信息/导出错误信息”。如果游戏没有生成崩溃报告：

• 1. 在 HMCL 中打开日志页面；
• 2. 导出本次游戏日志；
• 3. 在“设置”中使用“打开启动器日志文件夹”之类的入口；
• 4. 同时保存实例目录里的 latest.log。

11.5 PCL2 日志

优先在游戏崩溃后的分析窗口点击“导出错误报告”。此外可查看：

• 当前实例 logs/latest.log；
• 当前实例 crash-reports/；
• PCL 程序同目录下由它创建的 PCL 数据目录及其中的日志文件。

不同 PCL 版本的日志文件名可能变化，所以从界面导出比手动挑文件更稳妥。

11.6 日志不等于错误截图

“游戏崩了，退出代码 -1”几乎没有诊断价值。需要的是完整文本日志或启动器导出的压缩包。

不要只截最后三行。真正的根因可能在几百行之前的：

Caused by:
Failure message:
Mod File:
Suspected Mods:
Mixin apply failed
NoClassDefFoundError
OutOfMemoryError


十二、常见错误与对应解决办法

12.1 Java 不兼容

表现：

• 启动后立刻退出；
• UnsupportedClassVersionError；
• “Java 版本过高/过低”；
• Forge 安装器或加载器无法运行；
• 旧整合包在 Java 17/21/25 下出现反射、模块或参数错误。

解决：

• 1. 确认 Minecraft 版本。
• 2. 按第五章表格选择 Java 8/16/17/21/25。
• 3. 确认是 64 位 Java。
• 4. 在当前实例设置中指定，不要只改全局设置。
• 5. 清除自己添加的 JVM 参数，恢复启动器默认。
• 6. 重启启动器再试。
• 7. 若整合包作者指定了精确 Java 构建，优先按作者说明。

12.2 内存不足或分配失败

表现：

java.lang.OutOfMemoryError
GC overhead limit exceeded
Could not reserve enough space for object heap
系统卡死或频繁使用虚拟内存


解决：

• 1. 查看电脑总内存和当前可用内存。
• 2. 关闭浏览器、录屏、其他游戏和多余启动器。
• 3. OutOfMemoryError 时小幅增加 1～2 GB。
• 4. “无法保留堆空间”时反而要降低内存，并确认使用 64 位 Java。
• 5. 不要超过物理内存的合理范围。
• 6. 若 8 GB 电脑运行作者要求 8～12 GB 的包，降低画质通常也无法解决根本容量问题，应换轻量包或升级内存。

12.3 模组冲突、重复或缺少前置

表现：

DuplicateModsFoundException
Missing mandatory dependencies
Mod resolution encountered an incompatible mod set
Mixin apply failed
NoClassDefFoundError
某模组 requires 某前置版本


解决：

• 1. 回忆崩溃前是否手动添加、删除或更新过模组。
• 2. 还原整合包原始 mods、config、kubejs/scripts。
• 3. 检查新增模组的 Minecraft 版本和加载器。
• 4. 检查前置模组及其最低/最高版本。
• 5. 检查同一模组是否有两个不同版本文件。
• 6. 不要只看崩溃报告中的“疑似模组”；Mixin 报错中最后出现的模组未必是根因。
• 7. 若原版整合包能启动，添加模组后失败，用“二分法”排查：每次移除一半新增模组，逐步缩小范围。

二分法只应用于你后来新增的模组。不要把作者整套核心模组随意对半删除后继续进入重要世界。

12.4 Forge、Fabric、NeoForge 用错

表现：

• 启动器识别不到模组；
• Fabric 提示无法解析依赖；
• Forge/NeoForge 提示模组无效；
• 模组文件名中写着另一加载器；
• 进入游戏后模组列表数量异常少。

解决：

• 1. 在发布页确认整合包加载器。
• 2. 在实例设置确认实际安装的加载器。
• 3. 检查每个手动添加模组的下载页标签。
• 4. 删除放错的模组，恢复原包。
• 5. 不要尝试把整个 Forge 整合包“一键转换”为 Fabric/NeoForge。

12.5 整合包或依赖下载失败

表现：

Connection timed out
Read timed out
HTTP 403 / 404 / 429 / 5xx
hash mismatch
校验失败
下载速度为 0


解决顺序：

• 1. 暂停后重试一次，排除临时波动。
• 2. 检查系统时间、时区和日期是否正确。
• 3. 检查磁盘空间和目录写入权限。
• 4. 更新启动器到官方稳定版。
• 5. 在启动器设置中切换官方源/可用镜像源；不要盲目把并发数拉满。
• 6. 换一个稳定网络，或检查代理是否配置错误。
• 7. 若总是同一个文件 404，打开日志记录文件名和项目 ID；它可能已被作者删除或清单过期。
• 8. 回到整合包发布页下载更新版本，或向作者反馈。
• 9. hash mismatch 时删除该下载缓存，让启动器重新获取，不要直接忽略校验。
• 10. 若压缩包本身 CRC 错误，重新下载整包。

不要在不清楚许可证和版本关系时，随便从第三方站点找一个同名模组塞进去代替缺失文件。

12.6 中文路径、特殊字符或路径太长

表现：

• 文件明明存在却提示找不到；
• 原生库解压失败；
• Forge 安装失败；
• Java 参数被错误截断；
• 同一整合包在别人电脑正常，在当前用户目录失败。

解决：

• 1. 把启动器和游戏目录迁移到短英文路径：

D:\Minecraft\PCL2\
D:\Minecraft\HMCL\


• 2. 实例名暂时使用英文、数字、短横线。
• 3. 避免 !、=、引号、末尾空格和过长目录层级。
• 4. 避免 OneDrive 同步目录、桌面、临时目录。
• 5. 在启动器中重新指定游戏目录，不要只移动文件后仍让启动器指向旧位置。

移动前先备份 saves、screenshots、options.txt 和服务器列表。

12.7 显卡驱动、OpenGL 或原生库错误

表现：

GLFW error 65542 / 65543
OpenGL not supported
Pixel format not accelerated
EXCEPTION_ACCESS_VIOLATION
游戏有声音但黑屏
创建窗口失败


解决：

• 1. 确认显示器实际连接到要使用的显卡。
• 2. 笔记本在 Windows“设置 → 系统 → 屏幕 → 显示卡/图形”中，把 javaw.exe 设置为高性能显卡。
• 3. 从 Intel、NVIDIA、AMD 或电脑厂商官网安装适合型号与系统的正式驱动。
• 4. 重启电脑。
• 5. 临时关闭光影和高分辨率资源包。
• 6. 删除自己从网络下载并放进游戏/Java 目录的 opengl32.dll 等替换文件。
• 7. 确认 Java 架构与操作系统/CPU 匹配。
• 8. 查看是否生成 hs_err_pid*.log，其中会列出崩溃模块。

远程桌面、虚拟机和过老核显可能无法提供整合包所需的图形能力；驱动更新也无法把硬件变成它不支持的规格。

12.8 游戏卡在加载界面或“未响应”

先不要立即结束进程。

• 1. 查看任务管理器中的 CPU、内存和磁盘活动。
• 2. 打开 logs/latest.log，看末尾是否继续更新。
• 3. 首次启动可多等几分钟。
• 4. 若同一行重复很久，记录关键词。
• 5. 若内存已顶满，按内存章节调整。
• 6. 临时移除自己新增的光影、资源包和模组。
• 7. 把窗口模式、分辨率恢复默认；必要时备份后重命名 options.txt 让游戏重建。

12.9 退出代码 -1、1 或其他数字

退出代码通常只是“进程失败”的结果，不是原因。必须查看启动器分析、latest.log 和 crash-reports。

正确做法：

• 1. 在崩溃窗口导出错误报告；
• 2. 打开最新的崩溃报告；
• 3. 搜索 Caused by、Failure message、OutOfMemoryError；
• 4. 结合崩溃前刚做的改动判断。

12.10 有 latest.log，但没有 crash-reports

这并不奇怪。以下情况可能来不及生成 Minecraft 崩溃报告：

• Java 本身崩溃；
• 显卡驱动或原生库崩溃；
• 进程被系统/杀毒软件终止；
• 内存严重不足；
• 启动参数在进入游戏前就失败。

此时重点检查：

• 启动器导出的完整报告；
• logs/latest.log；
• hs_err_pid*.log；
• Windows 可靠性监视器/事件查看器中的故障模块；
• 杀毒软件隔离记录。

12.11 存档进不去，但主菜单能打开

可能原因： 缺失世界使用的模组、数据包错误、维度模组被删除、区块损坏、给世界升级/降级。

处理：

• 1. 立即复制整个世界文件夹，不要反复尝试原件。
• 2. 恢复整合包原始模组和配置。
• 3. 检查世界目录的 datapacks/。
• 4. 查看进入世界时新生成的 latest.log 和崩溃报告。
• 5. 如果错误指向缺失注册表、方块或维度，先恢复对应模组，而不是选择强制删除内容。
• 6. 只有在副本上使用存档修复工具。

12.12 杀毒软件拦截或文件自动消失

• 1. 查看隔离区和事件记录，记下具体文件名与检测名称。
• 2. 核对文件是否来自整合包官方发布页。
• 3. 检查作者公告和哈希。
• 4. 对确认可信的单个文件或专用游戏目录设置最小范围例外；不要永久关闭整个安全软件。
• 5. 若来源不明，删除整包并从官方渠道重新下载。

十三、通用排查流程（按这个顺序做）

发生问题时不要同时改十项设置。按下面顺序，每完成一步就测试一次，并记录结果。

第 1 步：保存现场

• 截下完整错误窗口；
• 导出启动器错误报告；
• 复制 latest.log、最新崩溃报告、hs_err_pid；
• 记下你最后一次成功启动之后做了什么。

第 2 步：确认装的是客户端包

发布页常同时提供：

• Client/客户端整合包；
• Server Pack/服务端包；
• Source/源码；
• Overrides/补丁；
• Update/增量更新。

普通玩家应下载客户端整合包。服务端包往往不能直接当客户端导入。

第 3 步：确认三个版本

把下面三项逐字核对：

Minecraft 版本：
模组加载器：Forge / Fabric / NeoForge / 其他
加载器精确版本：


不要只写“1.20”。1.20.1、1.20.4、1.20.6 不是同一个模组环境。

第 4 步：确认 Java

• 看启动日志中实际使用的 Java 路径和主版本；
• 按第五章表格纠正；
• 确认 64 位；
• 恢复默认 JVM 参数。

第 5 步：确认内存与磁盘

• 游戏分配值是否合理；
• 系统是否还有可用内存；
• 磁盘是否至少留有数 GB 空间；
• 系统盘是否因为缓存而满了。

第 6 步：撤销个人改动

按时间倒序撤销：

• 新增/更新/删除的模组；
• 新光影和资源包；
• 自定义 JVM 参数；
• 修改过的配置与脚本；
• 更换过的 Java、加载器或 Minecraft 版本。

第 7 步：使用短英文路径

把启动器和测试实例放到 D:\Minecraft\...，实例名用简单英文。不要在原目录上来回覆盖，先复制存档。

第 8 步：重新导入一个“干净实例”

不要直接覆盖坏掉的实例：

• 1. 给原实例改名为 包名-old。
• 2. 从原始整合包重新导入为 包名-clean。
• 3. 不加任何个人文件，直接启动。

结果判断：

• 干净实例能启动：问题来自个人改动或旧配置；
• 干净实例也失败：问题更可能是 Java、驱动、下载缺失、系统环境或整合包自身。

第 9 步：比较日志

比较成功/失败实例的：

• Java 路径；
• Minecraft 和加载器版本；
• 模组数量；
• 第一个 ERROR/FATAL；
• 最深层 Caused by；
• 崩溃前最后加载的模组或原生库。

第 10 步：带完整信息求助

如果仍无法解决，把第十五章列出的信息一次给全。不要只发“报错了怎么办”。

十四、备份、更新与迁移

14.1 哪些内容最值得备份

saves/ # 单人世界，最重要
screenshots/ # 截图
options.txt # 游戏与按键设置
servers.dat # 服务器列表
journeymap/、xaero/ # 地图数据，具体目录随模组变化
config/ # 你确实改过的配置
kubejs/、scripts/ # 自制脚本；普通玩家不要盲目覆盖新版


备份整个实例最省心，但不应把缓存、日志长期重复保存到无限增长。

14.2 更新整合包的安全做法

• 1. 阅读作者更新日志，确认是否支持旧世界。
• 2. 备份旧实例和世界。
• 3. 优先把新版本安装成新实例。
• 4. 先空载启动新实例一次。
• 5. 把旧世界的副本复制到新实例 saves。
• 6. 按作者要求迁移地图数据、按键或其他内容。
• 7. 确认稳定后再决定是否删除旧实例。

不要把新包 mods 直接覆盖旧包 mods。覆盖不会自动删除已被作者移除的旧模组，最容易留下冲突文件。

14.3 不要对整合包“一键更新全部模组”

整合包作者常锁定特定模组版本，因为：

• 新版可能改变配置格式；
• 模组之间只在特定组合上测试过；
• 脚本、任务和配方依赖特定版本；
• 新版可能更换加载器或前置；
• 世界数据迁移可能不可逆。

除非作者明确要求，保持整合包原始版本组合。

14.4 在 HMCL 与 PCL2 之间迁移

最稳妥方式不是搬整个 .minecraft，而是：

• 1. 在原启动器中导出受支持的标准整合包，或保留作者的原始安装包；
• 2. 在新启动器中导入为新实例；
• 3. 启动验证；
• 4. 单独迁移 saves、截图和必要设置。

如果直接复制实例文件夹，要特别检查新启动器的实例隔离方式和实际工作目录。两个启动器同时指向同一个正在使用的实例，可能互相改写配置。

十五、向他人求助时要提供什么

把下面模板填好，可以大幅提高别人定位问题的速度：

操作系统：Windows 10/11，64 位（请写具体版本）
CPU：
显卡及驱动版本：
物理内存：
启动器：HMCL / PCL2，版本号：
整合包名称与版本：
整合包下载页链接：
Minecraft 版本：
加载器及版本：Forge / Fabric / NeoForge ...
实际 Java 路径和版本：
分配内存：
问题发生阶段：导入 / 下载 / 启动 / 加载模组 / 进入世界
最后一次正常运行后做过的修改：
能否在全新干净实例复现：


同时附上：

• 启动器“导出错误报告”生成的完整压缩包；
• latest.log；
• 最新 crash-reports/*.txt；
• 若存在，hs_err_pid*.log；
• 错误窗口截图。

分享前删除或遮盖：

• 微软账户邮箱；
• 访问令牌、会话信息；
• 私服地址（若不希望公开）；
• 含真实姓名的 Windows 用户目录；
• 启动器账户数据库或认证缓存。

不要把日志粘成一张极长截图；上传原始文本或启动器导出的压缩包更容易搜索。

十六、参考资料

以下资料用于核对本教程中的界面入口、格式与 Java 版本要求：

• 1. HMCL 官方网站：功能与整合包格式支持
• 2. HMCL 官方下载页
• 3. HMCL 官方 FAQ：账户与 Java 管理
• 4. HMCL 官方稳定版更新日志
• 5. PCL 官方项目仓库
• 6. PCL 官方内置帮助库
• 7. PCL 帮助：整合包安装
• 8. Modrinth 官方 .mrpack 格式说明
• 9. CurseForge 官方：整合包导出结构与 manifest.json
• 10. CurseForge 官方：分享与导入整合包
• 11. Minecraft 1.18 官方更新说明：Java 17
• 12. Minecraft 1.20.5 官方更新说明：Java 21
• 13. Minecraft 26.1 官方更新说明：Java 25
• 14. NeoForge 官方用户指南：Java 与游戏版本对应

最后的新手检查表

启动前逐项打勾：

• [ ] 我下载的是客户端整合包，不是服务器包。
• [ ] 文件来自作者官方页或可信来源。
• [ ] 标准 .zip/.mrpack 没有被我提前解压。
• [ ] 启动器位于普通、可写、短英文路径。
• [ ] 我使用的是正确账户，并理解离线登录的限制。
• [ ] Java 主版本与 Minecraft 版本匹配，而且是 64 位。
• [ ] 内存没有分得过少，也没有占满整台电脑。
• [ ] Forge/Fabric/NeoForge 与整合包要求一致。
• [ ] 我没有在第一次启动前更新或添加模组。
• [ ] 我已经给重要存档做了独立备份。
• [ ] 出错时我会保存完整日志，而不只记录退出代码。

做到这些，绝大多数整合包都可以通过 HMCL 或 PCL2 顺利导入和启动。