CHOOSE YOUR WAY
选择安装方式
适用 Windows / Mac,Minecraft Java 版。
直接下载整合包
已含游戏和模组,解压即可配置。
下载 → 解压 → 设置名字 → 启动 ↘B · 自己动手从零安装 HMCL
自行安装启动器、游戏和模组。
Java → HMCL → 游戏 → 模组 ↘客户端配置:Minecraft 1.21.10 · Fabric Loader 0.18.4 · Java 21。
少找文件,早点开玩
直接下载整合包
从空文件夹开始
从零安装 HMCL
已用整合包?直接 加入服务器。
安装 Java 21
打开下载页,保持 21 LTS / JDK,根据电脑选择安装包。
下载 Java 21(Temurin 官方)↗Windows · Intel / AMDWindows → x64 →
.msi
双击安装,按提示完成。Mac · M 系列芯片macOS → aarch64 →
.pkg
双击安装,按提示完成。Mac · Intel 芯片macOS → x64 →
.pkg
双击安装,按提示完成。走整合包路线?装好 Java 后返回 A 路线 ↑不知道自己的电脑是什么芯片?
Mac:苹果菜单 →“关于本机”,看到 Apple M1/M2/M3/M4 等就是 M 系列,看到 Intel 就选 x64。Windows:设置 → 系统 → 系统信息,查看“系统类型”;ARM 处理器请选择 Windows / aarch64(ARM64)。
安装 HMCL,设置玩家名称
下载 HMCL ↗放入新建的
Minecraft文件夹,Windows 选.exe,Mac 选.jar。打开后添加“离线账户”。名称用小朋友姓名(含姓氏)的完整拼音,如
wangxiaoming,不加空格或声调,拼写和大小写须与白名单一致。安装游戏和 Fabric
- “设置 → 全局游戏设置 → 版本隔离”选各实例独立。
- “下载 → 游戏”选 1.21.10,Fabric 选 0.18.4。
- 名称填
1.21.10-Fabric,点击“安装”。 - Java 选本机 Java 21,启动至主菜单后退出。
安装 8 个模组
关闭游戏,在 HMCL 的“模组管理”中添加下列模组,使用与 1.21.10 匹配的 Fabric 文件,每个只装一份。
手动安装:查看对应版本
- Fabric API:版本 0.138.4+1.21.10 · Fabric
fabric-api-0.138.4+1.21.10.jar - Balm:版本 21.10.11 · Fabric
balm-fabric-1.21.10-21.10.11.jar - Waystones:版本 21.10.5 · Fabric
waystones-fabric-1.21.10-21.10.5.jar - Jade:版本 20.1.0 · Fabric
Jade-1.21.9-Fabric-20.1.0.jar - Just Enough Items (JEI):版本 26.2.0.30 · Fabric
jei-1.21.10-fabric-26.2.0.30.jar - AppleSkin:版本 3.0.7 · Fabric
appleskin-fabric-mc1.21.9-3.0.7.jar - Xaero's Minimap:版本 25.3.2 · Fabric
Xaeros_Minimap_25.3.2_Fabric_1.21.10.jar - Xaero's World Map:版本 1.40.2 · Fabric
XaerosWorldMap_1.40.2_Fabric_1.21.10.jar
Jade 和 AppleSkin 的指定文件标注 1.21.9,可用于这套 1.21.10 客户端。下载后在“模组管理 → 添加模组”中选中 JAR,无需解压。
启动并检查
进入游戏后,确认小地图、方块提示和背包物品列表正常,再 加入服务器。
装好以后,一起出发
加入 Shirley 的服务器
复制后在游戏里的“服务器地址”一栏粘贴。
- 确认玩家名称与白名单完全一致。
- 主菜单 → 多人游戏 → 添加服务器。
- 名称填 Shirley,地址粘贴上方内容,点“完成”。
- 选中 Shirley,点击“加入服务器”。
提示未加入白名单时,检查玩家名称;仍无法连接请联系管理员。
常见问题
HMCL 打不开
先安装 Java 21。Windows 可改用官网 EXE 版;Mac 可在终端输入 java -jar ,加一个空格,拖入 JAR 文件后回车。
提示 Java 错误
安装 Java 21 后重启 HMCL,在游戏设置中重新选择本机 Java 21。
模组报错或没有效果
确认启动 1.21.10-Fabric,核对 模组版本,每个只启用一份。仍报错时,将 HMCL 游戏日志和截图发给管理员。
无法加入服务器
核对玩家名称、白名单和完整服务器地址。提示版本不符或连接超时,请联系管理员。