PojavLauncher_iOS/README.md

PojavLauncher_iOS

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

Navigation

• Introduction
• Building
• Current status
• License
• Contributing
• Credits & Third party components and their licenses

Introduction

• This is an attempt to get Minecraft Java run on a jailbroken iOS.
• There's no eta on this project.

How can it work?

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

Current status

• Java Runtime Environment: OpenJDK 16.
• LWJGL3 iOS port: works
• OpenGL: GL4ES
• Did Minecraft recognize OpenGL?
• Does it work?
• Current error: GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT tested on Minecraft 1.13, 1.14 and 1.15.2 (probably all other versions).

Installing OpenJDK 16

• Download openjdk-16-jre • Procursus .deb file (~40mb).

For jailbroken iOS device

• Jailbreak use Odyssey
• Add Procursus repository (https://apt.procurs.us).
• Find and install java-16-openjdk.

For non-jailbroken devices

• It’s not possible...

Want a try or debug?

• Minecraft home directory: /var/mobile/Documents/minecraft.
• Select a version: edit /var/mobile/Documents/minecraft/config_ver.txt, put to Minecraft version want to start.

License

• PojavLauncher is licensed under GNU GPLv3.

Contributing

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.

Credits & Third party components and their licenses

• Boardwalk (JVM Launcher): Unknown License/Apache License 2.0 or GNU GPLv2.
• GL4ES: MIT License.
  
• OpenJDK: GNU GPLv2 License.
  
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.