PojavLauncher for iOS

Introduction

PojavLauncher is a Minecraft: Java Edition launcher for Android, iOS, and iPadOS, based off of zhouwei's Boardwalk project.

• Supports most versions of Minecraft: Java Edition, from the very first beta to the newest snapshots.
• Supports Forge, Fabric, OptiFine, and Quilt for you to customize the experience with supported mods.
• Includes customizable on-screen controls, keyboard and mouse support, and game controller support.
• Optimized for jailbroken and TrollStore devices to enable better capabilities.
• Microsoft account and demo mode support for logging into Minecraft.
• ...and much more!

This repository contains the code for our iOS and iPadOS port of PojavLauncher. Looking for Android?

Getting started with PojavLauncher

The PojavLauncher Website has extensive documentation on how to install, set up, and play! For those who wish to install quickly, here's the basics:

Requirements

At the minimum, you'll need one of the following devices on iOS 14.0 and later:

• iPhone 6s and later
• iPad (5th generation) and later
• iPad Air (2nd generation) and later
• iPad mini (4th generation) and later
• iPad Pro (all models)
• iPod touch (7th generation)

However, we recommend one of the following devices on iOS 14.0 and later:

• iPhone XS and later, excluding iPhone XR and iPhone SE (2nd generation)
• iPad (10th generation) and later
• iPad Air (4th generation) and later
• iPad mini (6th generation) and later
• iPad Pro (all models, except for 9.7-inch)

Recommended devices provide a smoother and more enjoyable gameplay experience compared to other supported devices.

• tvOS support is in development.
• iOS 17 is not currently supported, as Apple broke every iOS app debugger outside of Xcode.

Setting up to sideload

PojavLauncher can be sideloaded in many ways. Our recommended solution is to install TrollStore if your iOS version supports it. Installing with TrollStore allows you to permenantly sign the application, automatically enable JIT, and increase memory limits.

If you cannot, AltStore and SideStore are your next best options.

• Signing services that do not use your UDID (and use distribution certificates) are not supported, as PojavLauncher requires capabilities they do not allow.
• Only install sideloading software and PojavLauncher from trusted sources. We are not responsible for any harm caused by using unofficial software.
• Jailbreaks also benefit from permenant signing, autoJIT, and increased memory limits, however we do not recommend them for regular use.

Installing PojavLauncher

Release build (TrollStore)

1. Download an IPA of PojavLauncher in Releases.
2. Open the package in TrollStore using the share menu.

Release build (AltStore/SideStore trusted source)

1. Add PojavLauncher Repository from the Trusted Sources menu.
2. Tap FREE to begin installing.

Nightly builds

These builds can contain game-breaking bugs. Use with caution.

1. Download an IPA build of PojavLauncher in the Actions tab.
2. Open the downloaded IPA in your sideloading app to install.

Enabling JIT

PojavLauncher makes use of just-in-time compilation, or JIT, to provide usable speeds for the end user. JIT is not supported on iOS without the application being debugged, so workarounds are required to enable it. You can use this chart to determine the best solution for you and your setup.

(*) AltServer running on the local network is required.

Contributors

PojavLauncher is amazing, and surprisingly stable, and it wouldn't be this way without the commmunity that helped and contribute to the project! Some notable names:

@khanhduytran0 - Lead iOS port developer
@crystall1nedev - Lead iOS port developer
@artdeell
@Mathius-Boulay
@zhuowei
@jkcoxson
@Diatrus

Third party components and their licenses

• Caciocavallo: GNU GPLv2 License.
• jsr305: 3-Clause BSD License.
• Boardwalk: Apache 2.0 License
• GL4ES by @lunixbochs @ptitSeb: MIT License.
• Mesa 3D Graphics Library: MIT License.
• MetalANGLE by @kakashidinho and ANGLE team: BSD 2.0 License.
• MoltenVK: Apache 2.0 License.
• openal-soft: LGPLv2 License.
• Azul Zulu JDK: GNU GPLv2 License.
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.
• DBNumberedSlider: Apache 2.0 License
• fishhook: BSD-3 License.
• Java Native Access: Apache 2.0 License.
• shaderc (used by Vulkan rendering mods): Apache 2.0 License.
• NRFileManager: MPL-2.0 License
• AltKit
• UnzipKit: BSD-2 License.
• DyldDeNeuralyzer: bypasses Library Validation for loading external runtime
• Thanks to MCHeads for providing Minecraft avatars.

Special thanks to MacStadium!

This project is listed under the MacStadium Open Source Program, which allows all of us developers to keep on moving forward even without physical access to a Mac.