Angel Aura Amethyst (iOS)

Introduction

Amethyst is a Minecraft: Java Edition launcher for Android, iOS, and iPadOS, based off of zhuowei's 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 Amethyst. Looking for Android?

Getting started with Amethyst

The Amethyst wiki 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.

• 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

Amethyst 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 Amethyst 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 Amethyst 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 Amethyst

Release build (TrollStore)

1. Download an IPA of Amethyst 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 Amethyst 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.

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

Contributors

Amethyst 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:

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

Third party components and their licenses

• Caciocavallo: GNU GPLv2 License.
• jsr305: 3-Clause BSD 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.
• openal-soft: LGPLv2 License.
• Azul Zulu JDK: GNU GPLv2 License.
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.
• DBNumberedSlider: Apache 2.0 License
• fishhook: BSD-3 License.
• shaderc (used by Vulkan rendering mods): Apache 2.0 License.
• NRFileManager: MPL-2.0 License
• AltKit
• UnzipKit: BSD-2 License.
• DyldDeNeuralyzer: bypasses Library Validation for loading external runtime
• Thanks to MCHeads for providing Minecraft avatars.