Skip to content

常见问题 ​

本页问题整理自官方 README、NOTICE 与 1.5.5 发布说明。启动器本身的问题请提交至官方 Issues,本站不处理启动器的缺陷反馈。

设备与安装 ​

支持哪些设备?有电脑版或 iOS 版吗? ​

仅支持 Android,最低版本 Android 8.0(minSdk 26)。无 iOS 版,也无桌面版。

近年发布的手机多为 64 位 ARM 架构,选择 arm64-v8a 即可。无法确定时可选择全架构包,体积较大。

提示「应用未安装」,或无法覆盖旧版本? ​

该提示由签名不一致引起。

自行编译的包使用你的 keystore,与官方发行包签名不同,系统会拒绝覆盖安装。此情况需先卸载旧版。卸载会清除应用数据,操作前请备份实例、存档与账号信息。

1.5.5 的官方包名为 com.zpcl.launcher,签名一致时可直接覆盖升级。

升级后设置、实例或登录状态丢失? ​

请先确认是否跨过包名变更的版本。1.5.4 起正式线包名变更为 com.zpcl.launcher,与更早版本属两个并存的应用,旧数据不会自动迁移。

升级前先导出或备份整合包与实例,可减少事后恢复数据的工作量。

登录 ​

正版(Microsoft)登录无法使用? ​

公开源码未内置项目的 OAuth Client ID,自行构建的包默认无此配置,未配置时无法完成微软登录。离线登录与第三方认证不受影响。

如自行构建需要使用正版登录,可从环境变量 OAUTH_CLIENT_ID 或仓库根目录的 .oauth_client_id.txt 提供自己的 Client ID。

若官方发行包同样无法登录,请附版本号与日志提交至官方 Issues,不要提交至上游仓库。

第三方认证反复提示重新登录? ​

1.5.5 的行为是:认证返回 403 时,仅对当前角色尝试一次会话恢复,失败后提示重新登录。不会循环重试,也不会自动切换至其他角色。

请先确认认证服务器可用且角色有效。两项均正常时,完成一次重新登录即可恢复。

启动与运行 ​

一直停留在加载页? ​

1.5.5 已修复该问题:接回上游 2.8.1 的启动导航,恢复了 PCL 解压页。

若仍出现,请先升级至最新版,再附日志反馈。仅描述「卡在加载页」无法定位问题。

提示缺少 Java,或游戏无法启动? ​

启动器会检测设备上的 Java 环境,缺少运行时可在启动器内下载。

不同 Minecraft 版本对 Java 的要求不同。实例的「版本设置」中可单独调整 Java 参数与内存,可先增加内存,再重试。

Sodium、Iris 等模组闪退? ​

这些模组要求桌面 OpenGL 3.3+。启动器会进行自动兼容,但设备 GPU 与渲染器能力决定上限。

请在实例的「版本设置」中更换渲染器后重试。仍无法运行则说明设备性能不足,需改用更轻量的方案。

下载与资源 ​

下载缓慢或频繁失败? ​

下载默认并发 32 条连接,可在「设置 → 下载 → 最大线程数」调整,修改后于下一次下载生效。

下载源可切换为自动、官方或镜像,失败时自动换源重试。也可使用更新弹窗中的「从官网下载」入口。

CurseForge 搜索不到内容? ​

CurseForge 官方接口需要 x-api-key。开发版未配置 Key 时,搜索使用镜像,不请求官方接口。

此时建议优先使用默认的 Modrinth,两者的资源覆盖范围相近。

整合包导入失败,残留不完整的版本? ​

安装失败时启动器会自动清除不完整的版本,列表中不会残留。

导入失败时,请先确认整合包格式受支持(Modrinth、CurseForge 等),再检查下载过程是否中断。

插件与外观 ​

安装皮肤插件后界面未变化? ​

同一时间仅有一个皮肤插件生效,同时启用多个会互相覆盖。

另一常见原因是插件 APK 升级后 versionCode 未递增,启动器无法识别为新版本,不会重新解包,界面仍停留在旧配置。处理方式见插件 API中的「安装与升级」。

插件能否读写启动器内部数据? ​

不能。

启动器不加载插件的 dex,不绑定 AIDL,也不反向调用插件的 Activity。页面可触发的动作仅限白名单内的项目。需要版本列表等动态数据时,使用 ContentProvider。

其他常见问题 ​

这是 PCL2 或 Zalith Launcher 的官方版本吗? ​

不是。

ZPCL Launcher 是 Zalith Launcher 2 的非官方修改版,与上游官方无关联。界面参考 PCL2 的版式,不代表隶属或背书。完整声明见修改声明与许可。

问题应提交到哪里? ​

启动器问题请提交至 ZPCL Launcher Issues,不要提交至上游仓库。

反馈时请附版本号(PCL 界面 → 更多 → 关于与鸣谢)、设备型号、Android 版本、复现步骤,以及去除敏感信息后的日志。

本站文档如有错误或过时内容,可使用页面底部的「在 GitHub 上编辑此页」修改。

未收录的问题 ​

本页只收录已有明确结论的问题。操作步骤不明确时,先查帮助文档的专题索引,其中列出现有专题与待补充的专题。教程尚未覆盖的内容,可在文档 QQ 讨论群中提出;程序缺陷按上节的方式提交。

ZPCL Launcher 是 Zalith Launcher 2 的非官方修改版,遵循 GPLv3 开源协议