Skip to content

功能总览 ​

本页按版块列出当前可用功能。首次使用请先阅读快速开始。

界面与交互 ​

  • 首页、下载、版本设置、联机、设置五个版块,按 PCL2 的分栏结构排布:左栏为列表,右侧为内容区
  • 列表项、按钮、下拉菜单支持鼠标指向高亮,外接鼠标时可观察到该效果
  • 窗口高度较小或缩放比例较低时,弹窗正文可单独滚动,操作按钮固定在底部
  • 二级页为页面栈结构,从资源详情进入前置资源后可逐层返回,不会直接跳回首页

资源下载 ​

  • 原版游戏:选定版本后安装本体,加载器可在同一步勾选
  • 社区资源:Mod、整合包、资源包、光影包、存档
  • 默认来源为 Modrinth。CurseForge 官方接口需要 x-api-key,开发版未配置 Key 时搜索使用镜像
  • 默认并发 32 条连接,可在「设置 → 下载 → 最大线程数」调整,修改后于下一次下载生效
  • 下载源可切换为自动、官方或镜像,失败时自动换源重试

实例与整合包 ​

功能说明
实例管理新建、复制、删除、重置
独立设置每个实例有独立的渲染器、内存与 Java 参数,修改其中一项不影响其他实例
整合包导入支持本地导入与系统分享接入,安装前可改名,失败时自动清除不完整的版本
整合包导出按 PCL 的匹配规则打包,规则中的 [宝] 等特殊字符不会再导致崩溃

运行与联机 ​

  • 渲染器可切换。Sodium、Iris 等要求桌面 GL 3.3+ 的模组,启动器会进行兼容处理
  • 陶瓦(Terracotta)联机模块内置于启动器,未启用时联机页会显示引导
  • 更新检查读取 latest_version_md.json,经官网分流。弹窗中常驻「从官网下载(若下载缓慢)」

插件系统 ​

插件是单独安装的普通 APK,不属于开发版内置主题。清单与资源位于插件自身的 assets/zplugin/ 目录下。

  • 皮肤插件可调整配色、圆角与玻璃渲染效果,也可接管部分版块页面
  • entry: true 的插件会在首页增加入口,页面内容由插件自行声明
  • 插件可向版块左栏追加条目、整块接管版块,也可通过 ContentProvider 提供版本列表

启动器不加载插件的 dex,不共享进程,仅负责发现、拉起与渲染。协议见插件 API。

皮肤插件的限制

同一时间仅有一个皮肤插件生效。同时启用多个时,它们会互相覆盖外观,最终效果取决于加载顺序。

插件升级需递增 APK 的 versionCode。仅修改 plugin.json 中的 version 不会触发重新解包,界面仍为旧配置。

功能边界 ​

  • 仅支持 Android(minSdk 26),无 iOS 或桌面端
  • CurseForge 官方接口需要 x-api-key,未内置时只能使用 Modrinth 或镜像
  • 开发线默认未配置微软登录的 Client ID,离线与第三方认证不受影响
  • 渲染器兼容不等于所有模组均可运行,要求较高 OpenGL 版本的模组仍受设备限制

来源与授权边界见修改声明与许可。

使用建议 ​

  • 首次安装:先完成快速开始中的流程,再查阅本页
  • 安装模组:在实例的「版本设置」中调整渲染器与内存,比在下载页查找参数更直接
  • 扩展功能:先确认启动器版本,再查阅插件 API中对应版本开放的接口

需要逐步操作的教程时,见帮助文档的专题索引。

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