Amethyst iOS Remastered
A premium Minecraft: Java Edition launcher for iOS and iPadOS, rebuilt from the ground up on the official Amethyst project. It delivers a refined mobile experience with comprehensive mod management, intelligent renderer selection, and deep platform integration.
- Modern UI Redesign -- The interface has been deeply refined for a contemporary, polished visual style.
- Resource Management & Downloads -- Browse, enable, disable, and delete mods, shader packs, resource packs, and other assets, with integrated Modrinth and CurseForge download support.
- Modpack Import -- Import ZIP-format modpacks directly from the launcher interface.
- Smart Download Sources -- Switch between Mojang Official, BMCLAPI mirror, and other sources on the fly for optimal download speeds.
- Complete Chinese Localization -- Fully translated interface with native-quality Chinese language support.
- Unrestricted Accounts -- Local accounts, demo mode, and third-party authentication all supported; no Microsoft account required to download and play.
- Multi-Account -- Seamlessly switch between Microsoft, local, and third-party authentication accounts.
- Auto Renderer Selection -- Automatically chooses the optimal rendering backend (including MobileGlues, MoltenVK, and more) when set to Auto.
- Auto JVM Selection -- Automatically selects the correct JVM version (Java 8, 17, 21, or 25) based on the game version.
- Minecraft 26.X Support -- Experimental support for Minecraft 26.x.
- Custom Mouse Pointer -- Customize the virtual mouse pointer skin in settings.
- Custom News URL -- Configure a custom news feed URL for the launcher home screen.
- TouchController Support -- Communicates with the TouchController mod via both UDP local proxy and XCFramework, delivering full touchscreen control on iOS.
- AI Integration -- (In development) The goal is to enable AI to fully manage the launcher, including resource downloads and instance management.
- Custom App Icons -- (In development)
... and much more to explore!
Note
There are no plans to port this remastered version to Android. The Android ecosystem already has excellent launchers such as Zalith Launcher, Fold Craft Launcher, and ShardLauncher. For the official Android version, visit Amethyst-Android.
For complete documentation, refer to the Amethyst Official Wiki or the Bilibili tutorial. Below is a condensed guide.
| Tier | iOS Version | Supported Devices |
|---|---|---|
| Minimum | iOS 14.0+ | iPhone 6s+, iPad 5th gen+, iPad Air 2+, iPad mini 4+, all iPad Pro, iPod touch 7th gen |
| Recommended | iOS 14.5+ | iPhone XS+ (excl. XR/SE 2nd gen), iPad 10th gen+, iPad Air 4th gen+, iPad mini 6th gen+, iPad Pro (excl. 9.7-inch) |
Caution
iOS 14.0--14.4.2 has known critical compatibility issues. Upgrading to iOS 14.5 or later is strongly recommended. iOS 17.x and 18.x are supported but require a companion computer for initial JIT configuration (see the Official JIT Guide). iOS 26.x is installable but has not undergone dedicated adaptation; expect unpredictable behavior.
Prioritize tools that support permanent signing and automatic JIT enablement:
- TrollStore (Recommended) -- Permanent signing, automatic JIT, increased memory limits. Compatible with select iOS versions. Download from official repo
- AltStore / SideStore (Alternative) -- Requires periodic re-signing; initial setup needs a computer and Wi-Fi. Only compatible with development certificates (must include
com.apple.security.get-task-allowentitlement for JIT). Distribution certificate signing services are not supported.
Warning
Only download sideloading tools and IPA files from official or trusted sources. The author is not responsible for device issues caused by unofficial software. Jailbroken devices support permanent signing, but daily-driver jailbreaking is not recommended.
Official Release (TrollStore)
- Download the
.tipapackage from Releases. - Open the file with TrollStore via the system share menu to complete installation.
Official Release (AltStore / SideStore)
- Download the
.ipapackage from Releases. - Import the IPA into your sideloading tool following its standard installation procedure.
Nightly Builds (Development Testing)
[!CAUTION] Nightly builds may contain critical bugs including crashes and startup failures. Use only for development and testing purposes.
- Navigate to the GitHub Actions page and download the latest IPA artifact.
- Import the IPA into your sideloading tool (AltStore, SideStore, etc.) to install.
JIT (Just-In-Time compilation) is essential for smooth gameplay. Choose the approach that matches your environment:
| Tool | External Device | Wi-Fi Required | Auto-Enable | Notes |
|---|---|---|---|---|
| TrollStore | No | No | Yes | Preferred; no additional action needed |
| AltStore | Yes | Yes | Yes | Requires AltServer running on local network |
| SideStore | First time only | First time only | No | Device/network-free after initial setup |
| StikDebug | First time only | First time only | Yes | Device/network-free after initial setup |
| Jitterbug | Yes (without VPN) | Yes | No | Manual trigger required |
| Jailbroken | No | No | Yes | System-level automatic support |
- @yitenchen123 -- Project Maintainer
- @EternityQwQ -- Add Metal Universal Mod support, allowing the launcher to use Metal for rendering Minecraft
- @LanRhyme -- ShardLauncher author; iOS 26 compatibility and logging improvements
- @WeiErLiTeo -- Mod download integration, TouchController optimizations, and two-finger long-press keyboard trigger
- @Li2548 -- Upstream synchronization
If you would like to contribute translations for this project, please go to Crowdin.
| Component | Purpose | License | Source |
|---|---|---|---|
| Caciocavallo | AWT runtime framework | GPL-2.0 | GitHub |
| jsr305 | Code annotation support | BSD-3 | Google Code |
| Boardwalk | Core functionality adaptation | Apache-2.0 | GitHub |
| GL4ES | OpenGL-to-GLES translation | MIT | GitHub |
| Mesa 3D | 3D graphics library | MIT | GitLab |
| MetalANGLE | Metal-to-OpenGL ES translation | BSD-2 | GitHub |
| MoltenVK | Vulkan-to-Metal translation | Apache-2.0 | GitHub |
| openal-soft | Cross-platform 3D audio | LGPL-2.0 | GitHub |
| Azul Zulu JDK | Java runtime (8/17/21/25) | GPL-2.0 | Website |
| LWJGL3 | Java game development library | BSD-3 | GitHub |
| LWJGLX | LWJGL2 compatibility layer | -- | GitHub |
| DBNumberedSlider | UI slider control | Apache-2.0 | GitHub |
| fishhook | Dynamic library rebinding | BSD-3 | GitHub |
| shaderc | Vulkan shader compilation | Apache-2.0 | GitHub |
| NRFileManager | File management utilities | MPL-2.0 | GitHub |
| AltKit | AltStore integration | -- | GitHub |
| UnzipKit | ZIP archive handling | BSD-2 | GitHub |
| DyldDeNeuralyzer | Library verification bypass | -- | GitHub |
| MobileGlues | Third-party renderer | LGPL-2.1 | GitHub |
| LTW | OpenGL Core-to-ES wrapper | LGPL-3.0 | GitHub |
| authlib-injector | Third-party authentication | AGPL-3.0 | GitHub |
Additional thanks to MCHeads for Minecraft avatar services, Modrinth for mod distribution, and BMCLAPI for Minecraft download mirroring.
If you find this project valuable, consider supporting development through Ko-Fi, Afdian, or WeChat Reward Code.