korboybeats / PojavLauncher_iOS

A Minecraft: Java Edition Launcher for Android and iOS based on Boardwalk. This repository contains source code for iOS/iPadOS platform.

PojavLauncher

Note

• The official Twitter for PojavLauncher is @PLaunchTeam. Any others (most notably @PojavLauncher) are fake, please report them to Twitter's moderation team.

Introduction

• PojavLauncher is a Minecraft: Java Edition launcher for Android and iOS based on Boardwalk.
• This launcher can launch most of available Minecraft versions (up to latest 1.19.2, including Combat Test versions).
• Modding via Forge and Fabric are also supported.
• Older versions of Forge and Fabric can be used with OpenJDK 8.
• This repository contains source code for iOS/iPadOS platform.
• For Android platform, check out PojavLauncher repository.

This launcher is available on the Procursus repo, thanks to @Diatrus, and Doregon's Repository, thanks to @crystall1ndev

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 (on iOS 12 or later):

Without jailbreak (sideload as IPA)

Note: This is experimental, although game works smoothly, you should not set Render distance too much.

1. Setup the sideload app

• For iOS 14.0-15.5beta4 on compatible devices, TrollStore is recommended to keep PojavLauncher permanently signed and have JIT enabled by itself.
• Otherwise, install AltStore. Others will also work.

2. Download an IPA build of PojavLauncher in the Actions tab.
3. Open the downloaded IPA in the sideload app to install.
4. For enabling JIT, choose one of these:

• Setup JitStreamer, then launch PojavLauncher. JIT will be automatically enabled on startup. This is the most convenient way.
• Launch PojavLauncher with Enable JIT option in AltStore. This requires the device to be plugged in the computer or have Wi-Fi syncing enabled.
• Setup and use others such as Jitterbug.

Procursus-bootstraps

Note: This is currently unavailable. Will be fixed soon! For the meantime, you can follow the same way as below. If you have Chimera, Taurine, Odyssey, or another jailbreak that comes with libhooker, this one's for you.

1. Search for pojavlauncher with your favorite package manager.
2. Install PojavLauncher iOS.

Bingner/Elucubratus bootstraps

If you have unc0ver, checkra1n, or another jailbreak that comes with Cydia Substrate or Substitute, this one's for you. You can also use this if you have a libhooker jailbreak.

1. Add https://repository.crystall1ne.software to your sources list.
2. Search for pojavlauncher with your favorite package manager.
3. Install the package you wish to have, according to your preference:
   • pojavlauncher.release is the stable build. This one gets updated with new releases or tags on this repository, or when Procursus updated their copy.
   • pojavlauncher.development is the latest commit on the main branch of this repository. It may have application breaking bugs, but also has more features.
   • The rootless variants serve the same purpose, but only work with Procursus jailbreaks and iOS 15 (see our website for more information).

Known issues

• Some Forge versions may fail with java.lang.reflect.InvocationTargetException.
• The game will be prone to JetsamEvents.

Contributors

PojavLauncher is amazing, and surprisingly stable, and it wouldn't be this way without the following people that helped and contribute to the project!

@khanhduytran0 - Lead iOS port developer
@crystall1nedev - Lead iOS port developer
@artdeell - Lead developer
@LegacyGamerHD - Lead developer
@zhouwei - Original Boardwalk code
@Mathius-Boulay - Developer
@jkcoxson - JitStreamer author
@Diatrus - PojavLauncher hosting on Procursus
@Syjalo
@pedrosouzabrasil
@notfoundname
@buzybox11
@RealEthanPlayzDev
@HongyiMC
@thecoder08
@genericrandom64

Third party components and their licenses

• Caciocavallo: GNU GPLv2 License.
• jsr305: 3-Clause BSD License.
• org.json: The JSON 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.
• OpenJDK 16 ported to iOS by @Diatrus: GNU GPLv2 License.
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.
• Alderis (color picker for iOS < 14): Apache 2.0 License.
• DBNumberedSlider: Apache 2.0 License
• fishhook (jailed environment usage only): BSD-3 License.
• Java Native Access: Apache 2.0 License.
• shaderc (used by mods that uses Vulkan for rendering): Apache 2.0 License.
• TOInsetGroupedTableView: MIT License.

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.