Copper Launcher

Copper is a fork of Amethyst that allows you to play Minecraft: Java Edition on your Android devices.

• Introduction
• Getting Copper
• Building
  • Quick Build (Recommended)
  • Detailed Build
• Current Status
• Known Issues
• FAQ
• Contributing
• Support
• License
• Credits & Dependencies
• Roadmap

• Copper is a Minecraft: Java Edition launcher for Android based on Boardwalk, PojavLauncher and Amethyst Launcher.
• This launcher can launch almost all available Minecraft versions ranging from rd-132211 to 26.x snapshots (including Combat Test versions)
• Modding via Forge and Fabric are also supported.
• This repository contains source code for Android.

You can get Copper via three methods:

1. Nightly Download the latest artifact from Nightly.link
2. Releases: Download the latest prebuilt app from Releases
3. Build from Source: Follow the building instructions below.

The easiest way to build Copper is to use the pre-built JREs provided by our CI.

1. Clone the repository: git clone --recursive https://github.com/CopperLauncher/Copper-Android.git
2. Build the launcher: ./gradlew :app_pojavlauncher:assembleDebug (Use gradlew.bat on Windows)

The built APK will be located in app_pojavlauncher/build/outputs/apk/debug/.

If you need more control over the build process, follow these steps:

1. Java Runtime Environment (JRE): Download the jre8-pojav artifact from AngelAuraMCs 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.

2. LWJGL: The build instructions for the custom LWJGL are available over the LWJGL repository.

3. 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

4. Build GLFW stub: ./gradlew :jre_lwjgl3glfw:build

5. Build the launcher: ./gradlew :app_pojavlauncher:assembleDebug (Replace gradlew with gradlew.bat on Windows).

• New UI
• Bug Fixes
• Fix GL4ES and KW in older versions
• Add Modpack export
• Add mclo.gs
• Add Res pack downloader
• Add Shader pack downloader
• Add Res pack manager
• Add Shader pack manager
• Fix Krypton wrapper in 1.21.6 and up
• Bump Mobile Glues
• Add More Renerers

See Copper's issue tracker for a list of known issues and their current status.

For support, please join our Discord server

Copper is licensed under GNU LGPLv3.

• Boardwalk (JVM Launcher): Unknown License/Apache License 2.0 or GNU GPLv2.
• PojavLauncher: GLGPL
• Amethyst Launcher: LGPL-3.0 license
• MojoLauncher: LGPL-3.0 license
• Android Support Libraries: Apache License 2.0.
• GL4ES: MIT License.
• Krypton Wrapper: 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.
• bhook (Used for exit code trapping): MIT license.
• libepoxy: MIT License.
• virglrenderer: MIT License.
• OpenAL-Soft: GNU GPLv2
  • oboe: Apache License 2.0.
  • pfffft: ARR
• SDL3: zlib License
• sdl2-compat: zlib License
• Thanks to MCHeads for providing Minecraft avatars.
• Thanks to Modrinth, CurseForge and McLo.gs for providing us the free API's.

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.