PojavLauncher 安卓全 MC 版本使用手册
长图文警告，推荐配合阅读模式/目录生成进行阅读
阅读预计用时：12 min
一、下载
1. PojavLauncher 本体下载
a)、从 Google Play 下载（大陆不推荐）
https://play.google.com/store/apps/details?id=net.kdt.pojavlaunch
b)、从 GitHub Actions 下载（推荐，但需要 GitHub 账号）
此处假设您已经注册登录 GitHub
如果不想注册登录请翻到常见问题部分
打开链接https://github.com/PojavLauncherTeam/PojavLauncher/actions/workflows/android.yml
在此页面选择最新的并且带有绿勾或蓝勾的构建（或者叫开发版）打开
选择最新的构建
在接下来页面向下滑动，找到 Artifacts 部分（您需要 GitHub 账号才能下载）
下载最新的构建
您会看到如上 2 个不同的版本，其中带有 -noruntime 后缀的版本不包含 Java 8 运行时
如果您是第一次安装 PojavLauncher，则应下载 app-debug 版本
如果您想要更新您的 PojavLauncher，则应下载 app-debug-noruntime 版本
如果您跨越了较大版本更新，仍推荐您下载 app-debug 版本
下载好后您需要解压下载的 .zip 文件，得到 .apk 文件，然后安装 .apk 文件
c)、从源码构建（不推荐）
2. Java 运行时下载
新版本的 PojavLauncher 会自动下载缺失的 Java 运行时，无需手动下载
二、启动游戏
1. 打开 PojavLauncher
新版本的 PojavLauncher 不再强制横屏，但仍推荐您横屏进行体验
初次启动时 PojavLauncher 会进行初始化，您可以在屏幕底部点击 1 task(s) in progress 字样查看进度
点击右下方的 ∧ 展开版本列表
版本列表
2. 创建游戏配置文件
a)、点击创建新配置
b)、选择版本
如果你不知道选什么，就先选原版
游戏配置
c)、添加游戏版本
添加游戏版本
名称：游戏的名称，可随意填写
版本：要安装的游戏版本，点击右侧选择进行选择，不选择默认为最新版本
默认控制键布局：游戏所使用的虚拟控制按键（controlmap），可以在主页面自定义，如果不自定义则无需更改此项
JVM 参数：即 Java 运行所带的参数，如无特殊需求请不要更改此项
Custom path：自定义游戏路径，默认无版本隔离，如何使用版本隔离见下文
Java 运行时：使用的 Java 版本，默认会自动选择
渲染器：使用的渲染器类型，每个渲染器有标注适用的版本，默认会自动选择
如不需要版本隔离，确认无误后点击保存即可
d)、设置版本隔离
如果您不需要版本隔离，那么您可以跳过此步骤
在上一步，点击 Custom path 右侧的选择
点击 .minecraft 文件夹
点击屏幕左下方的新建文件夹选项新建一个名为 versions 的文件夹，不要打错了，以免出现不必要的问题，然后会自动进入 versions 文件夹（看屏幕左上方是不是 ./.minecraft/versions，如果不是点击 versions 文件夹进入即可）
然后再次点击屏幕左下方的新建文件夹选项新建一个文件夹，名字随意，但推荐命名为之前填写的游戏名称
版本隔离
最后来到新建的目录下，选择屏幕右下方的选择此文件夹确认选择
版本隔离
3. 添加账户
a)、回到主页面
b)、选择屏幕上方的添加账户
添加账户
c)、选择登录方式
登录方式
MICROSOFT ACCOUNT：微软账户（正版登录）
LOCAL ACCOUNT：本地账户（或称离线模式，没有正版账号时使用这个）
4. 启动游戏
a)、回到主页面，点击屏幕右下角启动游戏
下载游戏
此时 Pojavlauncher 会开始下载游戏本体、依赖库、游戏资源文件，并且会一并下载缺失的 Java 运行时，等待即可。如果您的下载速度非常慢抑或下载失败，可以前往设置-其他设置-游戏下载源中修改下载源为 BMCLAPI
b)、下载完成后，已经开始游戏，您可能会看到一片黑色，此时是游戏的加载阶段，稍加等待即可
游戏已经启动
三、常见问题
1. 应用程序/游戏以代码 -1 退出
看是否正确配置了版本设置，点击启动游戏左侧的编辑按钮（铅笔✏️样式）
看是否使用了合适的 Java，1.16.5 及以下使用 Java 8，1.17 及以上使用 Java 21
看是否使用了合适的渲染器，每个渲染器名字后面有说明适用的版本
看是否分配了合适的内存，设置-Java 调整-内存分配，过大（超过空闲内存）过小都无法正常运行游戏
如果是出现游戏画面后/安装了 mod 后报错退出，查看游戏的 latest.log 以寻找问题
2. 下载游戏本体、依赖库、游戏资源文件（assets）太慢/失败
PojavLauncher 现在支持镜像源下载，可以前往设置-其他设置-游戏下载源中修改下载源为 BMCLAPI
3. PojavLauncher 的 .minecraft 文件夹在哪
Android/data/net.kdt.pojavlaunch.debug/files/.minecraft
添加 mod、添加存档、添加材质包不再赘述，能找到 .minecraft 就好
游戏的 latest.log 也在此目录下，依据您是否启用版本隔离，latest.log 的位置可能有所不同
4. 怎么安装 Optifine/Fabirc/Forge/Quilt
在 二、2. b)、部分选择您想要安装的版本即可
5. 加了 mod 后运行不了
部分 mod 不被旧版本的 PojavLauncher 支持，以下是很久以前 PojavLauncher 官方 WIKI 中列出的不支持的 mod 清单，删除对应的 mod 再尝试运行。
如果您的 mod 不在给出的列表内，查看游戏的 latest.log 以寻找是否是由其他问题（mod 冲突、版本不匹配、缺少前置等）造成的。亦或是您分配的内存不足，可酌情调高
新版本的 PojavLauncher 已经支持绝大多数模组
6. 那些带有 GitHub 字样的链接打不开
GitHub 目前在大陆属于半墙状态，链接打不开绝大多数时候不是网站的问题，您可以尝试更换网络、使用流量访问
7. 我不想登录 GitHub 怎么办
将要下载的 PojavLauncher 版本的 GitHub Actions 页面链接复制到 https://nightly.link 就可以免登录下载，手动下载 Java 运行时同理
8. 我在 GitHub Actions 下载了 PojavLauncher，想更新怎么办
如果您追求最新版，参考 一、b)、部分下载 app-debug-noruntime 版本覆盖安装即可，您不会因此丢失任何数据
9. 我想体验其他版本的 Java 运行时
前往 https://github.com/PojavLauncherTeam/android-openjdk-build-multiarch/actions 选择下载您想要的 Java 运行时
一些其他版本的 Java 运行时
下载完成后解压压缩包，得到后缀为 .tar.xz 的文件，然后打开 PojavLauncher，在设置-Java 调整-运行环境管理器中选择新建，在弹出的文件管理器中选择刚才解压出来的 .tar.xz 文件即可完成导入
推荐的 Java 版本：
Minecraft 1.17 及以后: Java 21
Minecraft 1.16.5 及以前: Java 8
10. 作者是否提供第三方网盘下载
否。授人以鱼不如授人以渔，本文章中给出的所有链接均为 PojavLauncherTeam 的官方发布/更新地址
五、相关链接
PojavLauncher 的官方 WIKI：
https://pojavlauncherteam.github.io
PojavLauncher for Android 的 GitHub：https://github.com/PojavLauncherTeam/PojavLauncher
PojavLauncher for IOS 的 GitHub：https://github.com/PojavLauncherTeam/PojavLauncher_iOS
PojavLauncher 的 Java 运行时下载：
https://github.com/PojavLauncherTeam/android-openjdk-build-multiarch/actions
遇到 PojavLauncher 本体相关问题可以到对应 GitHub 页面提 Issues
有相关开发经验可以到对应 GitHub 页面提交 PR
