Skip to content

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

License

Notifications You must be signed in to change notification settings

sinkclose/Coral-iOS

 
 

Repository files navigation

Coral (iOS)

Introduction

Coral is a Minecraft: Java Edition launcher for iOS, based off of zhuowei's Boardwalk and Angel Aura's Amethyst 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.
  • Ely.by account and skin system, Microsoft account support, Demo mode without restrictions.
  • ...and much more!

Important: Please support the developers of Minecraft by purchasing the game if possible.

Looking for Android? There is no Android fork available yet, but it will be available soon.

Also check out Amethyst and Amethyst-Android for more stable experience!

Getting started with Coral

Download Coral from releases and install it using any method of sideloading.

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.

  • iOS 17.x and iOS 18.x is supported. However, a computer is required. For more information, please check out the official wiki

Setting up to sideload

Coral can be sideloaded in many ways. Our recommended solution is to install TrollStore if your iOS version supports it. Installing with TrollStore allows you to permanently sign the application, automatically enable JIT, and increase memory limits.

If you cannot, AltStore and SideStore are your next best options.

  • Signing services that do not use your UDID (and use distribution certificates) are not supported, as Coral requires capabilities they do not allow. However, if you do managed to gain access to a Development certificate, due to it having the necessary entitlement (being com.apple.security.get-task-allow) to attach a debugger to the running process (enabling JIT), you may use a Development certificate.

  • Only install sideloading software and Coral 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 on devices intended for regular use.

Installing Coral

Release build (TrollStore)

  1. Download an IPA of Coral in Releases.
  2. Open the package in TrollStore using the share menu.

Release build (AltStore/SideStore trusted source)

These builds will be available soon, stay tuned.

Nightly builds

These builds can contain game-breaking bugs. Use with caution.

  1. Download an IPA build of Coral in the Actions tab.
  2. Open the downloaded IPA in your sideloading app to install.

Nightly builds (AltStore/SideStore trusted sources)

These builds will be available soon, stay tuned.

Enabling JIT

Amethyst 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 StikDebug TrollStore Jitterbug Jailbroken
Requires ext-device Yes Yes (#) Yes (#) No If VPN unavailable No
Requires Wi-Fi Yes Yes (#) Yes (#) No Yes No
Auto enabled Yes (*) No Yes Yes No Yes

(*) AltServer running on the local network is required. (#) Only the first time.

Contributors

@crystall1nedev - Project manager, iOS port developer
@khanhduytran0 - iOS port developer
@artdeell
@Mathius-Boulay
@zhuowei
@jkcoxson
@Diatrus

Third party components and their licenses

About

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

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Objective-C 69.4%
  • Java 19.0%
  • C++ 5.1%
  • C 3.1%
  • Makefile 1.8%
  • JavaScript 1.0%
  • CMake 0.6%