长图文警告，推荐配合阅读模式/目录生成进行阅读

阅读预计用时：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 版本

        下载好后您需要解压下载的 .zip 文件，得到 .apk 文件，然后安装 .apk 文件

    c)、从源码构建（非常不推荐，需要电脑以及一定开发经验，故不撰写教程）

2. Java 17 运行时下载

    如果您不需要运行 MC 1.17 及以上版本，那么您可以跳过此步骤

    Java 17 运行时下载 https://github.com/PojavLauncherTeam/android-openjdk-build-multiarch/releases/tag/jre17-ec28559

    在此页面中向下滑动，找到 Assets 部分

    普通用户选择 arm64 版本下载即可。如果您的设备比较老旧，请使用 arm 版本。如果您使用的是 Chromebook 等使用 Intel CPU 或 AMD CPU 的设备，请视情况选择 x86 或 x86_64 版本

    下载完成后无需进行解压等额外操作，稍后的教程中才会用到

    Java 8 运行已包含在 app-debug 版本的 PojavLauncher 中，无需额外下载。如确实需要重新下载，重新下载 app-debug 版的 PojavLauncher 即可

1. 打开 PojavLauncher

    新版本的 PojavLauncher 不再强制横屏，但仍推荐您横屏进行体验

    初次启动时 PojavLauncher 会进行初始化，您可以在屏幕底部点击 1 task(s) in progress 字样查看进度

2. 添加 Java 17 运行时

    a)、如果您不需要运行 MC 1.17 及以上版本，那么您可以跳过此步骤

    b)、点击屏幕右上角的设置按钮进入设置页面

    c)、点击 Java 调整

    d)、点击运行时管理器

    e)、点击新建

    f)、选择刚才下载的 Java 17 运行时（文件名称 jre17-xxx），然后 PojavLauncher 会进行解包，您可以在屏幕底部点击 1 task(s) in progress 字样查看进度

    g)、之后可以选择在运行时管理器中设置 Java 17 为默认值（可选操作）

3. 创建游戏配置文件

    a)、回到主页面

    b)、点击屏幕底部 Creat new profile

        注意，这些设置为该游戏的独立设置而非全局设置，如果您有多个游戏请给每个版本配置一遍

            名称：游戏的名称，可随意填写

            版本：要安装的游戏版本，点击右侧 SELEC 进行选择，不选择默认为最新版本

            Default control：游戏所使用的控制按键（controlmap），可以在主页面自定义，如果不自定义则无需更改此项

            JVM 参数：即 Java 运行所带的参数，如无特殊需求请不要更改此项！

            Custom path：自定义游戏路径，默认无版本隔离，如何使用版本隔离见下文

            Java 运行时：使用的 Java 版本，1.16 及以下选择 Java 8，1.17 及以上选择 Java 17

            渲染器：使用的渲染器类型，每个渲染器有标注适用的版本，如 1.19.3 应使用 holy gl4es: supports 1.0-1.19+

        如不需要版本隔离，确认无误后点击保存即可

    c)、设置版本隔离

        如果您不需要版本隔离，那么您可以跳过此步骤

        在上一步，点击 Custom path 右侧的 SELEC

        点击 .minecraft 文件夹

        点击屏幕左下方的 CREATE FOLDER 新建一个名为 versions 的文件夹，不要打错了，以免出现不必要的问题，然后会自动进入 versions 文件夹（看屏幕左上方是不是 ./minecraft/versions，如果不是点击 versions 文件夹进入即可）

        然后再次点击屏幕左下方的 CREATE FOLDER 新建一个文件夹，名字随意，但推荐命名为版本号（如命名为 1.19.3）。最后选择屏幕右下方的 SELECT FOLDER 确认选择此文件夹

4. 添加游戏账号

    a)、回到主页面

    b)、选择屏幕上方的 Add account

        MICROSOFT ACCOUNT：微软账号（正版登录）

        LOCAL ACCOUNT：本地账号（或称离线模式，没有正版账号时使用这个）

5. 启动游戏

    a)、回到主页面，点击屏幕右下角启动游戏

        此时 Pojavlauncher 会开始下载游戏本体、依赖库、游戏资源文件，等待即可

    b)、下载完成后，已经开始游戏，您可能会看到一片黑色，此时是游戏的加载阶段，稍加等待即可

1. 下载 Fabric 安装器

    https://fabricmc.net/use/

    打开此页面后，可能会显示 Loading versions，稍等一会就能看到下载按钮

    注意：您点击的下载按钮中的括号内应写的是 “Universal/.JAR” ！！！

2. 安装 Fabric

    a)、回到 PojavLauncher 主页面

        注意：如果您在运行时管理器中修改了 Java 的默认值，您需要先将该值设置为 Java 8 才能进行后续步骤

    b)、点击安装 .JAR

        点击刚才下载的 Fabric（文件名称 fabric-installer-xxx）

    c)、点击右上角 × 按钮关闭日志页面

    d)、安装 Fabric

        安装选项

            Client/Server：客户端/服务端，选择 Client 客户端

            Minecraft Version：要安装的游戏版本

            Select Install Location：安装位置，无论您启用版本隔离与否，都请不要更改！

            Creat profile：创建配置文件，请一定勾选！

        确认无误后点击 Install 即可

    e)、退出 Fabric 安装

        可以点击 Fabric 安装程序右上角的 × 来关闭

        可以点击屏幕右上角的强制关闭来关闭

    f)、选择安装了 Fabric 的游戏版本

        点击屏幕右下角启动游戏按钮左侧的 ∧ 按钮

        此时会弹出你安装的版本列表，点击含有 Fabric 的版本（默认名称为 fabric-loader-xxx），此时还不要点击启动游戏！

    g)、配置新安装的 Fabric 版本

        选择安装了 Fabric 的游戏版本后，点击启动游戏左侧的编辑按钮（铅笔✏️样式）

        参考前文 二、3. b) 部分进行配置

        确认无误后点击保存即可

    h)、启动游戏

        左下角已经出现 Fabric 字样，安装成功

1.应用程序/游戏以代码 -1 退出

    看是否正确配置了版本独立设置，点击启动游戏左侧的编辑按钮（铅笔✏️样式）

    看是否使用了合适的 Java，1.16.x 及以下使用 Java 8，1,17.x 及以上使用 Java 17

    看是否使用了合适的渲染器，每个渲染器名字后面有说明适用的版本，如 holy gl4es: supports 1.0-1.19+ 表示适用于 MC 1.0-1.19+ （ “+” 表示 “及以上” ）

    看是否分配了合适的内存，设置-Java 调整-内存分配，过大（超过空闲内存）过小都无法正常运行游戏

    如果是出现游戏画面后/安装了 mod 后报错退出，查看游戏的 latest.log 以寻找问题

2.下载游戏本体、依赖库、游戏资源文件（assets）太慢/失败

    PojavLauncher 不支持也不会支持镜像下载，因为 PojavLauncher 在微软旗下的 GitHub 开源、分发版本，担心造成侵权行为。如果确实无法下载，可以使用电脑上的第三方启动器通过镜像源下载好后传到手机

3. PojavLauncher 的 .minecraft 文件夹在哪

    Android/data/net.kdt.pojavlaunch.debug/files/.minecraft

    添加 mod、添加存档、添加材质包不再赘述，能找到 .minecraft 就好

    游戏的 latest.log 也在此目录下，依据您是否启用版本隔离，latest.log 的位置可能有所不同

4. 加了 mod 后运行不了

    部分 mod 不被 PojavLauncher 支持，以下是 PojavLauncher 官方 WIKI 中列出的不支持的 mod 清单，删除对应的 mod 再尝试运行。亦或是您分配的内存不足，可酌情调高

    如果您的 mod 不在给出的列表内，查看游戏的 latest.log 以寻找是否是由其他问题（mod 冲突、版本不匹配、缺少前置等）造成的

4. 那些带有 GitHub 字样的链接打不开

    GitHub 目前在大陆属于半墙状态，链接打不开绝大多数时候不是网站的问题，您可以尝试更换网络、使用流量访问

5. 我在 GitHub Actions 下载了 PojavLauncher，想更新怎么办

    如果您追求最新版，参考 一、b) 部分下载 app-debug-noruntime 版本覆盖安装即可，您不会因此丢失任何数据

6. 作者是否提供第三方网盘下载

    否。授人以鱼不如授人以渔，本文章中给出的所有链接均为 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 本体相关问题可以到对应 GitHub 页面提 Issues

有相关开发经验可以到对应 GitHub 页面提交 PR