PojavLauncher iOS 完整指南：在 iPhone/iPad 上运行 Minecraft Java版

PojavLauncher iOS 完整指南：在 iPhone/iPad 上运行 Minecraft Java版

【免费下载链接】PojavLauncher_iOSA Minecraft: Java Edition Launcher for Android and iOS based on Boardwalk. Succeeded by https://github.com/AngelAuraMC/Amethyst-iOS项目地址: https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS

PojavLauncher iOS 是一个基于 Boardwalk 项目的开源启动器，让 Minecraft Java版在 iPhone 和 iPad 上完整运行：从最早的 beta 版本到最新快照，支持 Forge、Fabric 等模组生态。它适合想在 iOS 设备上玩 Java版原味的玩家，也适合想理解"Java 虚拟机如何搬进 iOS"的开发者。

30 秒速览

一句话判断路线：系统版本在 16.x 及以下、能用 TrollStore 的设备走第一条路；iOS 17/18 用户则依赖电脑配合 AltStore/SideStore 侧载，并留意签名刷新。

安装与配置：三条路线按稳妥程度排

方案一：TrollStore（首选，免电脑、免刷新）

TrollStore 能永久签名，并自动启用 JIT，是整个流程里体验最接近"正常 App"的一条路。适合支持 TrollStore 的系统版本。

1. 从官方发布页下载 PojavLauncher 的 IPA。
2. 在分享菜单里选择用 TrollStore 打开该 IPA 完成安装。
3. 打开游戏即可，JIT 已自动生效，无需额外操作。

注意：iOS/iPadOS 17.0 这一版不能走标准流程，需要先用 TrollRestore 降级处理，17.0 以上版本则不在支持范围内。

方案二：AltStore（稳妥，但要电脑常驻网络）

适合没有 TrollStore 条件的设备，代价是电脑上的 AltServer 需要与设备在同一局域网并保持运行。

1. 在电脑上安装 AltServer，设备与电脑接入同一 Wi-Fi。
2. 在 AltStore 的可信来源列表中添加 PojavLauncher 仓库。
3. 点击 FREE 开始安装，签名刷新与 JIT 启用由 AltStore 自动完成。

方案三：SideStore（免电脑，但 JIT 需手动）

1. 在设备上运行 SideStore 的签名流程（需 Wi-Fi）。
2. 用其安装下载好的 IPA。
3. JIT 不会自动开启，需要额外手段附加调试器才能启用，整体不如前两条路省心。

另外可以从持续集成页面下载 nightly 构建自行侧载，适合想尝鲜新修复的用户，但这类构建可能包含破坏游戏稳定性的 bug，建议存档后再试。

JIT（即时编译）直接决定游戏能不能跑到可用帧率，而 iOS 只允许"正在被调试"的 App 使用 JIT，所以各路线的激活方式差异很大：

功能全景与实操要点

版本全覆盖：从最早的 beta 到最新快照都能安装。实际好处是低配设备可以选 1.7 这类老版本跑，也能在更新发布当天体验快照。

模组生态：Forge、Fabric、OptiFine、Quilt 四类框架都受支持，配合 OptiFine 还能在图形层面做进一步优化。装模组前先确认框架与游戏版本匹配，这是后面避坑部分的重点。

可自定义的屏上控制：虚拟按键的布局、大小、位置都能按习惯调整，适合横屏双拇指操作。

外接输入：主流游戏手柄即插即用，键盘鼠标通过转接器连接，GyroInput 模块还提供了陀螺仪输入方案。

账号与登录：支持微软账号登录和演示模式，没有正版账号也能进世界。

底层是怎么跑起来的

核心思路是把桌面版 Minecraft 依赖的三样东西在 iOS 上重新接了一遍线。第一样是 Java 虚拟机：项目沿用 Boardwalk 路线，通过 Caciocavallo 这套 iOS 移植的 JRE 运行 Java 代码，构建时Makefile的jre目标会自动下载并解压 iOS 平台的 JRE 8/17/21。Java 侧入口是JavaApp/src/launcher/net/kdt/pojavlaunch/PojavLauncher.java，它负责解析启动参数、写入默认性能设置（渲染距离 2、粒子数量 1、mipmap 0），再把控制权交给原生层。

第二样是图形渲染。游戏通过 LWJGL3 调用 OpenGL，原生侧的Natives/ctxbridges/gl_bridge.m借助 GL4ES、MoltenVK 等组件把 GL 调用翻译成 iOS 的 Metal 指令；游戏画面的视图容器与交互则集中在Natives/SurfaceViewController.m。

第三样是输入。手柄、键盘、陀螺仪分别由Natives/input/ControllerInput.m、KeyboardInput.m、GyroInput.m处理，屏上虚拟按键的自定义布局在Natives/customcontrols/目录下实现。

想自己编译的话，流程由 Makefile 驱动（需要 iOS SDK 和交叉编译环境）：

git clone https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS cd PojavLauncher_iOS make all # 完整构建 make native # 仅原生部分 make java # 仅 Java 部分 make jre # 下载并解压 JRE make package # 打包成 IPA

性能调优与避坑指南

现象：游戏卡、帧率很低。原因：JIT 没有启用，代码只走了解释执行。解法：对照上面那张表检查自己的安装路线。AltStore 用户要确认电脑上的 AltServer 开着且在同一局域网；TrollStore 用户若没自动开启，说明签名时没带上对应权限，重装一次 IPA 通常能解决。

现象：点图标就闪退。原因：系统版本与安装方式不匹配，或设备不在支持列表内。解法：先确认系统是否 iOS 14 以上、设备是否满足最低配置；iOS 17/18 用户按官方说明配合电脑端 pymobiledevice3（需 Python 3.11）启用 JIT，而不是直接硬装。

现象：跑图一段时间后内存溢出被系统杀掉。原因：Java 堆内存和渲染参数设得太高。解法：在启动器设置里下调 JVM 内存分配，游戏内把渲染距离、视距调低，并定期清理缓存目录里的临时文件。推荐配置（iPhone XS 及以上）下默认参数已经偏保守，不建议盲目调高。

现象：装完模组游戏启动报错或贴图异常。原因：模组与游戏版本、与模组框架互相不匹配。解法：核对模组的适用版本号和框架类型（Forge 模组不能装进 Fabric），确认文件下载完整后重新放入对应的 mods 目录；拿不准时先只用原版启动验证启动器本身没问题。

现象：iOS 17.0 设备安装 TrollStore 后无法运行。原因：该版本的标准 TrollStore 流程被系统机制挡住。解法：按官方说明先使用 TrollRestore 处理系统版本，这一步完成后安装流程才和普通低版本一致。

继续深入

仓库根目录的README.md是最新的一手资料，Makefile里的 help 目标列出了全部构建目标，比任何第三方教程都可靠。项目本身已停止更新，官方明确指向继任项目 Amethyst-iOS，遇到新版本的兼容性问题建议去那里跟进，同时也保留 PojavLauncher 的官方社区渠道获取历史版本的技术支持。

如果你的设备在推荐列表里，现在就可以按"安装与配置"一节选一条路线开始侧载；低配设备则建议直接从 1.7 左右的版本玩起，等熟悉流程后再逐步尝试新版本。

【免费下载链接】PojavLauncher_iOSA Minecraft: Java Edition Launcher for Android and iOS based on Boardwalk. Succeeded by https://github.com/AngelAuraMC/Amethyst-iOS项目地址: https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS