Minecraft: Java Edition launcher for iOS, based on PojavLauncher Android.

This launcher is now available at the Procursus repository, thanks to @Diatrus!

• Introduction
• Building
• How can it work?
• Current status
• Known issues
• License
• Contributing
• Credits & Third party components and their licenses

• This is an attempt to get Minecraft: Java Edition running on jailbroken iOS.
• Minimum requirements: device running iOS 12 or newer.

Requirements:

• Mac OS X (tested: 10.15)
• Xcode (tested: 11.7.0)
• Minimum iOS SDK: 13.4.
• JDK 8 installed
• gradle to build Java part.
• cmake, wget, ldid, dpkg and fakeroot to package. Run in this directory

# Only run if you haven't installed JDK 8
brew install adoptopenjdk8

# Install required packages
brew install cmake wget ldid dpkg fakeroot gradle

# Give exec perm
chmod 755 *.sh

# Build natives part
./build_natives.sh

# Build java part
./build_javaapp.sh

# Sign with entitlements and package
./build_package.sh

• Use OpenJDK 16 from Procursus to get a real Java environment.
• Use MetalANGLE for OpenGL ES -> Metal translator.
• Use GL4ES for OpenGL -> OpenGL ES translator.
• Use our LWJGL3 iOS port.
• Use same launch method as PojavLauncher Android.

• Java Runtime Environment: OpenJDK 16.
• LWJGL3 iOS port: works
• OpenGL: GL4ES
• Did Minecraft recognize OpenGL?
• OpenAL: use @kcat's openal-soft
• Input pipe implementation
• Account authentication (partial).
• Does it work? Partial.
• Currently, only Minecraft 1.6.1+ is tested to fully work.
• Forge (1.16.?+), Fabric and OptiFine work well.

• On some versions, the camera position will jump to a random location on first time touch.
• It might crash sometimes, but try to launch again until it works.

• Add Procursus repository (https://apt.procurs.us) (usually the Sileo package manager already comes with the Procursus repo).
• Find and install openjdk-16-jre.

• Add Doregon's repository (https://doregon.github.io/cydia)
• Find and install openjdk-16-jre.

• Download openjdk-16-jre.deb.
• Install and open Filza File manager.
• Go to where the .deb file was downloaded.
• Open it and press Install.
• If everything is fine, it will ends up with Setting up ....

• Add Procursus repository (https://apt.procurs.us) (usually the Sileo package manager already comes with Procursus repo).
• Find and install pojavlauncher.

• Add Doregon's repository (https://doregon.github.io/cydia)
• Find and install pojavlauncher for the release version, or pojavlauncher-dev for the latest good commit.

• To get the release version,

  • Go to the Releases tab
  • Find the release you want
  • Download the .deb file
  • Open the .deb in Filza or install via a terminal!

• To get the latest commit,

  • Download the latest build artifact from here
  • Unzip to reveal the .deb file
  • Open the .deb in Filza or install via a terminal!

• Account json directory: /var/mobile/Documents/.pojavlauncher/accounts.
• Minecraft home directory: /var/mobile/Documents/minecraft.
• You can also customize JVM Arguments in overrideargs.txt on .pojavlauncher directory and customize environment variables in custom_env.txt on .pojavlauncher directory.

• PojavLauncher is licensed under GNU GPLv3.

Contributions are welcome! We welcome any type of contribution, not only code. Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it.

• Contributors of PojavLauncher Android and here.
• Apache Commons: Apache License 2.0.
• jsr305: 3-Clause BSD License.
• org.json: The JSON License.
• Boardwalk (JVM Launcher): Unknown License/Apache License 2.0 or GNU GPLv2.
• GL4ES by @lunixbochs @ptitSeb: MIT License.
  
• MetalANGLE by @kakashidinho and ANGLE team: BSD License 2.0.
• OpenJDK 16 ported to iOS by @Diatrus: GNU GPLv2 License.
  
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.