Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/PojavLauncherTeam/PojavLauncher_iOS

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

ios-app minecraft minecraft-launcher

Last synced: about 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/PojavLauncherTeam/PojavLauncher_iOS
Owner: PojavLauncherTeam
License: gpl-3.0
Created: 2020-12-28T22:58:35.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2024-04-13T12:08:43.000Z (7 months ago)
Last Synced: 2024-04-14T02:21:48.483Z (7 months ago)
Topics: ios-app, minecraft, minecraft-launcher
Language: Objective-C
Homepage:
Size: 192 MB
Stars: 1,960
Watchers: 108
Forks: 414
Open Issues: 32
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/PojavLauncherTeam/PojavLauncher_iOS - [iOS] Minecraft Java Edition launcher (Jump To / Games)
awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/PojavLauncherTeam/PojavLauncher_iOS - [iOS] Minecraft Java Edition launcher (Jump To / Games)

README

        # PojavLauncher for iOS

[![Development build](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/actions/workflows/development.yml/badge.svg?branch=main)](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/actions/workflows/development.yml)

[![Crowdin](https://badges.crowdin.net/pojavlauncher/localized.svg)](https://crowdin.com/project/pojavlauncher)

[![Discord](https://img.shields.io/discord/724163890803638273.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/pojavlauncher-724163890803638273)

## Introduction

PojavLauncher is a Minecraft: Java Edition launcher for Android, iOS, and iPadOS, based off of zhuowei's [Boardwalk](https://github.com/zhuowei/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?](https://github.com/PojavLauncherTeam/PojavLauncher)

## Getting started with PojavLauncher

The [PojavLauncher Website](https://pojavlauncherteam.github.io/INSTALL.html#ios) 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](https://github.com/opa334/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](https://altstore.io) and [SideStore](https://sidestore.io) 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](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/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](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/actions).

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.

| Application         | AltStore | SideStore | TrollStore | Jitterbug          | Jailbroken |

|---------------------|----------|-----------|------------|--------------------|------------|

| Requires ext-device | Yes      | No        | No         | If VPN unavailable | No         |

| Requires Wi-Fi      | Yes      | Yes       | No         | Yes                | No         |

| Auto enabled        | Yes(*)   | No        | Yes        | No                 | Yes        |

(*) 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](https://github.com/PojavLauncherTeam/caciocavallo): [GNU GPLv2 License](https://github.com/PojavLauncherTeam/caciocavallo/blob/master/LICENSE).

- [jsr305](https://code.google.com/p/jsr-305): [3-Clause BSD License](http://opensource.org/licenses/BSD-3-Clause).

- [Boardwalk](https://github.com/zhuowei/Boardwalk): [Apache 2.0 License](https://github.com/zhuowei/Boardwalk/blob/master/LICENSE) 

- [GL4ES](https://github.com/ptitSeb/gl4es) by @lunixbochs @ptitSeb: [MIT License](https://github.com/ptitSeb/gl4es/blob/master/LICENSE).

- [Mesa 3D Graphics Library](https://gitlab.freedesktop.org/mesa/mesa): [MIT License](https://docs.mesa3d.org/license.html).

- [MetalANGLE](https://github.com/khanhduytran0/metalangle) by @kakashidinho and ANGLE team: [BSD 2.0 License](https://github.com/kakashidinho/metalangle/blob/master/LICENSE).

- [MoltenVK](https://github.com/KhronosGroup/MoltenVK): [Apache 2.0 License](https://github.com/KhronosGroup/MoltenVK/blob/master/LICENSE).

- [openal-soft](https://github.com/kcat/openal-soft): [LGPLv2 License](https://github.com/kcat/openal-soft/blob/master/COPYING).

- [Azul Zulu JDK](https://www.azul.com/downloads/?package=jdk): [GNU GPLv2 License](https://openjdk.java.net/legal/gplv2+ce.html).

- [LWJGL3](https://github.com/PojavLauncherTeam/lwjgl3): [BSD-3 License](https://github.com/LWJGL/lwjgl3/blob/master/LICENSE.md).

- [LWJGLX](https://github.com/PojavLauncherTeam/lwjglx) (LWJGL2 API compatibility layer for LWJGL3): unknown license.

- [DBNumberedSlider](https://github.com/khanhduytran0/DBNumberedSlider): [Apache 2.0 License](https://github.com/immago/DBNumberedSlider/blob/master/LICENSE)

- [fishhook](https://github.com/khanhduytran0/fishhook): [BSD-3 License](https://github.com/facebook/fishhook/blob/main/LICENSE).

- [shaderc](https://github.com/khanhduytran0/shaderc) (used by Vulkan rendering mods): [Apache 2.0 License](https://github.com/google/shaderc/blob/main/LICENSE).

- [NRFileManager](https://github.com/mozilla-mobile/firefox-ios/tree/b2f89ac40835c5988a1a3eb642982544e00f0f90/ThirdParty/NRFileManager): [MPL-2.0 License](https://www.mozilla.org/en-US/MPL/2.0)

- [AltKit](https://github.com/rileytestut/AltKit)

- [UnzipKit](https://github.com/abbeycode/UnzipKit): [BSD-2 License](https://github.com/abbeycode/UnzipKit/blob/master/LICENSE).

- [DyldDeNeuralyzer](https://github.com/xpn/DyldDeNeuralyzer): bypasses Library Validation for loading external runtime

- Thanks to [MCHeads](https://mc-heads.net) 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.

![](https://user-images.githubusercontent.com/55281754/183129754-c3736bb9-d528-4af7-9351-a12b3be7549e.png)