PojavLauncher_iOS

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

Navigation

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

Introduction

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

Building

Requirements:- Mac OS X (tested: 10.15)- XCode (tested: 11.7.0)- 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```

How can it work?

• Use OpenJDK 16 from Procursus to get 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.

Current status

• [x] Java Runtime Environment: OpenJDK 16.
• [x] LWJGL3 iOS port: works
• [x] OpenGL: GL4ES
• [x] Did Minecraft recognize OpenGL?
• [x] OpenAL: use @kcat's openal-soft
• [x] Input pipe implementation
• [x] Account authentication (partial).
• [ ] Does it work? Partial.
• Currently, only Minecraft 1.14+ fully works.
• Forge won't work, but Fabric and OptiFine will.

Known issues

• Mojang authentication might not work, but copying logged in account json from Android will work.
• Camera position will be jumped to random location on first time touch.
• 1.12.2 and below only render a tiny panorama at bottom left corner.
• Other versions will crash for various reasons: Narrator crash, etc...
• It may crash sometimes, but try launch again until you get it works.

Installing OpenJDK 16

For Chimera/Odyssey bootstrap

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

For other jailbreak bootstrap

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

Directory locations

• Account json directory: /var/mobile/Documents/.pojavlauncher/accounts.
• 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

• Contributors of PojavLauncher Android and here.
• Apache Commons.
• jsr305
• org.json
• 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.
  

wget https://archive.org/download/github.com-PojavLauncherTeam-PojavLauncher_iOS_-_2021-02-14_12-22-44/PojavLauncherTeam-PojavLauncher_iOS_-_2021-02-14_12-22-44.bundle

 git clone PojavLauncherTeam-PojavLauncher_iOS_-_2021-02-14_12-22-44.bundle 

plus-circle Add Review

comment

Reviews