// 启动无响应
按下 Windows + R 键。输入 cmd，回车。在黑色窗口中输入下面一行内容，回车。
set HMCL_LAUNCHER_VERBOSE_OUTPUT=true
然后，将启动器拖入黑色窗口，回车。
等到报错出现，截图黑色窗口输出的内容。如果有个页面无法同时截下来，请分次截图
// 日志
出现问题后不要退出启动器，在启动器的 设置 -- 通用 中导出启动器日志，然后把导出的文件发出来 https://img.kookapp.cn/assets/2023-01/oHQeKnzwWj0md0dr.png
// 最新测试版（预览）
回到启动器首页，进入设置 - 通用，在「启动器更新」中选中「开发版」，并勾选「提前预览 HMCL 版本」。之后，请回到启动器主页按照界面提示升级启动器到最新测试版（预览）。
// 自动选择下载源
回到启动器首页，进入设置 - 下载，勾选自动选择下载源，并将「版本列表源」更改为「选择加载速度快的下载源」，重启 HMCL，然后再试一次
// 手动镜像源
回到启动器首页，进入设置 - 下载，取消勾选自动选择下载源，并将「下载源」更改为「BMCLAPI」，重启 HMCL，然后再试一次
// 游戏崩溃HMCL
游戏崩溃后在崩溃界面点左下角「导出游戏崩溃信息」（不要点「日志」），然后把导出的压缩包整个发上来 https://img.kookapp.cn/assets/2023-01/Bw9D08fUJ10m60e7.png
// 未响应
游戏卡住了吗？
你按这个教程 https://hmcl-helper.cn/guide/event 看一下系统里的「事件查看器」里的「Windows 日志」--「应用程序」里有没有显示「错误」的项目
把「查看日志」打开再启动游戏，如果日志界面一直在滚动，那就说明没卡住，只需要一直等着就行了；如果卡住了不滚动，那就先不要退出游戏，点日志界面右下角的「导出」和「导出游戏运行栈」，然后把导出的两个文件发出来 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-06/06kkZoEmeP0m2061.png https://img.kookapp.cn/assets/2023-06/mxJBSKy89i0mc0dp.png
导出游戏运行栈不兼容就下载这个工具 https://cdn.crashmc.com/https://github.com/burningtnt/JStack-Minecraft/releases/download/V9/JStack.Minecraft.v9.zip 下载好之后全部解压，然后当游戏未响应的时候运行其中的 Run_Windows.bat，等到弹出的黑色窗口中显示 Finish 的时候，把之后弹出的文件预览窗口中选中的文件发上来
// latestlog
发一下游戏文件夹里的 logs 文件夹里的 latest.log 文件 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-03/t5TMrzrjWD0990co.png
// 网络通讯日志
在游戏文件夹下面新建 log4j2-personal.xml，然后打开一个记事本，将新建出来的 .xml 文件拖入记事本中，粘贴 https://www.kdocs.cn/l/cr9KBBJfvOkT 这份文档中代码块里面的数据（点界面上复制就好），然后，进入游戏设置 - 高级设置，找到 Java 虚拟机参数，改为 -Dlog4j2.configurationFile=./log4j2-personal.xml 之后，重启游戏等到再次崩溃的时候，发一下游戏文件夹里的 logs 文件夹里的 latest.log 文件 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-03/t5TMrzrjWD0990co.png
// 陶瓦联机
Terracotta | 陶瓦联机是基于纯 p2p 技术构建的，在较差的 NAT 环境下可能需要一段时间才能建立数据隧道。（参见 https://easytier.cn/guide/aboutp2p.html ）如果一直无法成功联机，可选用其他联机方式
// 分页
下载运行这个程序 https://img.kookapp.cn/attachments/2024-06/20/66744a8919d2d.bat ，然后在桌面右键此电脑 -- 属性 -- 高级系统设置，然后按图里的样子把虚拟内存换到其他剩余容量大于 80GB 的盘里（初始大小 1024，最大值 65535），改完之后点一下「设置」，然后点三个「确定」（不要点右上角的叉），最后重启电脑 https://img.kookapp.cn/attachments/2024-03/18/7UFIGwSSXv0zy0gc.png
// 编码
在 控制面板 -- 时钟和区域 -- 区域 -- 管理 -- 更改系统区域设置 里面上面选「中文（简体，中国）」，并且把下面那个勾去掉 https://img.kookapp.cn/assets/2023-03/zsLRF3LrcD0we0hj.png
// 列出
按下 Windows + R 键，输入 cmd, 按回车，在弹出的黑色窗口中输入下面这一行命令，并按回车，截图：
for /F "delims=" %p IN ('where java') do @(echo PATH: %p&"%p" -version&echo;&echo MODULE: javafx.base&"%p" -d javafx.base||echo [Illegal Exit Code %errorlevel%]&echo;&echo;)
// SSL
你试一下在系统环境变量里新建一个键是 JAVA_TOOL_OPTIONS，值是 -Djavax.net.ssl.trustStoreType=WINDOWS-ROOT 的环境变量，然后重启电脑
// Java 8
在启动器主页进入实例管理，展开游戏 Java，勾选“指定 Java 版本”并设置为 8
// Java 11
在启动器主页进入实例管理，展开游戏 Java，勾选“指定 Java 版本”并设置为 11
// Java 17
在启动器主页进入实例管理，展开游戏 Java，勾选“指定 Java 版本”并设置为 17
// Java 21
在启动器主页进入实例管理，展开游戏 Java，勾选“指定 Java 版本”并设置为 21
// Java 8 312
在启动器中按图里的操作顺序把 Java 路径改成 1.8_312 64 位版本 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-05/jGd3akLJRP0me0b7.png
如果你找不到这样的版本，下载安装这个 Java https://download.bell-sw.com/java/8u312+7/bellsoft-jre8u312+7-windows-amd64-full.msi ，并重启电脑！安装时不要修改任何选项，比如安装路径！，之后就能找到了
// mixin out
在游戏设置里的「Java 虚拟机参数」里加 -Dmixin.debug.export=true（参数最前面的横杠不要漏掉），启动游戏，崩溃后把游戏文件夹下的 .mixin.out 文件夹里的 classes 文件夹打包发过来 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-06/06kkZoEmeP0m2061.png https://img.kookapp.cn/assets/2023-07/DAVItvJ3Z90mc093.png https://img.kookapp.cn/assets/2023-06/B9zltUBaco08d03p.png
// mixin dump
在游戏设置里的「Java 虚拟机参数」里加 -Dmixin.dumpTargetOnFailure=true（参数最前面的横杠不要漏掉），启动游戏，崩溃后把游戏文件夹下的 .mixin.out 文件夹打包发过来，同时也把我说的存在冲突的那个 mod 发过来 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-06/06kkZoEmeP0m2061.png https://img.kookapp.cn/assets/2023-07/DAVItvJ3Z90mc093.png https://img.kookapp.cn/assets/2023-06/B9zltUBaco08d03p.png
// ID
用户 ID 只能用大小写英文字母，数字和下划线
// notbuilding
在游戏文件夹里的 config 文件夹里找到 forge.cfg ，用记事本或者其他代码编辑器打开，把里面的 allowEmissiveItems 后面从 true 改成 false，改完后保存并启动游戏即可 https://img.kookapp.cn/assets/2023-03/t5TMrzrjWD0990co.png
// 显卡
你按教程里的步骤截个显卡型号的图看看 https://jingyan.baidu.com/article/9080802219bcfcbc91c80fe0.html
// NVIDIA 独显
在 NVIDIA 控制面板里按图里顺序改成「高性能 NVIDIA 处理器」，然后点下面的「应用」，最后重启电脑 https://img.kookapp.cn/assets/2023-06/LHqkHeKbD90pr0aw.png 不改全局设置也可以，选择 “程序设置”，添加游戏进程所用的 java 并设置为高性能
// AMD 独显
打开这个网页：https://www.amd.com/zh-hans/support 下载「Windows® 10/11 驱动程序自动检测并安装的更新程序」。然后运行它，按照界面提示把你 AMD 显卡驱动升到最新
// 软渲染器
在启动器的游戏设置里的高级设置里把渲染器选成软渲染器 https://img.kookapp.cn/assets/2023-04/SuAn2sjIow0md0b6.png https://img.kookapp.cn/assets/2023-06/06kkZoEmeP0m2061.png https://img.kookapp.cn/assets/2023-07/DAVItvJ3Z90mc093.png https://img.kookapp.cn/assets/2023-03/j9n8YaA5Ik0m20dk.png
// MacOS 偏方
有个偏方，请连续尝试十次：先开一个浏览器全屏，然后开游戏，游戏窗口没弹出来之前迅速切到全屏游览器界面，等估计差不多游戏窗口已经弹出来之后切回游戏，有几率能成功
// 友商
这里是 HMCL 主持的群聊。你可以选择查看群公告前往 HMCL 免费用户群下载启动器并永久迁移到 HMCL，之后即可在本群获取帮助。你也可以选择自行赞助龙猫 12 元加入其用户群。
// 内存测试
你先装这个软件 https://cdn.crashmc.com/https://github.com/ip7z/7zip/releases/download/24.08/7z2408-x64.exe ，然后在「工具」里点「基准测试」，把左侧「已通过」下面的数字改到最大，然后先让它运行个半小时看看会不会报错 https://img.kookapp.cn/assets/2024-10/05/D93QR1c7JV0b702a.png
// 微软账户登录
在浏览器提示大功告成后，回到 HMCL 截图
改成使用密码登录微软账户，如果没有密码登录选项，那你去 account.microsoft.com 设置密码
// 重复加入多个群聊
请不要重复加入多个群聊！你将被从本群踢出
请不要重复加入多个群聊！介于这不是初犯，你将被从本群永久封禁
// 用户群处罚申诉
依据 HMCL 用户群管理规范（下简称规范） https://github.com/HMCL-dev/HMCL/discussions/3228（修订版本：V1.1.0 修订时间：2025.06.26），我将回复您的申诉请求。全过程将依据规范第六部分第1条记录在案。
您在 [日期] 前后的发言违反了规范第七部分第 [1] 条，管理员依据规范第六部分第1、2条，对您处以 [2] 的处罚。HMCL 管理团队已确认处罚过程合规，无漏罚、错罚等情况。
依据规范第六部分第3条，如您依然认为处罚有误或处罚过重，可继续向用户群管理员 Glavo 360736041 申诉。Glavo 的违规认定是最终结论，不能继续申诉。