cca5cc63de
We want to be able to grey out files that are not .zip or .mrpack so people can have an easier chance of seeing their modpacks. To do this, we match the `application/x-modrinth-modpack+zip` and `application/zip` mimetypes as prescribed in the Modrinth documentation https://support.modrinth.com/en/articles/8802351-modrinth-modpack-format-mrpack. Stock android does not have `application/x-modrinth-modpack+zip`. OEM vendors seem to include this in their ROMs, possibly from just using https://gitlab.freedesktop.org/xdg/shared-mime-info as part of where they source their additional mimetypes from. There's a tendency for Android 12 and below to not have the `application/x-modrinth-modpack+zip` mimetype, likely due to the addition of it being relatively recent, so we have to account for that by also adding `application/octet-stream`. We cannot only have `application/octet-stream` or else it fails to match .mrpack in systems that have `application/x-modrinth-modpack+zip`. Sadly there seems to be no reliable way to check whether or the the ROM has the `application/x-modrinth-modpack+zip` mimetype so we just match it along with `application/octet-stream` to cover our bases.
Angel Aura Amethyst
From Boardwalk's ashes and PojavLauncher's ruined reputation, here comes Amethyst!
Amethyst is a launcher that allows you to play Minecraft: Java Edition on your Android and iOS devices.
For more details, check out our wiki!
Table of Contents
- Introduction
- Getting Amethyst
- Building
- Current Status
- Known Issues
- FAQ
- Contributing
- Support
- License
- Credits & Dependencies
- Roadmap
Introduction
- Amethyst is a Minecraft: Java Edition launcher for Android and iOS based on Boardwalk and PojavLauncher
- This launcher can launch almost all available Minecraft versions ranging from rd-132211 to 1.21 snapshots (including Combat Test versions)
- Modding via Forge and Fabric are also supported.
- This repository contains source code for Android. For iOS/iPadOS, check out Amethyst-iOS.
Getting Amethyst
You can get Amethyst via two methods:
- Releases: Download the latest prebuilt app from nightly.link or select an older version from our automatic builds.
- Build from Source: Follow the building instructions below.
Building
Quick Build (Recommended)
The easiest way to build Amethyst is to use the pre-built JREs provided by our CI.
- Clone the repository:
git clone --recursive https://github.com/AngelAuraMC/Amethyst-Android.git - Build the launcher:
./gradlew :app_pojavlauncher:assembleDebug(Usegradlew.baton Windows)
The built APK will be located in app_pojavlauncher/build/outputs/apk/debug/.
Detailed Build
If you need more control over the build process, follow these steps:
-
Java Runtime Environment (JRE): Download the
jre8-pojavartifact from our CI auto builds. This package contains pre-built JREs for all supported architectures. If you need to build the JRE yourself, follow the instructions in the android-openjdk-build-multiarch repository. -
LWJGL: The build instructions for the custom LWJGL are available over the LWJGL repository.
-
Language List: Because languages are auto-added by Crowdin, you need to run the language list generator before building. In the project directory, run:
- Linux/macOS:
chmod +x scripts/languagelist_updater.sh bash scripts/languagelist_updater.sh - Windows:
scripts\languagelist_updater.bat
- Linux/macOS:
-
Build GLFW stub:
./gradlew :jre_lwjgl3glfw:build -
Build the launcher:
./gradlew :app_pojavlauncher:assembleDebug(Replacegradlewwithgradlew.baton Windows).
Current Status
- OpenJDK 8 Mobile port: ARM32, ARM64, x86, x86_64
- OpenJDK 17 Mobile port: ARM32, ARM64, x86, x86_64
- OpenJDK 21 Mobile port: ARM32, ARM64, x86, x86_64
- Headless mod installer
- Mod installer with GUI
- OpenGL in OpenJDK environment
- OpenAL (works on most devices)
- Support for Minecraft 1.12.2 and below
- Support for Minecraft 1.13 and above
- Support for Minecraft 1.17 (22w13a) and above
- Game surface zooming
- New input pipe rewritten to native code
- Rewritten entire controls system
- More to come!
Known Issues
See our issue tracker for a list of known issues and their current status.
FAQ
See our wiki for more information.
Contributing
Contributions are welcome! We welcome any type of contribution, not only code. For example, you can help improve the wiki, contribute to the translations, or submit bug reports and feature requests.
Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it.
Support
For support, please join our Discord server.
License
Amethyst is licensed under GNU LGPLv3.
Credits & Dependencies
- Boardwalk (JVM Launcher): Unknown License/Apache License 2.0 or GNU GPLv2.
- PojavLauncher: GLGPL
- Android Support Libraries: Apache License 2.0.
- GL4ES: MIT License.
- MobileGlues: LGPL-2.1 License.
- ANGLE: All Rights Reserved.
- OpenJDK: GNU GPLv2 License.
- LWJGL3: BSD-3 License.
- LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.
- Mesa 3D Graphics Library: MIT License.
- pro-grade (Java sandboxing security manager): Apache License 2.0.
- bhook (Used for exit code trapping): MIT license.
- libepoxy: MIT License.
- virglrenderer: MIT License.
- OpenAL-Soft: GNU GPLv2
- SDL3: zlib License
- sdl2-compat: zlib License
- Thanks to MCHeads for providing Minecraft avatars.
Roadmap
We are currently focusing on:
- Exploring new rendering technologies.
Future plans include:
- Improving stability and performance.
- Enhancing the mod installation experience.
We welcome community feedback and suggestions for our roadmap. Please feel free to open a feature request in our issue tracker.