Important
请在编辑前认真阅读 关于！
Warning
组织内成员：不要直接修改此文件!
请在 Fork 后提交 Pull Request 来完善本文档，而不是在此仓库创建新 Branch，这可能会触发分支保护规则而复杂化您的操作流程。
| 内容 | 解释 | 参考 |
|---|---|---|
| 无法下载 Minecraft | 为 MCBBS 关停所致，同时由于 BMCLAPI 源压力过大，可能导致大部分时间段无法通过镜像源下载 Minecraft。届时请尝试以下四种解决方案： 1. 更换不同的网络； 2. 每间隔一段时间后再次尝试下载； 3. 若您的网络条件允许，尝试使用加速器或 VPN； 4. 如个人技术能力允许，尝试部署 OpenBMCLAPI。 部分日志可见：基础连接已经关闭: 未能为 SSL/TLS 安全通道建立信任关系。 |
Bilibili 动态 #3213 |
| 1.16.4 及 1.16.5 离线模式无法进入多人游戏界面 | PCL 不会解决该问题，这超出了启动器功能范畴。 如仍需要使用多人游戏 1，请自行断网启动游戏或安装 MultiOfflineFix 或 Offline Multiplayer 模组。同时您可以参考此处的解决方案以彻底解决此问题。 |
PCL2 内置帮助库 #2003 #2017 #2004 #1930 |
| 游戏崩溃 | 请依照本文下方附文步骤进行解决。 | |
| 无法登录正版账户：您可能没有在 Minecraft 官网创建档案，或者没有购买 Minecraft。 | 此问题预计将于新版本修复。此前若您确认您已购买 Minecraft 并创建档案但仍出现此问题，请前往 Minecraft 官网 登录您拥有 Minecraft 的 Microsoft 账号后，稍等片刻即可使用 PCL 正常登录。 | #1299 #1264 #3702 (#3776) |
| 无法进入服务器 | 非 PCL 问题，具体可能的解决方案见内置帮助库或前往相关论坛寻求他人帮助。 | PCL2 内置帮助库 |
| 部分时段无法登录正版账户但网络速度良好 | 可能为使用中国联通或中国移动网络下 api.minecraftservices.com 和二级域名为 mojang.com 的地址均被墙所致，请尝试使用中国电信网络或使用 VPN。详见 #2738。 | #2738 |
| 游戏内无法正确加载皮肤 | 请检查您的网络环境，使用加速器或 VPN。 | - |
| 整合包中安装了 OptiFine 导致游戏无法正常加载 | 此为 OptiFine 过于激进的优化手段所致。OptiFine 和模组加载器之间存在严重的兼容性问题，请考虑只安装 OptiFine 或只安装模组加载器，亦或是使用其他 Mod 替代 OptiFine。 | #3258 #3566 #3573 |
| 内容 | 解释 | 参考 |
|---|---|---|
| 支持通过启动器联机游玩 Minecraft | “至于联机，因为网易还在继续代理中国版，我和 HMCL 的维护者都觉得还得谨慎一点……况且现在也有 Mod 支持联机了……咳咳。” ——龙腾猫跃 BakaXL 现已于 2023 年 10 月 8 日将其部分服务与 Octo 章鱼网络进行对接，并对其可用性进行初步评估，待评估完成后，Octo 网络会全面对其他启动器开放。2 |
2.6.11 更新日志 |
| PCL 消失、报毒、无法更新 | 为 Microsoft Defender 和 360 等杀毒软件误报，请在 Windows 安全中心和杀毒软件中添加排除项或白名单。具体教程见 PCL 内置帮助库。 | PCL2 内置帮助库 #56 #666 |
| 以管理员权限运行时无法使用文件拖拽功能 | [需要社区帮助] “尽可能尝试修复相关代码，依然无法解决……如果谁有解决方案可以提出” ——龙腾猫跃 | #2531 |
| 支持启动器多语言选项 · I18n support & Support more languages |
正在 Discussions 中投票。 · Voting in Discussions. |
#891 (#2567) |
| 增加导出整合包功能 | 正在 Discussions 中投票。 | #98 (#100) |
| 支持启动基岩版（BE）、教育版、传奇（Minecraft Legends；MCL）、地下城（Minecraft Dungeons；MCD）等其他 Minecraft 衍生游戏 | “这玩意儿我根本启动不了！用官方启动器吧！告辞！” ——龙腾猫跃 | #81 |
| 支持第三方登录全局设置 | 正在 Discussions 中投票。 | #57 (#58) |
| 支持更新整合包 | 新旧整合包间可能存在兼容性等冲突问题，不会制作。 | #2854 |
| 爱发电无法收到加群信息或更新密钥 | 加群请在爱发电回复 “加群”，更新密钥在爱发电获取请回复 “‘更新’ +识别码”。如无法收到回复，很可能是您已经触发了人工回复，在等待人工回复的过程中无法使用命令。您如果只是想使用命令，可以发送 “取消人工处理”。如仍旧没有回复，可以等待一会后再进行尝试。 | 石墨文档 #1867 #1529 |
| 使用自定义主页时出现问题 | 一般情况下非启动器问题，为第三方主页问题，请联系主页作者。 对于启动器内置的预设主页，请见下方 “预设主页” 部分获取对应作者及其仓库。 |
#3393 #3002 #2930 等 Issues |
| 支持 MacOS、Linux、IOS、安卓 等其他操作系统 | PCL 的底层界面框架（WPF）无法跨系统，要兼容其他系统无异于完全重做，不会制作。 | #54 |
| 添加皮肤库 | 不会制作该功能。 | #343 |
| 支持离线披风 | 技术上无法实现。 | #700 |
| 支持调整 OptiFine 和第三方披风选项 | 暂时不打算制作。 | #2045 #2065 |
| 1.19.3 及以上版本不支持自定义皮肤 | 正在 Discussions 中投票。 | #1288 (#1596) |
| Minecraft 更新后 PCL 内未找到该最新版本 | 请在 设置-启动器-下载-版本列表获取 选择 尽量使用官方源。 | #1226 |
| 支持识别、安装 Quilt | [处理中-第三方] 等待 BMCLAPI 支持。 | #48 |
| 支持识别、安装 NeoForge | [处理中] 现镜像源已上线，等待 BMCLAPI 支持 Quilt 下载后一并制作。 | #2244 |
| 支持识别、安装 Cleanroom | 正在 Discussions 中投票。 | #3003 (#3004) |
| 支持安装 Legacy Fabric、Legacy Fabric API、Babric 等 | 已不再考虑专门为 Minecraft 1.9 及以前的版本追加新功能。 | #3171 #283 |
| 支持修改已安装版本的组件和模组加载器 | 正在 Discussions 中投票。 搜索关键词：Fabric、Forge、OptiFine、LiteLoader、NeoForge、Quilt。 |
#220 (#227) |
| 安装整合包时支持修改模组加载器版本 | 修改模组加载器版本可能会导致严重的兼容性问题，请联系整合包作者解决，PCL 不会支持该功能。 | #3568 |
| 支持下载资源包（材质包&纹理包） | 正在 Discussions 中投票。 | #44 (#1095) |
| 支持光影下载 | 正在 Discussions 中投票。 | #396 (#2768) |
| 支持数据包下载 | 正在 Discussions 中投票。 | #2991 (#2994) |
| 支持下载地图 | 存在语言问题，不会制作。 | #44 #135 |
| 支持下载第三方服务端及插件 | PCL 是启动器，此功能超出了启动器的范畴。 | #108 |
| 支持下载特定版本的 Java | 没有合适的下载源，暂不考虑。 | #3585 |
| 引进新 Mod / 整合包下载源 | 没有其他可用的国内的 API。 | #1658 |
| 允许管理存档、光影文件 | 不会制作该功能。 | #388 #396 |
| 支持导出 Mod 列表 | 正在 Discussions 中投票。 | #2586 (#2590) |
| 添加 Mod 收藏夹 | 正在 Discussions 中投票。 | #487 (#1646) |
| Mod 管理支持分类 Mod | 不会制作。 搜索关键词：分类、分组、模组、管理、分区、收藏、文件夹、收藏夹、星标。 |
#277 |
| 无法搜索到指定 Mod & Mod 搜索筛选选项异常 & Mod 搜索匹配版本错误 & Mod 详情页前置问题 等 Mod 搜索问题 | 为 API 或 Mod 作者上传时的设置问题，PCL 无法解决。 3 | #2352 #2277 #2190 #2069 等 Issues |
| 下载或安装资源时失败 | 请先尝试使用其他启动器下载，若使用后问题依然存在，则非 PCL 问题。请使用镜像源或检查您的网络环境，使用加速器或 VPN。 如若确定网络环境无问题，请尝试设置游戏 Java 为最新版本的 Java 后再试。 |
#3211 |
| 添加暗黑模式 | “这个基本上要重新设计所有界面，工作量太大了，我猜我都不会做……” ——龙腾猫跃 | #131 |
| Mod 管理允许选择使用多种排序方式 | 正在 Discussions 中投票。 | #2698 (#2700) |
| Mod 管理允许扫描子文件夹 Mod | 此功能已被移除4，但如果子文件夹名称为版本名则仍会读取并加载。对于 Quilt 加载器下识别子文件夹 Mod 功能正在处理。 | #811 #1098 #1536 #1784 |
| 添加更多 Minecraft 远古版本 | 正在 Discussions 中投票。 | #3786 (#3787) |
| 添加不由 Mojang 发布的 Minecraft 版本 | 不会收录社区玩家制作的 Minecraft 版本 (如：error422、alpha v1.2.3_03 等)。 | #2575 |
| 添加云端账户、启动器内置社区、云端同步账户数据、云端同步隐藏主题、官网等 | 无法抵御攻击，不会制作任何有关云端账号的内容。 | #315 等 Issues |
| 支持隐藏主题迁移 | 考虑到隐私问题，不考虑支持导出此类信息。 | #760 |
| 有关拓展隐藏主题、自定义主题、背景图片功能的 Issue | 备注：此类 Issue 大概率会因为必要性及优先级较低被拒绝，但不排除个别会被采纳，仅作参考。 搜索关键词：毛玻璃、背景、透明、标题、隐藏主题、音乐、图标、暗黑、RGB、渐变、图标。 |
#3202 #2216 #1487 #1653 #1242 #840 #791 #711 #562 #401 #131 |
| 使用滑稽彩导致卡顿&掉帧&占用过大 | 无法解决或优化此类问题。 | #1575 #1590 #2336 |
| 支持启动器字体自定义 | 会导致严重的 UI 适配问题，不考虑制作。 | #1724 #766 #366 |
| 无法准确设置游戏分辨率 | 不同系统环境下窗口标题栏和边框的大小不一致，PCL 无法准确设置该数值。 | #1478 #1077 |
| 有关与 Minecraft 多人游戏服务器交互的内容 | 不会制作该功能。 | #829 #1993 |
| 接入 ChatGPT、文心一言、Copilot、NewBing 等 AI 语言模型 | 不会制作该功能。 | #2791 #1557 |
| 支持使用相对路径 | "改这个那一大堆路径设置绝壁一周之内就会出来一大堆反馈让我加相对路径，想想都吓人，算了……" ——龙腾猫跃 | #1568 #1292 #1080 |
| 游戏崩溃时加粗或突出窗口中 “而不是发送这个窗口的截图” 字样 | “没救，侠客咋样都是侠客” ——龙腾猫跃 | #2153 |
| 开发简易版 PCL | 不会制作。 搜索关键词：Lite、简易、简单、极简、轻量级、新手、萌新。 |
#2330 |
| 上架微软商店 | 不会制作该功能。 | #1278 |
| 有关 “千万别点” 的 Issue | PCL 不会受理关于 “千万别点” 的任何 Issues。 | #460 #398 #407 #677 #796 #1147 #1923 |
| 添加内置 NBT 查看器/编辑器 | 超出启动器范畴，不会制作。 | #3321 |
| 选中 PCL 文件并快速敲击 Enter 会导致 PCL 多开 | 无法正确检测，不会修复。 | #1372 |
| 无法启动 Labymod 客户端 | 为其版本 Json 提供的文件大小有误所致，非 PCL 问题。 | #3225 |
| 删除 Libraries 文件夹后补全文件失败 | Libraries 文件夹中文件只能在安装 Forge 时动态生成，除此之外没有渠道进行补全。 | #3698 |
| 将 GitHub 链接替换为镜像站 | 使用代理源并安全性与稳定性欠佳，不会制作。 | #2879 |
| 内容 | 解释 | 参考 |
|---|---|---|
| 因第三方组件引起的问题 | PCL 不会处理第三方造成的问题。 | Label: 第三方 |
| 因使用 32 位系统引起的问题 | 新版 Minecraft 已不支持 32 位系统，因此不会再额外为 32 位进行修复和调整。 | #3649 |
| 因系统问题无法打开 PCL | 系统原因，PCL 无法解决。 搜索关键词：.Net、支持库、程序出现未知错误、显卡驱动、闪退、系统不完整。 |
#2849 #2755 #2751 #2729 #2676 #2580 #2485 #2146 等 Issues |
| 调试模式性能损耗过大 | 个别问题，无法稳定复现。 | #365 |
| Mod 下载详情页加载动画 UI 在加载后未能隐藏 | [需要社区复现] 需要开启调试模式的复现日志以显示加载动画 Debug 信息来修复此问题。 搜索关键词：加载动画、加载图标、Mod 下载、列表、UI、隐藏、消失。 |
#1624 |
| 无法加载 Mod 图标 | 请检查您的网络环境，如无问题则请前往 Modrinth 或 CurseForge 网站内及 HMCL、BakaXL 内查看是否有图标，若均无图标，则该 Mod 作者未上传图标，非 PCL 问题。 | #3143 |
| 无法更新 PCL（DNS） | 请按下 Win+X ，点击 Windows PowerShell（管理员），并输入如下命令 netsh interface ip set dns "适配器名称" static 8.8.8.85，如果您使用的是 有线连接（网线），请将 适配器名称 替换为 以太网，如果您使用的是 WiFi，请将 适配器名称 替换为 WLAN，然后输入 nslookup raw.githubusercontent.com，确认 非权威应答 的 Addresses 项的值不为 0.0.0.0、127.0.0.1、:::、:::1。 |
#3505 |
| 使用特定 Java 时无法结束或者取消启动 Minecraft | 由于部分 Java 会以很奇怪的方式运行 MC，并会再创建一个 Java 进程，导致 PCL2 无法分辨到底哪一个才是 Minecraft 进程，因此无法修复。 | #364 |
| 内存优化后（或已使用内存过小时）已使用内存部分不显示具体数字 | 由于排版空间不够不予以显示，同时考虑到大部分玩家在内存占用极低时不会计较具体占用内存数，因此这是刻意的设计。 | #1924 |
| 切换音乐时概率性切换提示与实际播放歌曲不符 | NAudio 的 Bug，技术上无法处理。 | #866 |
| 切换音频设备后，音乐播放不会自动切换到新设备 | NAudio 的 Bug，技术上无法处理。 | #480 |
| 播放音乐时提示线程执行失败：NoDriver calling waveOutRestart | NAudio 的 Bug，技术上无法处理。 | #1753 #2348 |
| 启动游戏时出现弹窗报错：GLFW error 65543 | 检查是否使用了正确的显卡（或独立显卡）启动 PCL。 | #2215 |
| 启动 Minecrat 1.7.10-1.12.2 游戏内无声音 | 此为 OpenAL 初始化失败所致，请在游戏启动后按下 F3+T 来重新初始化 OpenAL。 | #3779 MC-9974 |
| 因感染蠕虫病毒导致 PCL 崩溃或无法更新等 | Collaborator 请注意，日志可见：文件名或文件夹名前含有 cache、HD 字样。 |
#2964 #2970 #3204 |
| 日志出现 not xxx in java.library.path | Java 不完整，非 PCL 问题，如果可能，请您自行准备 Java 而不是使用自动补全 Java 功能。 | #3496 |
Important
以下为 PCL2 内置的预设主页，均由第三方作者制作。
如若以下自定义主页出现问题，请向通过下表提供的渠道向主页作者提交反馈，而不是向 PCL2 仓库提交 Issue。
| 主页名称 | 反馈地址 | 联网更新地址 | 作者 |
|---|---|---|---|
| Minecraft 新闻 | · Github | · http://pcl.mcnews.thestack.top · https://news.bugjump.net |
@Light-Beacon |
| 简单主页 | · Github | · https://gitee.com/mfn233/PCL-Mainpage/raw/main/Custom.xaml | @MFn233 |
| 每日整合包推荐 | · SodaMC | https://pclsub.sodamc.com/ | @wkea |
【附】如何优雅地解决问题&提交反馈？
先别急，请导出并保存 PCL 输出的错误报告，首先尝试在相关 Minecraft 论坛、QQ 群（或 KOOK 群等相关 Minecraft 社群）、PCL2 仓库 Discussions 提问板块 上传您的错误报告并描述您的具体情况。请注意，不要仅上传 PCL 窗口的截图！不要仅上传 PCL 窗口的截图！不要仅上传 PCL 窗口的截图！ 也请在提问过程中尽可能保持 平和友善的语气，这会使您的问题得以更快解决。当游戏使用 PCL 启动或游玩过程中崩溃，而使用其他启动器启动或游玩时并未出现崩溃情况时，请在本仓库提交 Issue，并上传 PCL 日志及游戏崩溃报告、HMCL 启动脚本（如有）
如果您在求助时被指出需要提供 Mod 列表，可以在启动器中的 “启动前执行命令” 栏输入 dir "{verindie}mods" /b | clip 后重新启动游戏，Mod 列表就会被复制到剪贴板。
为了提高反馈处理效率，我们推荐遵照以下步骤来提交反馈。在沟通过程中，请保持平和友善态度，避免与他人产生言语冲突，这是不利于解决问题的。请注意，重复反馈、优化建议、新功能提案无法获得活跃橙。
在提交反馈前，请先确认您想提交的内容是否被他人提交，在 Issues 页面中的搜索栏搜索您想提交的内容的关键词。如：“支持识别和安装 Quilt”，您可以搜索 “Quilt” “加载器” “识别” “安装” 等关键词。在出现搜索结果后，在 Open 部分查看是否有相似 Issue，如没有，请单击 Closed 字样并再次检查是否有相似 Issue，如搜索结果过多，可以在搜索栏中添加 label:忽略 或 label:"拒绝 / 放弃" 来缩小检索范围。
完成后，单击 New Issue 按钮，根据列表各项提示，选择您要提交的 Issue 类型。其中对于 Minecraft 崩溃，请见上条 “我游戏崩了！急急急急急急” 的描述后再提交 Issue。
首先一一完成页面中出现的检查项，确认无误后开始填写反馈内容。在编辑 Issue 标题时，请尽量保证标题简短且可以有效概括反馈内容。如：
- ✔ Mod 管理选择 Mod 后下方按钮显示异常
- 此标题明了地标明了问题出现位置及问题具体情况。
- ✔ 支持通过快捷键全选 Mod
- 此标题清晰地表达了对于某内容的期望，并给出了可供参考的解决方案。
- ❌ 游戏崩了
- 此标题……概括性极强……对……就……挺强的……就
- ❌ 5个建议
- 请注意，不要一个 Issue 提交多个反馈内容，处理起来真的很头大。
完成上述步骤后，开始填写反馈内容正文部分，依照各部分提示清晰、明了、易懂地写出您的期望内容，如果可以，请写出可供参考的解决方案。
正文填写完毕后，请按照提示上传相关附件，包括但不限于：（Bug）PCL 日志、游戏日志、游戏崩溃报告、HMCL 启动日志、问题截图、复现视频等；（优化/新功能）相关截图或视频。
💡 Tips: 开启调试模式复现问题 在反馈 Bug 时，我们推荐直接上传开启调试模式复现了问题的复现日志，这通常会有利于解决该问题。 若你尚不清楚如何开启调试模式，请开启 设置-启动器-调试选项-调试模式 后重启启动器即可。
若您的反馈被初步确认，Collaborator 将会为您的 Issue 添加 待处理 label，如信息不足，请依照请求尽快完成信息补充，根据内容复现及相关信息获取难易程度，您需要尽可能在两周内完成信息补充，否则您的 Issue 将被超时关闭。但不必担心，若 Issue 关闭后您完成了信息补充，我们会再次进行确认，无误后会重新打开该 Issue。
在沟通过程中，请尽可能避免连续评论或多层引用评论，如果需要修改或补充您的陈述，可以通过单击右上角的三个点，选择 Edit 来编辑您的评论或反馈。在沟通过程中请尽可能保持态度平和，避免出现过激言论，如您对 Issue 处理结果不满意，可以继续在下方进行信息补充。
同时请注意，在沟通过程中请避免过多谈论无关内容或进行版聊，尽管您可以对您发布的评论进行隐藏，但当您发表无关内容时，已经对他人进行了不必要的打扰（因为该仓库有任何动态时 GitHub 会给关注了这个仓库的人发一次邮件），若无关内容过多，该 Issue 将被锁定。因此为了提高沟通效率，请善用 Edit 编辑功能，避免连续发布评论和发表无关内容。
Footnotes
-
请注意，离线账号登录服务器本身违反 Minecraft 最终用户协议 提及的 Minecraft 使用准则 的内容 ( 原文如此：Access to your server: Must only be granted to users who have a genuine paid-for version of Minecraft ) ，请谨慎考虑。 ↩
-
▷▷▷ 请注意，Octo 开放不等价于 PCL 上线联机，具体信息以龙猫发布的消息为准，仅供参考。届时切勿散布任何未经相关启动器作者及服务提供方证实的信息。 ↩
-
其中，若较老 Mod 搜索结果无法显示支持模组加载器，此为早期 CurseForge 不支持设置上传的 Mod 文件选择模组加载器导致；对于输入搜索关键词无法搜索到指定 Mod 或搜索时出现无关 Mod，此为 API 问题；如确认为 Mod 作者上传时的设置问题，如错误地选择了不支持的版本、Mod 前置标记错误、译名错误等问题，而非前两者问题，请尝试联系 Mod 作者或 MCMOD 百科页（仅译名问题）进行沟通确认。 ↩
-
由于 .minecraft/mods 文件夹下创建的子文件夹内的 Mod 不被模组加载器（此为如 Forge、Fabric 类模组加载器行为，非 PCL 行为）加载，因此在新版本中移除了此功能。 ↩
-
复制过程中，除适配器名称需要替换外，其他内容不可替换；除适配器名称外，其他部分不要包含中文字符。 ↩