PojavLauncher_iOS 完全使用指南：在 iPhone 上完整运行 Minecraft Java 版-育师

PojavLauncher_iOS 完全使用指南：在 iPhone 上完整运行 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 Edition 启动器，面向 iPhone 和 iPad 用户，把完整的 Java 版 Minecraft 搬上 iOS 设备。它支持从最早的 beta 版到最新快照版的绝大多数版本，可安装 Forge、Fabric、OptiFine、Quilt 等模组加载器，并提供可自定义的触屏虚拟按键、键盘鼠标与手柄支持。适合想在 iOS 上玩 Java 版 Minecraft、并且愿意折腾一次安装流程的玩家。

一图速览：先判断它适不适合你

维度	说明
项目定位	iOS/iPadOS 平台的 Minecraft Java 版启动器（基于 Boardwalk）
解决什么问题	让 Java 版 Minecraft（含 Forge/Fabric 模组生态）在手机上运行
适合谁	拥有 iOS 14+ 设备、愿意使用 TrollStore/AltStore 等签名工具的玩家
上手难度	安装中等（需选择签名方式），游戏内操作简单
预计耗时	装好启动器约 10–20 分钟；首次启动下载 Java 运行环境和游戏文件需 20–60 分钟（视网速）

需要注意：⚠️ 该项目已停止维护（README 中有明确声明），继任项目为 Amethyst-iOS。如果你追求持续更新，装好本启动器后建议关注继任者。

开始前的检查：设备要求与 4 种签名方式怎么选

最低配置（iOS 14.0 及以上）：iPhone 6s 及以后、iPad 第 5 代及以后、iPad Air 第 2 代及以后、iPad mini 第 4 代及以后、iPad Pro 全系、iPod touch 第 7 代。

推荐配置（体验更流畅）：iPhone XS 及以后（不含 iPhone XR 和 iPhone SE 第 2 代）、iPad 第 10 代及以后、iPad Air 第 4 代及以后、iPad mini 第 6 代及以后、iPad Pro 全系（9.7 英寸除外）。

由于 App Store 无法上架这类应用，你需要选择一种侧载（签名）方式：

方式	优点	局限	推荐人群
TrollStore	永久签名、自动启用 JIT、提升内存上限	对 iOS 版本有要求；iOS 17.0 需配合 TrollRestore 降级，17.0 以上不支持	首选，条件允许就用它
AltStore	流程成熟	每次 7 天签名需刷新，JIT 需局域网内运行 AltServer	无法使用 TrollStore 时的次选
SideStore	无需电脑（走网页流程）	JIT 不自动启用，需手动处理	同上
越狱设备	永久签名、自动 JIT、更高内存上限	官方不建议作为日常使用方案	已越狱的用户

两个硬性限制要提前知道：使用分发证书（不绑定你设备 UDID）的签名服务不被支持，因为缺少 PojavLauncher 所需的能力（如附加调试器以启用 JIT）；另外只从可信来源下载安装工具，避免安装非官方软件带来风险。

想从源码构建的话，仓库地址是https://gitcode.com/GitHub_Trending/po/PojavLauncher_iOS，iOS 端原生代码位于 Natives/ 目录，Java 端代码在 JavaApp/src/ 目录，使用 Xcode 打开PojavLauncher.xcodeproj并依赖 Makefile 中的流程编译。

第一次启动的 3 步：下载、安装、登录

第 1 步：获取 IPA 并安装。从 Releases 页面下载正式版的 PojavLauncher IPA（Nightly 构建可能含有破坏游戏的 bug，新手不建议）。用 TrollStore 安装：通过系统的分享菜单选择"用 TrollStore 打开"。用 AltStore/SideStore 安装：在其"可信来源"菜单中添加PojavLauncher Repository，点击FREE按钮开始安装。

第 2 步：处理 JIT 启用。iOS 上应用必须处于被调试状态才能启用 JIT（即时编译），否则游戏速度慢到无法游玩。这一步的处理方式取决于你选的安装方式，见下文"调优建议"中的对照表。TrollStore 和越狱设备会自动启用，AltStore 需保证电脑上运行着 AltServer 且与手机处于同一 Wi-Fi。

第 3 步：登录并选版本。打开启动器，进入账户列表选择登录方式：使用 Microsoft 账户登录获得完整体验（对应源码见 Natives/authenticator/MicrosoftAuthenticator.m）；没有正版账号可用本地账户或演示模式（演示模式适用于 1.3.1 及更新版本）。登录后在版本列表选择要玩的版本，首次启动会自动下载对应的 Java 运行环境和游戏文件，耐心等待进度条走完即可进入游戏。

功能怎么走：按任务完成登录、换版本、装模组

任务 1：登录游戏。结论：三种入口都从账户列表进入，互不影响。

Microsoft 账户：输入微软账号密码，走 OAuth 流程登录，适合正版玩家。
本地账户（LocalAuthenticator）：输入任意名字即可离线游玩，无法访问正版服务器。
演示模式：未购游戏的试玩入口，限制在 1.3.1 及以上版本。

任务 2：切换游戏版本。结论：版本与配置文件（Profile）绑定，切换版本前最好各建一个 Profile。

版本列表覆盖从最初 beta 到最新快照的几乎所有 Java 版版本。
每个 Profile 可独立设置游戏目录、Java 版本偏好（如 1.16.5 及以下与 1.17+ 会默认匹配不同 JRE，见 Natives/JavaLauncher.m）。
开启"版本隔离"偏好后，不同版本的存档与配置互不干扰。

任务 3：安装模组加载器。结论：Forge、Fabric/Quilt 都有专属安装界面，选版本和加载器版本后一键安装。

Forge：打开 Forge 安装界面，选游戏版本与 Forge 版本，安装后把模组文件放进mods文件夹。
Fabric/Quilt：在 Natives/installer/ 对应的安装页选择 Fabric 或 Quilt 及对应版本号。
整合包：内置 CurseForge 与 Modrinth 的 API 支持（见 Natives/installer/modpack/），可以直接导入第三方整合包。

任务 4：自定义操控。结论：虚拟按键完全可自定义，同时支持外接设备。

在自定义控制界面（见 Natives/CustomControlsViewController.m）添加、拖动、缩放按键，支持子按钮与组合键，可调整透明度与颜色，并设置安全区域。
外接键盘、鼠标、游戏手柄均可识别，手柄与键盘输入由 Natives/input/ 模块处理。
支持陀螺仪作为辅助输入（GyroInput）。

调优建议：JIT 对照表与 2 个最值的设置

第 1 项（收益最大）：按你的安装方式确认 JIT 已启用。没有 JIT，游戏帧率会低到不可用：

安装方式	需要外部设备	需要 Wi-Fi	是否自动启用
AltStore	是（电脑跑 AltServer）	是	是（需本地网络）
SideStore	否	是	否，需手动
TrollStore	否	否	是
越狱	否	否	是

iOS 17.x/18.x 系统上，启用 JIT 需要电脑上正确配置 Python 3.11 环境并使用 pymobiledevice3 工具，请按官方 Wiki 的 JIT 章节操作。

第 2 项：内存分配。在启动器偏好里给游戏分配 1–2GB 内存（-Xmx参数），低于 1GB 容易出现卡顿和崩溃；TrollStore/越狱签名本身有更高的内存上限，可以更激进地分配。

第 3 项：游戏内图形设置。渲染距离建议 8–12 区块，画质选"快速"或"流畅"，关闭光影类模组（Vulkan 光影依赖 shaderc，对性能要求很高），这样在推荐机型上才能维持可玩的帧率。

排障手册：5 个高频问题怎么处理

症状	常见原因	处理步骤
启动时提示 Java 运行环境缺失	对应版本的 JRE 尚未下载完整	检查存储空间是否充足；在网络稳定的环境重新选择该版本启动，等待下载完成
游戏能进但慢到无法操作	JIT 未生效（AltStore 场景最常见）	确认电脑上 AltServer 正在运行、与手机同一 Wi-Fi；重启应用后观察日志中 JIT 相关输出
iOS 升级到 17 以上后装不上/无法签名	17.0 以上版本不被现有 TrollStore 方案支持	使用 TrollRestore 将系统恢复到 17.0 再装 TrollStore，或改用 AltStore/SideStore
启动时弹出"requested Java >= X was not installed"类错误	该版本要求更高的 Java 版本，本机未安装	在 JRE 管理偏好（Natives/LauncherPrefManageJREViewController.m 对应界面）中下载所需的 Java 版本
模组装完进游戏就闪退	模组与游戏版本不匹配，或模组不适配 ARM 架构	确认模组对应游戏版本；逐个移除模组排查冲突；优先选用官方推荐的加载器版本组合

结语

PojavLauncher_iOS 用一次侧载安装，就能在 iPhone/iPad 上跑起带模组的完整 Java 版 Minecraft，核心是选对签名方式并让 JIT 生效。下一步：按"开始前的检查"表格选一种签名方案，下载 Releases 里的 IPA 开始安装；若需要长期维护的版本，关注其继任项目 Amethyst-iOS 即可。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考