掌上 Java，不只是“能启动”。
A modern Minecraft: Java Edition launcher built for iPhone and iPad.
简体中文 · English · 下载 Releases · 反馈问题
Important
PocketJ Launcher 是社区维护的开源项目，并非 Mojang Studios 或 Microsoft 的官方产品。Minecraft 是 Microsoft Corporation 的商标。
很多移动端 Java 启动器止步于“把游戏打开”。PocketJ 更想把桌面启动器的完整体验带到 iOS：在一个原生应用里完成 JIT、实例、Java、模组、整合包、账户、控制与诊断。
同时，PocketJ 不只关注功能完整性，也持续针对 iOS 环境优化启动流程、资源加载和渲染体验。相比早期移动端 Java 启动方案，PocketJ 在保持兼容性的基础上，对启动链路、运行效率和设备适配进行了大量优化，目标是在 iPhone 和 iPad 上提供更快速、更稳定、更接近桌面体验的 Minecraft Java 运行效果。
它基于 GPL-3.0 项目 Amethyst-iOS 持续开发，并继承了 PojavLauncher 与 Boardwalk 生态的工作。v1.3 在保留成熟 JVM 与启动内核的基础上，将全世代 Minecraft、在线资源和个性化体验整合进 PocketJ 的 iOS 工作流。
想先看看 PocketJ 在不同设备上的实际效果？进入 截图画廊，可按 iOS 27、iPadOS 18、iPhone X + iOS 14 以及 Forge 测试分类浏览；所有缩略图均可点击查看原图。
| PocketJ 能力 | 你可以做什么 |
|---|---|
| ⚡ 内置 JIT 工作流 | 在启动器内导入本机配对文件、检查状态并为 PocketJ 自身开启 JIT；就绪后可从“开始游戏”直接衔接启动 |
| 🧩 iOS 原生资源中心 | 浏览 Modrinth 与 CurseForge，按实例版本和加载器筛选模组、整合包、光影包、材质包与数据包 |
| 🎛️ 实例级模组管理 | 查看已安装模组、启用/停用、检查更新、选择具体版本；不兼容项目会被明确标记，但选择权仍交给玩家 |
| 📦 统一实例与整合包入口 | 新建实例、导入 ZIP、浏览在线整合包都集中在同一个 + 菜单；每个整合包创建独立实例，避免覆盖当前游戏 |
| ☕ 智能 Java 分配 | 内置并管理 Java 8、17、21、25，根据 Minecraft 世代自动选择，同时允许高级用户逐实例覆盖 |
| 🕰️ 经典与远古版本兼容 | 为旧版 Java、内存与启动参数提供独立兼容路径；兼容开关可随时关闭，避免影响现代版本 |
| 🌍 Minecraft 全世代支持 | 从远古 Alpha / Beta、经典正式版到现代 26.x，由 Java 8 / 17 / 21 / 25 和分代渲染路径自动匹配 |
| 🎨 自定义启动器背景 | 选择任意图片，按当前 iPhone / iPad 屏幕比例裁切，并独立调整背景透明度 |
| ⏯️ 可恢复下载队列 | 下载暂停、继续、失败重试与本地文件复用；有效文件不会无意义地重复下载 |
| 🎮 真正为触屏设计 | 原版控制编辑器、触控键位、手柄映射分区，以及可即时切换的灵敏八方向移动逻辑 |
| 👤 正版与离线账户共存 | Microsoft 与离线账户使用独立身份保存；同名账户不再互相覆盖，并支持 Minecraft 皮肤头像缓存 |
| 🧾 不再黑屏猜错 | 下载、JIT、加载器安装和游戏启动均有可见状态；日志可查看、导出并用于 Issue 定位 |
⚡ 内置 JIT 是怎样工作的？
- iOS / iPadOS 17.4 及以上可在 PocketJ 内导入本机
.plist或.mobiledevicepairing配对文件。 - 启动 LocalDevVPN 后，可以在 PocketJ 的运行环境页面直接开启 JIT。
- “等待配置 / 就绪 / 已启动 / 不可用”状态会明确显示，不再只给出模糊的可用提示。
- 从首页启动时，PocketJ 可先完成 JIT，再继续启动 Minecraft。
- JIT、扩展虚拟地址空间和更高内存限制是三种不同能力；最终可用性仍取决于系统、签名和 entitlement。
🧩 模组工作流包含什么？
- 内置 Modrinth 与 CurseForge 搜索、项目图标、版本列表与兼容性筛选。
- 模组、整合包、光影包、材质包和数据包共用原生在线浏览与下载流程。
- 自动读取当前实例的 Minecraft 版本与 Fabric / Forge / NeoForge / Quilt 元数据。
- 对已安装
.jar使用可逆的.disabled方式开关，不删除原文件。 - 新建和编辑实例共用统一加载器模型，Minecraft 版本与 Loader 版本不再混为一谈。
| 组合 | 当前定位 |
|---|---|
| Minecraft 26.x 与现代版本 | 🟢 已接入新版 LWJGL 兼容层和对应渲染链，可正常呈现世界方块 |
| Minecraft 1.x 经典正式版 | 🟢 按版本世代自动匹配 Java Runtime 和渲染器 |
| Alpha / Beta 与远古版本 | 🟢 具备独立旧版内存兼容路径，不干扰现代版本 |
| Fabric / Forge / NeoForge / Quilt | 🟢 统一 Minecraft 版本和 Loader 版本模型，依据实例筛选对应加载器版本 |
Tip
初次体验仍建议从稳定正式版开始。极旧或加载器组合仍受上游资源和设备内存影响，出现问题时请附上 latestlog.txt。
- iOS / iPadOS 14.0–27
- 64 位 arm64 iPhone 或 iPad
- 现代 Minecraft 通常需要 JIT、足够的可用内存和正确的签名权限
- 新版 Minecraft 与大型整合包推荐使用内存更充足的设备
前往 GitHub Releases 下载：
| 文件 | 用途 |
|---|---|
PocketJLauncher-v1.3-iOS.ipa |
开发者签名、AltStore、SideStore 及兼容的 IPA 侧载方式 |
PocketJLauncher-v1.3-iOS-TrollStore.tipa |
适用于受支持的 TrollStore 环境 |
SHA256SUMS.txt |
校验下载文件是否完整、是否与发布产物一致 |
Warning
普通签名证书不一定包含 Java 所需的 JIT、扩展虚拟地址空间和更高内存 entitlement。安装成功不等于这些能力均已生效。
- 安装 PocketJ Launcher。
- 添加 Microsoft 账户或离线账户。
- 在“游戏”中创建实例，推荐选择
1.21.11 + Fabric。 - 在“设置 → 运行环境 → JIT”完成配置并开启 JIT。
- 回到“启动”，等待资源完成后开始游戏。
- macOS 与 Xcode
- Xcode Command Line Tools
- Homebrew 中的
gmake、cmake、wget、ldid - Java 8 Boot JDK（仅用于编译启动器；不等于 Minecraft 实例使用的 Java 版本）
- 打开
PocketJLauncher.xcodeproj。 - 选择 PocketJ Launcher scheme。
- 在 Signing & Capabilities 中选择自己的开发团队。
- 连接 iPhone / iPad，Clean Build Folder 后运行。
gmake payload PLATFORM=2 BOOTJDK="/path/to/jdk8/bin"🗂️ 仓库结构
PocketJLauncher.xcodeproj Xcode 真机构建入口
XcodeRunner/ App、JIT Helper 与构建包装逻辑
Natives/ iOS UI、实例、模组、JIT 与原生运行层
JavaApp/ Java 启动器及 LWJGL 兼容代码
Vendor/StikJIT/ 内置 JIT 相关组件
THIRD_PARTY_LICENSES/ 第三方许可证
Makefile 原生、Java、Runtime 与打包流程
NOTICE.md 修改声明及上游归属
提交 Issue 时请尽量包含：
- 设备型号与 iOS / iPadOS 版本
- PocketJ 版本
- Minecraft、Java、模组加载器及其版本
- 完整复现步骤
latestlog.txt（请先移除账户令牌、证书等隐私数据）
Erico · @EricoEC
项目主页：github.com/EricoEC/PocketJLauncher
PocketJ Launcher 主项目依据 GNU GPL v3.0 发布。项目包含源自 StikDebug 的修改代码，其许可证及归属见 NOTICE.md 与 THIRD_PARTY_LICENSES。分发修改版本或二进制时，请同时履行适用的源代码、版权、许可证及无担保声明义务。
感谢 Amethyst-iOS、PojavLauncher、Boardwalk、StikDebug、Fabric、Quilt、Modrinth 及所有第三方组件贡献者。上游代码版权归各自作者所有。
Copyright © 2026 Erico.
Many mobile Java launchers stop at opening the game. PocketJ aims to bring a complete desktop-launcher workflow to iOS: JIT, instances, Java runtimes, mods, modpacks, accounts, controls, and diagnostics—all inside one native app.
At the same time, PocketJ focuses not only on feature completeness, but also on improving the iOS Java runtime experience. Compared with earlier mobile Java launcher solutions, PocketJ introduces continuous optimizations across the launch pipeline, resource loading, rendering experience, and device adaptation, aiming to provide a faster, more stable Minecraft Java experience closer to desktop launchers on iPhone and iPad.
PocketJ is developed from the GPL-3.0 licensed Amethyst-iOS project and inherits substantial work from the PojavLauncher and Boardwalk ecosystems. Version 1.3 keeps the mature JVM and launch core while unifying every Minecraft generation, online resources, and personalization in an iOS-first workflow.
Visit the screenshot gallery to browse iOS 27, iPadOS 18, iPhone X + iOS 14, and Forge test galleries. Every compact preview opens its full-resolution image.
| PocketJ capability | What it gives you |
|---|---|
| ⚡ Built-in JIT workflow | Import this device's pairing file, inspect state, and enable JIT for PocketJ itself without leaving the launcher workflow |
| 🧩 Native resource center | Browse Modrinth and CurseForge mods, modpacks, shaders, resource packs, and data packs with instance-aware filtering |
| 🎛️ Per-instance mod management | Inspect installed mods, enable or disable them, check updates, and choose exact versions |
| 📦 Unified instance and modpack entry | Create an instance, import a ZIP, or browse online modpacks from one + menu; modpacks are isolated instead of replacing the active instance |
| ☕ Smart Java selection | Manage Java 8, 17, 21, and 25; automatically match game generations while retaining per-instance overrides |
| 🕰️ Classic-version compatibility | A dedicated legacy path adjusts Java-era memory and startup behavior without changing the modern path |
| 🌍 Every Minecraft generation | Alpha, Beta, classic releases, modern releases, and 26.x use generation-aware Java and rendering paths |
| 🎨 Custom launcher backgrounds | Crop a photo to the current iPhone or iPad aspect ratio and control its transparency independently |
| ⏯️ Resumable downloads | Pause, resume, retry, and reuse valid local files instead of downloading everything again |
| 🎮 Touch-first controls | Original control editor, separated touch/controller mapping, and responsive eight-direction movement |
| 👤 Microsoft and offline coexistence | Separate account identities prevent same-name accounts from replacing each other; Minecraft avatar caching is included |
| 🧾 Visible launch state | JIT, downloads, loader installation, and game launch expose progress and exportable logs instead of silent black screens |
⚡ How does built-in JIT work?
- On iOS / iPadOS 17.4 and later, import this device's
.plistor.mobiledevicepairingfile inside PocketJ. - Start LocalDevVPN, then enable JIT from PocketJ's Runtime page.
- PocketJ reports Waiting for Setup, Ready, Enabled, or Unavailable states.
- Starting from the home screen can enable JIT first and then continue into Minecraft.
- JIT, extended virtual address space, and increased memory limits are separate capabilities and still depend on the OS, signature, and entitlements.
🧩 What is included in the mod workflow?
- Built-in Modrinth and CurseForge search, icons, version selection, and compatibility filters.
- One native workflow for mods, modpacks, shaders, resource packs, and data packs.
- Instance metadata detection for Minecraft and Fabric / Forge / NeoForge / Quilt.
- Reversible
.disabledtoggles for installed JAR files. - One loader model shared by creation and editing, keeping Minecraft versions separate from loader versions.
| Combination | Current status |
|---|---|
| Minecraft 26.x and modern releases | 🟢 Uses the new LWJGL compatibility and renderer path, including normal world-block rendering |
| Classic Minecraft 1.x releases | 🟢 Automatically selects a generation-appropriate Java runtime and renderer |
| Alpha, Beta, and legacy releases | 🟢 Uses an isolated legacy-memory compatibility path without changing modern versions |
| Fabric / Forge / NeoForge / Quilt | 🟢 Shares one Minecraft/loader version model and filters loader releases against the selected game version |
Tip
A stable release is still the easiest first run. Very old or loader-heavy combinations remain sensitive to upstream assets and device memory; attach latestlog.txt when reporting an issue.
- iOS / iPadOS 14.0–27
- A 64-bit arm64 iPhone or iPad
- Modern Minecraft generally needs JIT, enough available memory, and appropriate signing entitlements
- Newer Minecraft releases and large modpacks benefit from newer devices
Get release assets from GitHub Releases:
| File | Purpose |
|---|---|
PocketJLauncher-v1.3-iOS.ipa |
Development signing, AltStore, SideStore, and compatible IPA sideloading methods |
PocketJLauncher-v1.3-iOS-TrollStore.tipa |
Supported TrollStore environments |
SHA256SUMS.txt |
Verifies release-file integrity |
Warning
A signing certificate may install the app without granting JIT, extended virtual address space, or increased-memory entitlements.
- Install PocketJ Launcher.
- Add a Microsoft or offline account.
- Create an instance under Games;
1.21.11 + Fabricis recommended. - Configure JIT under Settings → Runtime → JIT.
- Return to Launch, let resources finish, and start the game.
- macOS and Xcode
- Xcode Command Line Tools
gmake,cmake,wget, andldidfrom Homebrew- A Java 8 Boot JDK for compiling the launcher; this is separate from the Java runtime selected for Minecraft
- Open
PocketJLauncher.xcodeproj. - Select the PocketJ Launcher scheme.
- Choose your development team under Signing & Capabilities.
- Connect an iPhone or iPad, Clean Build Folder, and run.
gmake payload PLATFORM=2 BOOTJDK="/path/to/jdk8/bin"🗂️ Repository layout
PocketJLauncher.xcodeproj Xcode device-build entry point
XcodeRunner/ App, JIT Helper, and build-wrapper logic
Natives/ iOS UI, instances, mods, JIT, and native runtime
JavaApp/ Java launcher and LWJGL compatibility code
Vendor/StikJIT/ Built-in JIT components
THIRD_PARTY_LICENSES/ Third-party license texts
Makefile Native, Java, runtime, and packaging pipeline
NOTICE.md Modification notice and upstream attribution
Please include the following in a useful bug report:
- Device and iOS / iPadOS version
- PocketJ version
- Minecraft, Java, mod loader, and loader version
- Complete reproduction steps
latestlog.txt, after removing tokens, certificates, and private data
Erico · @EricoEC
Project home: github.com/EricoEC/PocketJLauncher
The PocketJ Launcher main project is distributed under GNU GPL v3.0. It includes modified StikDebug-derived code; see NOTICE.md and THIRD_PARTY_LICENSES for applicable attribution and license texts. Binary and modified-source distribution must preserve all applicable source, copyright, license, and warranty-notice obligations.
Thanks to Amethyst-iOS, PojavLauncher, Boardwalk, StikDebug, Fabric, Quilt, Modrinth, and every third-party contributor. Copyright in upstream code remains with its respective authors.
Copyright © 2026 Erico.