启动器界面整体由顶部工具栏和页面容器构成。

顶部工具栏

提示

用户可以通过双击工具栏在最大化与普通窗口状态之间切换。

此区域为全局显示，共分为左右两部分。其中左侧由返回按钮（仅在二级或多级页面显示）和标题构成，右侧由帮助按钮、最小化按钮和关闭按钮构成。

返回按钮：点击后返回上一页，仅在二级或多级页面上显示，首页不显示。
标题：通常用于显示页面名称，首页显示为启动器版本信息。
帮助按钮：点击后跳转至文档帮助页面。
最小化按钮：点击后最小化启动器。
关闭按钮：点击后关闭启动器。

首页

首页是启动器的起始页面，该页面由侧边导航栏、提示面板（仅限开发版和预览版）、更新面板（仅在存在可用更新时显示）和启动游戏面板构成。

侧边导航栏（首页）

此区域共分为三部分：账户分组、游戏分组及通用分组。

账户分组：该分组中包含一个列表项，该项会显示当前选定的账户头像、名称及账户类型，用户点击该项可进入账户列表页面；右键点击该项可呼出账户切换的快捷菜单。

提示

用户在该项上滚动鼠标滚轮可在不同账户之间进行快捷切换。

游戏分组：该分组中包含三个列表项，分别是：实例管理、实例列表及下载。

• 实例管理：该项会显示当前选定的游戏实例图标及名称。用户点击该项后进入实例管理页面；在该项上滚动鼠标滚轮可在不同游戏实例之间进行快捷切换。
• 实例列表：用户点击该项后进入实例列表页面，用于查看和管理游戏实例。
• 下载：用户点击该项后进入下载页面，用于下载游戏、整合包或者安装模组、资源包、光影或者世界。

通用分组：该分组中包含三个列表项，分别是：设置、多人联机及官方群组。

• 设置：用户点击该项后进入设置页面。
• 多人联机：用户点击该项后进入多人联机页面。
• 官方群组：用户点击该项后跳转至设置·反馈页。

提示面板

提示

用户可通过点击右上角关闭按钮隐藏该提示。

仅在开发版或预览版中显示，用于提示用户当前启动器不是稳定版本。

更新面板

仅在存在可用更新时显示，此区域用于启动器更新提示。

启动游戏面板

此区域共分为两部分：启动（开始）游戏按钮、切换实例菜单。

启动（开始）游戏按钮：若用户当前存在实例，点击后则会启动当前应用的游戏实例；若当前不存在游戏实例，点击后会自动下载最新正式版然后启动游戏。
切换实例菜单：点击显示快捷切换游戏实例列表菜单。

设置

该页面由侧边导航栏和页面容器构成。

侧边导航栏（设置）

此区域共分为四部分：全局游戏设置、Java 管理、启动器分组及帮助分组。

全局游戏设置：用户点击该项后进入全局游戏设置页面。
Java 管理：用户点击该项后进入 Java 管理页面。
启动器分组：该分组中包含三个列表项，分别是：通用、外观及下载。
帮助分组：该分组中包含三个列表项，分别是：帮助、反馈及关于。

设置-全局游戏设置

注意：

使用 Steve、Alex、本地皮肤图片文件: 可能无法加入多人联机，其他玩家可能看不到您的皮肤
使用 LittleSkin、Blessing Skin 服务器: 多人联机下和您使用 相同方式 的玩家可以看到您的皮肤, 其他玩家不可以

打开HMCL, 进入 账号列表 , 点击下图离线账号的【上传皮肤】红框处:

默认: 使用默认随机的皮肤显示

Steve: 使用Steve (史蒂夫) 皮肤显示

Alex: 使用Alex (艾利克斯) 皮肤显示

本地皮肤图片文件、LittleSkin、Blessing Skin 服务器: 请见下文↓

本地皮肤图片文件

点击 本地皮肤图片文件 , 设置 皮肤/披风皮肤图片 路径, 点击 确认, 即可

LittleSkin

首先您需要一个LittleSkin的账号, 注册并登录

然后前往 角色管理, 查看您的角色名, 如果没有, 请点击 添加新角色 进行添加

你可在 我的衣柜 修改此账户名的皮肤与披风

在HMCL中创建的离线账户的 账户名 必须和角色名相等, 如果不相等, 请 重新在HMCL中创建离线账户

确认相等后, 点击 LittleSkin 即可同步在LittleSkin上此账户名的皮肤

Blessing Skin 服务器

Blessing Skin 服务器, 进入 **角色管理 , 查看角色名 , 确认 角色名 和 HMCL中创建的离线账号角色名 相同, 如果不相等, 请重新在HMCL中创建离线账户

你可在 我的衣柜 修改此账户名的皮肤与披风

进入 配置生成, 按下图找到 CustomSkinLoader 中的网址, 复制到HMCL中即可同步在Blessing Skin 服务器上此账户名的皮肤

在安装前，最关键的一点是兼容性。请记住以下核心原则：

• 通常，你只能为单个游戏实例安装一种模组加载器。
• 你下载的模组，必须同时兼容你的游戏版本（如 1.20.4）和模组加载器（如 Fabric）。

简单来说，为游戏安装模组总共分三步，本指南将带你逐一完成：

1. 开启版本隔离，为模组创建一个独立干净的环境。
2. 安装模组加载器（如 Forge, Fabric）。
3. 安装你喜欢的模组。

启用版本隔离

在安装模组之前，必须开启版本隔离以隔离为不同实例安装的模组：

在 HMCL 主界面，点击「设置」，在「全局游戏设置」选项卡中，找到「版本隔离」，点击「版本隔离」，选择「各实例独立」即可

更详细的介绍见 全局版本隔离

安装模组加载器

模组加载器简介

常见的模组加载器有以下几个：

Forge,NeoForge,Fabric,Quilt,Cleanroom,LiteLoader 是 6 个常见的 Mod 加载器。
Fabric API,QSL/QFAPI 是两个随 Fabric 与 Quilt 的官方 API（实际是模组）。

兼容性：

• LiteLoader 和 Forge 是兼容的 (Forge 较新版本和 LiteLoader 较老版本可能不兼容)，可以同时安装
• 其它所有模组加载器几乎互不兼容，即你无法同时安装两个模组加载器

Fabric与Quilt 说明：
非常多的 Fabric Mod 需要 Fabric API 作为前置模组， Quilt Mod 需要 QSL/QFAPI 作为前置模组。
在安装 Fabric 或 Quilt 加载器时候如果没有其它原因，建议安装 Fabric API 或 QSL/QFAPI , 否则很多 Fabric Mod 或 Quilt Mod 则有可能无法被加载!

安装新实例时安装模组加载器

当你在安装新的游戏客户端时候, 会看到其中有该版本支持的模组加载器安装选项，点击你想安装的模组加载器（根据你想安装模组所支持的加载器进行选择）

• 点击你想要的加载器（如 Fabric）。
• 在弹出的版本选择页面，若无特殊需求，选择最新稳定版（通常是第一个）。
• 如果你选择 Fabric 或 Quilt，最好同时安装Fabric API 或 QSL/QFAPI。
• 点击「安装」即可。

为已有实例安装或更换模组加载器

如果你想为已安装好的纯净版游戏添加加载器，或者更换、更新加载器版本：

1. 在 HMCL 主界面，点击「实例管理」，然后选择你想要修改的游戏实例。
2. 在左侧菜单中，点击「自动安装」。

• 安装：点击你想要的加载器图标（如 Forge），选择版本（推荐最新版），然后点击安装。
• 更新：点击已安装的加载器，选择一个更新的版本，然后点击安装。
• 删除：点击加载器右侧的「X」按钮即可删除。
• 更换：先删除旧的加载器，再安装新的。

注意：此处的自动安装页面不支持安装 Fabric API 或 QSL/QFAPI。请将它们当作普通模组进行安装。

安装模组

安装好加载器后，就可以开始添加模组了。你可以在下列网站获取模组信息，并在 HMCL 内下载和安装：

• MC 百科 - 中文社区，资料详尽。
• CurseForge - 最大的模组发布站之一。
• Modrinth - 新兴的现代化模组发布站。

在安装任何模组前，请先确认三件事：

1. 游戏版本：模组是否支持你当前的游戏版本？(例如, 1.20.4)
2. 加载器类型：模组是给 Forge、Fabric 还是其它模组加载器用的？
3. 前置模组：模组是否需要其他模组作为前置？（模组页面通常会说明）

自动安装 (推荐)

HMCL 内置了 CurseForge 和 Modrinth 的搜索和下载功能，非常方便。

1. 在 HMCL 主界面，点击「下载」->「模组」。
2. 在搜索框输入模组名（支持中英文），然后点击搜索。如果搜不到，可以尝试切换右上角的下载源。
3. 点击你想要的模组，进入版本列表页面。
4. 根据游戏版本和加载器，找到你需要的版本，点击并选择「安装到当前实例」。
5. 如果该模组有前置，HMCL 会自动提示，请先安装所有前置模组（但是请不要重复安装前置模组）。

注：点击模组下载页面 上方的蓝色的链接可以到对应的网站查看模组的信息，这会告诉你模组的功能和有可能会提示你一些注意事项

注意: 请查看你要下载的模组是否正常你要安装的游戏版本以及模组加载器，否则模组无法被正常加载!

安装OptiFine 或其它光影模组

光影的安装方式略有不同，请参考专门的指南 光影安装

手动安装

当你在网站或其它位置手动下载了模组文件，你可以参照以下步骤完成安装：

一般的 Mod 文件后缀为 jar 或者 litemod，请确认后缀是正确的。其中jar为大多数模组加载器支持的格式，litemod仅LiteLoader支持。

通过模组管理页面

1. 进入「实例管理」-> 选择你的游戏实例 ->「模组管理」。
2. 点击「添加模组」并选择你的模组文件，或直接将文件拖拽到窗口内即可。

通过模组文件夹安装

1. 进入「实例管理」-> 选择你的游戏实例 ->「浏览」->「模组文件夹」。
2. 这会打开该实例的 mods 文件夹。
3. 将你下载的 .jar 模组文件复制或移动到这个文件夹里。 （如果 mods 文件夹不存在，请自行创建一个。）

安装 Mod 后游戏报错/无法启动

造成游戏报错的原因有很多, 比如 Mod 之间不兼容, Fabric API 的版本过高, 缺少前置 Mod 等等。

第一步：基础检查（最常见问题）

• 查看 HMCL 错误报告：新版 HMCL 会直接提示大部分常见错误，这是你的首选信息来源。
• 检查兼容性：确认模组版本、游戏版本、模组加载器三者是否匹配。
• 检查前置模组：是否忘记安装必要的API（如 Fabric API）或其他前置模组？

第二步：自己排查

• 使用“二分法”：在“模组管理”页面，先禁用一半的模组，看游戏能否启动或出错。如果可以，说明问题出在被禁用的那一半里。不断重复此过程，直到找到引发问题的具体模组。
• 查看日志文件：如果你有能力，可以自行查看游戏日志来定位问题。

第三步：有效求助 如果无法自行解决，你需要向社区求助。但请记住，一个有效的求助包含完整的日志文件。

如何正确求助：

1. 在游戏崩溃后，点击 HMCL 弹出的错误窗口上的「导出游戏日志」按钮，它会生成一个 minecraft-exported-crash-info-时间戳.zip 文件。
2. 带着这个文件去社区、论坛或群里提问，并具体描述你遇到的问题。

重要：对于向他人求助，千万不要只截图，不要只说“游戏出错怎么办”这种及其笼统的话语。没有日志，谁也帮不了你。

补充：常见模组加载器简单介绍和支持版本一览

模组加载器简单介绍：

模组加载器	简单介绍
Forge	老牌的模组加载器，功能强大，支持的模组众多，推荐在1.21之前安装。
NeoForge	1.20.1后Forge的继任者，推荐在1.21版本后安装NeoForge。
Fabric	轻型模组加载器，非常适合安装优化模组或纯净生存增强类模组。
Quilt	Fabric的一个分支，同样轻量。
Fabric API QSL/QFAPI	由于Fabric和Quilt比较轻功能有限，因此提供了增强功能的api，很多模组依赖于此api。
Cleanroom	1.12.2版本Forge的一个优化代替，提供了相对更强的功能，仅支持1.12.2。
LiteLoader	轻量模组加载器，为Forge的轻量代替，现在已停止维护。

支持版本一览：

模组加载器	最老版本	最新版本
Forge	1.5.2	游戏最新版本
NeoForge	1.20.1	游戏最新版本
Fabric	1.16.3	游戏最新版本
Fabric api	1.16.3	游戏最新版本
Quilt	1.16.3	游戏最新版本
QSL/QFAPI	1.18.2	1.21
Cleanroom	1.12.2
LiteLoader	1.5.2	1.12.2

HMCL 提供了一些 JVM 选项用于调试目的。你可以通过在启动 HMCL 时添加这些参数来使用这些功能。

环境变量

HMCL/HMCLauncher 也支持一些环境变量来配置启动器的行为。你可以在系统环境变量中添加这些变量。

如何使用 JVM 选项

你可以通过以下几种方式使用这些 JVM 选项。

方法一：直接在命令行中添加

在启动 HMCL 时通过命令行添加参数，例如：

java -Dhmcl.home="D:/Games/HMCL" -jar HMCL.jar

方法二：创建启动脚本

1. Windows 用户可以创建 .cmd 文件：

   @echo off
   java -Dhmcl.font.override="Microsoft YaHei" -jar HMCL.jar
   pause
   

2. Linux/macOS 用户可以创建 .sh 文件：

   #!/bin/bash
   java -Dhmcl.font.override="Noto Sans CJK SC" -jar HMCL.jar
   

使用注意事项

• 可以同时使用多个参数，只需要用空格分隔
• 包含空格的参数值需要用半角引号包裹
• 确保 JVM 参数位于 -jar HMCL.jar 之前

如何使用环境变量

Windows 设置环境变量

1. 右键点击“此电脑”/“这台电脑”/“我的电脑”，选择“属性”
2. 点击“高级系统设置”
3. 点击“环境变量”
4. 在“用户变量”或“系统变量”中点击“新建”
5. 输入变量名（如 HMCL_JAVA_HOME）和变量值
6. 点击“确定”保存

示例值：

变量名: HMCL_JAVA_HOME
变量值: C:\Program Files\Java\jdk-17

Linux/macOS 设置环境变量

1. 编辑你的 Shell 配置文件（比如 ~/.bashrc、~/.zshrc 等）
2. 添加 export 语句：

export HMCL_JAVA_HOME="/usr/lib/jvm/java-17-openjdk"
export HMCL_JAVA_OPTS="-XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15"

1. 保存文件并重新加载配置：

   source ~/.bashrc  # 或 `source ~/.zshrc`
   

使用注意事项

• 设置环境变量后需要重启 HMCL 才能生效
• 如果同时设置了 JVM 参数和环境变量，JVM 参数优先级更高
• Windows 用户注意使用半角分号（;）分隔多个路径
• Linux/macOS 用户注意使用半角冒号（:）分隔多个路径

我们发现，某些账户在尝试通过非密码方式登录时，可能会遇到设备代码流授权问题，从而无法成功登录。而建议这些用户改用密码登录后，他们的登录成功率显著提高。

如何使用密码登录微软账户

• 在执行登录操作时，注意检查登录页面是否有“其他登录方式”的选项。一旦看到此选项，立即点击进行选择。

• 在登录页面，系统会询问您希望采用哪种登录方式。此时，需要选择“使用我的密码”，然后输入密码完成登录。

如果没有“使用我的密码”选项，或者忘记了密码，请看 下方教程

添加/更改密码

部分账户可能并未设置密码登录，或者忘记了密码，请按照以下步骤进行操作：

• 前往 添加/更改密码 页面；

• 在该页面按照指示添加密码即可。若忘记密码，可选择该页面“忘记密码了?”选项进行找回密码操作。

完成上述操作后再按照 上方教程 操作即可使用密码登录微软账户。

本篇文章将从”全局游戏设置”, “通用”, “外观”与”下载”这几个维度, 详细的为您介绍HMCL设置中各个选项的作用, 对于一些能够”见名知意”的条目, 在本篇文章中不过多讨论.

约束与注意

本篇文章是在 HMCL-3.5.3.230 版本中编写的, 如果您使用的是旧版本, 请注意有些选项可能不存在.

全局游戏设置

这是 HMCL 中的第一个设置项, 也是最重要的设置项之一, 它决定了 HMCL 在启动游戏时的行为.

Java路径

众所周知, Minecraft 是由 Java 编写的, 因此在启动游戏时 HMCL 需要知道 Java(JRE¹) 的安装路径才能启动游戏.

由于 HMCL 本身就是一个 Java 程序, 一般能正常启动 HMCL 就能至少在计算机上找到一个 JRE. 但也会由于一些未知因素导致无法找到 JRE, 这时, 就需要手动指定 JRE 的安装路径.

我们先来讨论能够自动识别的情况:

在 HMCL 启动时, 会根据注册表项, 环境变量, 以及 HMCL 自身的启动路径²来寻找 JRE. 如果找到了, 就会在 “Java路径” 这一栏显示出来, 并且在启动游戏时使用这个路径.

上述的情况几乎涵盖了所有, 如果你希望 HMCL 能够自动找到 Java, 就应该使用这些技巧配置好你的计算机环境.

接下来我们讨论不能自动识别的情况:

通常我们安装解压版本的 JRE 都不会被 HMCL 自动找到, 这时, 就需要手动指定 JRE 的安装路径. 你可以展开 “Java路径” 条目(通常是点击条目右侧的三角), 在展开的下拉列表中选中”自定义”条目后点击右侧的文件夹图标, 在弹出的对话框中选择你 Java 可执行文件的路径.

自动选择合适的 Java

在1.16.5版本后, Minecraft 的最低支持 Java 版本从 8 提升到了 16. HMCL 可以在已添加的版本中找到最合适的 Java 版本, 并在启动游戏时使用这个版本. 整个过程不需要人力介入.

版本隔离

这是当前主流启动器都支持的功能, 这个功能能够在尽可能共享依赖库的前提下, 将不同的游戏版本隔离开来, 避免你安装的模组加载器被应用在错误的版本上或是加载到不兼容的版本, 同时最大程度的减少磁盘占用.

此功能的底层原理不在此处过多赘述, 对于用户来说最大的区别就是游戏的实际目录发生了改变, 例如: 提取游戏日志的方式³被改变了

原本游戏目录默认应该在 .minecraft 文件夹, 但在开启版本隔离后, 你实际的游戏目录被切换到了 .minecraft/versions/游戏版本名称, 这会给一些新手或是习惯于使用正版启动器的玩家带来额外的困惑.

通常来说, 只要你玩的不是未修改过的版本, 都应该打开版本隔离避免引发错误, 这也能在你删除某个游戏版本时将日志等数据一并清除.

游戏内存

这与你计算机上的 RAM 存储器容量有关, 一般来说选择 “自动分配内存” 选项会得到一个相对合适的值. 但也许会有一些 CPU 性能较差希望用内存来交换的玩家愿意分配更多的内存.

但我告诉您, 这里只是在调整 JVM⁴ 能够使用的最大内存容量, 只有在模组 / Minecraft 官方开发者没有手动控制 GC⁵ 行为的时候, 才能如你预期的通过内存交换 CPU 时间

启动器可见性

这个条目有 4 个选项, 分别是:

• 游戏启动后结束启动器
• 游戏启动后隐藏启动器
• 保持启动器可见
• 隐藏启动器并在游戏结束后重新打开

游戏启动后结束启动器

这个选项特别推荐低性能机器使用, 这能节约一些计算机消耗. 代价是启动器无法很好的捕捉您的游戏崩溃信息与日志.

游戏启动后隐藏启动器

这个选项会在您游戏崩溃时收集您计算机上的相关崩溃信息以供向相关开发人员进行反馈. 代价是需要额外消耗一些计算机资源.

保持启动器可见

这个选项会在整个游戏过程中保持启动器可见, 这会在需要同时启动多个游戏的时候起到帮助. 代价是要消耗更多的计算机资源.

隐藏启动器并在游戏结束后重新打开

如果您需要频繁的在不同版本中切换游戏, 例如测试您的模组兼容性, 评估各版本之间的信息, 那么这个选项将会起到一定的帮助作用.

游戏参数

关于这点, 我没有找到更多的, 能与游戏同时使用的启动参数

JVM参数

调整JVM参数能够更细腻的控制 JVM 的行为, 例如是否压缩指针(用 CPU 换内存), 是否频繁 GC(还是用 CPU 换内存)等等, 这些一般都可以通过类似于这篇文章⁶这样进行调整. 不过要注意的一点是, JVM 参数是由实际实现决定的, 是否使用以及是否支持还要看具体的 JVM 实现.

本地库路径

在一些例如M1芯片之类的设备上, 通用库类可能都不能正常的工作, 要使用版本特殊提供的库类才能令其正常的工作, 你可以使用这个选项对其进行替换

GLFW

GLFW是一个轻量级的C语言库，用于创建和管理 OpenGL 在多个操作系统中的上下文，处理用户输入，以及获取时间和帧缓冲。它支持多个窗口、全屏模式、窗口模式、多个输入设备和剪贴板。GLFW是一个独立于操作系统的库，可以在 Windows, MacOS, Linux 等多个平台上使用。

在Linux下，系统自带的窗口管理器（例如 xorg）通常已经包含了可以与 OpenGL 集成的窗口管理器。因此，使用系统自带的窗口管理器可以避免与其他项目的库冲突，并确保对于系统提供的功能和特性有最好的支持。此外，使用系统自带的窗口管理器也能够最大限度地减少安装和配置上的复杂性。

故此, Linux 玩家推荐使用系统自带的

OpenAL

OpenAL 是一个跨平台的 3D 音频 API，可以用于在多个操作系统上播放音效和音乐。它支持的特性包括定位、重放、3D 效果、回声、滤波等。可以使用 OpenAL 提供的函数对声源和听者的位置、方向、速度等进行控制，以实现 3D 音频效果。

在 Linux 下 OpenAL 通常可以与 ALSA（高级 Linux 音频体系结构）或 PulseAudio（一种现代的音频子系统）进行集成。使用系统自带的音频支持库，可以确保应用程序与底层音频硬件和设备之间的兼容性，并提供最佳的音频性能和功能。此外使用 OpenAL 也可以让应用程序具有跨平台的特性，可以在多个操作系统上使用相同的代码和资源来实现音频效果。

故此 Linux 用户推荐使用系统自带的

通用

这里提供了一些 HMCL 的通用参数, 例如启动器是否自动检查更新, 文件下载的缓存目录存放位置, 程序界面的显示语言等. 这些基本都属于 “见名知意” 的范畴, 不需要过多讨论.

外观

这里提供了一些 HMCL 的外观参数, 例如启动器的主题颜色, 动画显示, 背景图片, 字体等. 这些基本都属于 “见名知意” 的范畴, 不需要过多讨论.

下载

下载源

由于网络环境问题, 在之前下载 Minecraft 可能是一件麻烦事, 但在现在, 我们有了 BMCLAPI⁷ 项目, 该项目无偿为大陆地区用户提供 Minecraft 相关文件的镜像. 但有可能存在延迟, 可以按照自己的需求进行选择.

下载并发数

提高下载并发数能够最大限度的利用您的网络, 但这不是越高越好的. 提高并发数量会对您的计算机和下载源都带来更高的负载, 由于木桶效应的存在, 本地下行带宽, 下载源上行带宽, 您的磁盘读写速度等这过程中的任何一环都会成为下载途中的瓶颈, 所以不要盲目提高并发数, 推荐的家庭带宽并发数在 8~16 之间.

代理设置

用于解决部分网络不佳或需要连接特殊网段的工具, 能够连接到内网服务器之类的.

特别鸣谢

• huangyuhui
• GitHub Copilot

参考文章

但在本文档中，通过一些简单的操作就可以同时安装 Fabric & OptiFine 的客户端。

原理是安装 OptiFabric 这个 Fabric 模组，该模组的作用是采用官方的 OptiFine 并在运行时与 Fabric 兼容来实现这一点。

如果你使用 OptiFine 纯粹是为了提高性能、使用缩放按钮或动态照明，那么还有其他模组可以单独实现这些功能，具有更可靠的兼容性。

操作方法

1.先选择一个版本，并选择 Fabric ，并安装。

注：如果你想放置其他的 Fabric 模组，建议一并安装 Fabric API ，有些 Fabric 模组会依赖他。

2.获取并安装 OptiFabric 模组 & OptiFine

获取

• 1）获取 OptiFabric ，可以在他的 MC百科下载页面（推荐） CurseForge 页面 或在 HMCL 的模组搜索中下载

MC百科下载页面（推荐）

CurseForge页面 下载操作：

HMCL 模组搜索下载操作：

注：如果你在HMCL模组搜索中下载时，另存该模组，那么就需要按照下面的模组安装方法来安装。

• 2）获取 OptiFine ，可以在他的 页面 或非官方 中文页面 中可以下载

OptiFine 页面 操作：

OptiFine 非官方 中文页面 操作：

安装

进入 要安装模组的游戏版本 的 游戏管理 ，切换到 模组管理 ，在这个页面将 OptiFabric 模组 & OptiFine 添加即可

然后在 模组管理 中检查是否有 OptiFabric 模组 & OptiFine !

检查完后，至此就完成啦，直接启动游戏即可。

方式一: 全新安装

当你在安装新的游戏客户端时候，会看到有个 OptiFine 的选项。

点开之后会看到有 3 个复选框，一般而言，正式版 会比 测试版 更加稳定。选择安装 正式版 ，如果没有 正式版 那么再考虑 测试版 。

选择完合适的版本之后就可以点击右下角的安装继续进行安装。

方式二: 修改/升级已安装版本

在对应的游戏版本管理页面，点击 自动安装 ，你会看到有个 OptiFine 的选项。

点开之后选择合适的版本然后等待安装完成即可。 目前，如果要在 Fabric 使用 OptiFine ，需要通过 方式四 安装。

方式三：官网安装

在 OptiFine 官网上下载合适版本的 OptiFine (下载完应为 OptiFine_<游戏版本>_<OptiFine版本>.jar ) 。

双击打开或者使用 java -jar 文件名 的方式打开，然后你就会看到这个界面。

选择自己游戏的 .minecraft 目录（默认安装到 \AppData\Roaming\.minecraft 目录下），然后点击 Install 按钮，之后你在 HMCL 的版本列表中就可以找到含有 OptiFine 名字的客户端，启动即可。

如果未找到，请确认你是否已安装对应的版本的客户端，且 命名为对应版本号 的原本游戏客户端。

方式四：OptiFine 与 Mod 加载器共存

从 OptiFine 官网上下载的 Jar 文件本身也可作为 Mod 被加载，可以用 Java 运行下载的文件并导出 Mod 版本。Mod 安装具体方法见 Mod 安装教程

注意：

1. Fabric 和 OptiFine 本身并不能共存，必须同时安装 OptiFabric (一个 Fabric Mod ) 。 OptiFabric 目前 1.17 仅支持 OptiFine HD U G9 ，Fabric 最高支持的版本为 0.11.7 。

2. Forge 和 OptiFine 会出现不兼容的情况，但大多数情况下，Forge 和 OptiFine 是相互支持的。在 OptiFine 官网下载页面 可以查看OptiFine与Forge的兼容情况，位置见下图的红框位置。

1. 若出现不兼容的情况，请使用 OptiForge (一个 Forge Mod ) 或者等待OptiFine兼容Forge解决。

安装Oculus（一个 Forge Mod）

在高版本的OptiFine中，OptiFine与mod的兼容性较差，以及对性能提升较小，所以可以安装Oculus，但Oculus与OptiFine不兼容，注意依赖关系，Oculus需要前置Rubidium

相关链接： Oculus Curseforge ， Oculus Modrinth ， Rubidium Curseforge ， Rubidium Modrinth

安装Iris Shaders（一个Fabric/Quilt Mod）

在Fabric中，也可以安装Iris Shaders来安装光影，注意依赖关系，Iris Shaders需要前置Sodium

相关链接： Iris Shaders官网 ， Iris Shaders Modrinth ， Iris Shaders Curseforge（不再更新，请到官网或Modrinth下载最新版本） ， Sodium Modrinth ， Sodium Curseforge（不再更新，请在Modrinth下载）

安装光影包

一般光影是一个 Zip 格式的文件，将光影文件放入 \.minecraft\shaderpacks 文件夹中即可 (没有这个文件夹就自己新建一个) 。如果开了版本隔离，那么文件夹是 \.minecraft\version\<客户端名称>\shaderpacks。若你不知道游戏文件夹在哪，在HMCL中打开游戏文件夹。

如果你不知道版本隔离是啥，也不会创建文件夹，那么请打开游戏，依次点击 设置—视频设置—光影—光影包文件夹 ，在里面放入光影包，然后点击你要加载的光影，最后点击 完成 即可

注意：光影对于电脑配置的要求比较高，如果开了光影之后出现游戏画面很卡的情况，请升级电脑配置、使用低配置光影或者关闭光影。

使用方式

进入 hmcl 的 设置

在全局游戏设置中找到 版本隔离 并设置为 各实例独立

这时候 minecraft 的文件结构就会有所改变，如下方

.minecraft
├── asstes
├── libraries
└── versions
    └── 1.16.5-optifine
        ├── 1.16.5-optifine.jar
        ├── saves
        ├── resourcepacks
        ├── logs
        ├── mods
        └── ...

并非在 .minecraft 文件夹中存储一切的 mod 和 资源包而是各版本的资源互相独立

这样你就可以在一个目录下，安装多个客户端

往后的使用

在做完版本隔离的设置后，hmcl 的快速打开各个游戏文件夹的功能就会显得十分好用。

善用该功能也可为你的磁盘剩下不少的空间，现在反思过来其实都差不多

建议

始终建议你使用多数据包格式制作数据包压缩包，因为 HMCL 会删除重名的数据包，因此可以借此完成更新功能，只要直接导入新的多数据包格式的压缩包就可以完成更新你制作的数据包。

多数据包

如果你的数据包被分离成多个部分供玩家选择是否启用，或者需要自带资源包，那么你需要制作多数据包格式的压缩包。

多数据包文件（只能是一个 .zip 文件）格式例子如下：

crafting++.zip
\
* datapacks
  |\
  | * block_sky_domain (一个合法的数据包)
  | * crafting_machine
  | * craftingpp
  | * tradepp
  | * utilitypp
  |
* resources.zip (如果你的数据包需要附带材质)
  \
    * assets
      \
        * ...

其中，datapacks 下的文件格式和 .minecraft/saves/New World/datapacks 的一样，因此可直接手动打包你本地的 datapacks 文件夹， 就可以直接导入 HMCL 了。如果还需要资源文件，请在压缩包内附带上。

此外，resources.zip 文件的格式和 .minecraft/saves/New World/resources.zip 的格式一样， 导入数据包时，启动器将会合并世界附带的默认资源包和你的数据包附带的资源包，如果有重复的文件，旧的文件将被覆盖。 如果你的服务器使用了包含资源包的数据包，那么请在服务器上完成这个操作，接着玩家下载服务器资源包即可。

单数据包

如果你的数据包不需要资源文件，那么你直接打包 datapacks/<你的数据包名称> 文件夹，即可直接导入 HMCL。

单数据包文件（只能是一个 .zip 文件）格式例子如下：

RealisticGlassPane.zip
\
* pack.mcmeta
* data
  \
    * 一些文件

HMCL 将会将你打包好的数据包压缩包直接复制到 datapacks 文件夹，不会解压（因为原版游戏支持读取压缩包）。