English | 中文
Optimized and adapted based on the official Amethyst, focusing on iOS/iPadOS experience enhancement, core features include:
- Mod Management: Recreated Mod management functionality from other launchers, supporting viewing basic Mod information, one-click disabling/deleting Mods
- Modpack Import: Supports importing ZIP format modpacks
- Custom Mouse Pointer: Support for customizing virtual mouse pointer skins in settings
- Smart Download Source Switching: Automatically identifies network environment and optimally selects between Mojang official source and BMCLAPI for more stable downloads
- Complete Chinese Localization: Fully translated interface, more suitable for Chinese users awa
- Account Restrictions Removed: Supports local accounts, demo accounts (Demo Mode) and third-party accounts to directly download games without logging into Microsoft account or Test account
- Multi-Account Login: Compatible with Microsoft accounts, local accounts, and third-party authentication accounts
- Custom News URL: Can freely change the news page URL
- Auto-select Renderer: When renderer is set to Auto, it will automatically select the appropriate renderer, including MobileGlues
- Auto-select JVM: Automatically selects JVM version based on game version, including Java21
- TouchController Support: Communicates with TouchController Mod via UDP local proxy, providing touchscreen control support for iOS users
- Custom Icons: (In development, coming soon)
⚠️ Note: There are no plans to reset the Android version (there are too many excellent Android launchers, such as ZL, FCL), if you need the official Android code, please go to Amethyst-Android.
For complete installation and setup documentation, please refer to Amethyst Official Wiki, or check my Bilibili tutorial video. The following are simplified steps:
| Type | System Version Requirements | Supported Device List |
|---|---|---|
| Minimum | iOS 14.0 and above | iPhone 6s+/iPad 5th gen+/iPad Air 2+/iPad mini 4+/All iPad Pro/iPod touch 7th gen |
| Recommended | iOS 14.5 and above (better experience) | iPhone XS+ (excluding XR/SE 2nd gen), iPad 10th gen+/Air 4th gen+/mini 6th gen+/iPad Pro (excluding 9.7 inch) |
⚠️ Key Reminder: Serious compatibility issues exist with iOS 14.0~14.4.2, strongly recommended to upgrade to iOS 14.5+; Supports iOS 17.x/iOS 18.x, but requires computer assistance for configuration, see Official JIT Guide for details; Supports iOS 26.x (called iOS 19.x in source code), but no special adaptation has been made, unpredictable issues may occur.
Prioritize tools that support "permanent signing + automatic JIT", recommended by priority:
- TrollStore (Preferred): Supports permanent signing, automatic JIT enablement, and memory limit increase, compatible with some iOS versions, download from Official Repository
- AltStore/SideStore (Alternative): Requires periodic re-signing, initial setup requires computer/Wi-Fi; does not support "distribution certificate signing service", only compatible with "development certificate" (must include
com.apple.security.get-task-allowpermission to enable JIT)
⚠️ Security Tip: Only download sideloading tools and IPA from official/trusted sources; I am not responsible for device issues caused by unofficial software; Jailbroken devices support permanent signing, but daily jailbreaking is not recommended.
- Go to Releases to download the TIPA installation package
- Through the system "share menu", choose to open with TrollStore to automatically complete installation
- Go to Releases to download the IPA installation package
- (Normal installation steps)
🔴 Risk Warning: Test versions may contain serious bugs such as crashes and failure to start, only for development testing!
- Go to GitHub Actions page to download the latest IPA test package
- Import IPA in sideloading tools (AltStore/SideStore, etc.) to complete installation
JIT (Just-In-Time) is crucial for smooth game operation. iOS needs to enable it through the following tools, choose according to your environment:
| Tool | Requires External Device | Requires Wi-Fi | Auto Enable | Notes |
|---|---|---|---|---|
| TrollStore | ❌ | ❌ | ✅ | Preferred, no additional action needed |
| AltStore | ✅ | ✅ | ✅ | Requires local network to run AltServer |
| SideStore | ✅ (First time) | ✅ (First time) | ❌ | Subsequent use requires no device/network |
| StikDebug | ✅ (First time) | ✅ (First time) | ✅ | Subsequent use requires no device/network |
| Jitterbug | ✅ (When VPN unavailable) | ✅ | ❌ | Requires manual trigger |
| Jailbroken Device | ❌ | ❌ | ✅ | System-level automatic support |
- @LanRhyme - ShardLauncher author, modified News code to allow iOS 26 users to use the launcher
- @WeiErLiTeo - Added Mod download functionality to the launcher
| Component Name | Purpose | License Type | Project Link |
|---|---|---|---|
| Caciocavallo | Basic runtime framework | GNU GPLv2 | GitHub |
| jsr305 | Code annotation support | BSD 3-Clause | Google Code |
| Boardwalk | Core functionality adaptation | Apache 2.0 | GitHub |
| GL4ES | Graphics rendering adaptation | MIT | GitHub |
| Mesa 3D Graphics Library | 3D graphics rendering core | MIT | GitLab |
| MetalANGLE | Metal graphics interface adaptation | BSD 2.0 | GitHub |
| MoltenVK | Vulkan interface translation | Apache 2.0 | GitHub |
| openal-soft | Audio processing | LGPLv2 | GitHub |
| Azul Zulu JDK | Java runtime environment | GNU GPLv2 | Official Website |
| LWJGL3 | Java game interface | BSD-3 | GitHub |
| LWJGLX | LWJGL2 compatibility layer | License Unknown | GitHub |
| DBNumberedSlider | UI sliding control | Apache 2.0 | GitHub |
| fishhook | Dynamic library adaptation | BSD-3 | GitHub |
| shaderc | Vulkan shader compilation | Apache 2.0 | GitHub |
| NRFileManager | File management utility class | MPL-2.0 | GitHub |
| AltKit | AltStore adaptation support | - | GitHub |
| UnzipKit | Unzipping tool | BSD-2 | GitHub |
| DyldDeNeuralyzer | Library verification bypass tool | - | GitHub |
| MobileGlues | Third-party renderer | LGPL-2.1 | GitHub |
| authlib-injector | Third-party authentication support | AGPL-3.0 | GitHub |
Additional thanks:
MCHeads for providing Minecraft avatar services;
Modrinth for providing Mod download services;
BMCLAPI for providing Minecraft download services.
If you find this project helpful, you are welcome to support me through the following QR code:
