功能总览
本页按版块列出当前可用功能。首次使用请先阅读快速开始。
界面与交互
- 首页、下载、版本设置、联机、设置五个版块,按 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 版本的模组仍受设备限制
来源与授权边界见修改声明与许可。
使用建议
需要逐步操作的教程时,见帮助文档的专题索引。
