Micro Client Launcher Android

From Boardwalk's ashes, PojavLauncher's ruined reputation, and Amethyst's great base, here comes Micro Client Launcher for our PVP Client!

Micro Client Launcher Android is the phone launcher of MicroClient that allows you to play Micro Client on your Android device.

Table of Contents

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

Introduction

• Micro Client Launcher Android is a Micro Client launcher for Android based on Boardwalk, PojavLauncher and Amethyst-Android.
• This launcher can launch only Micro Client 1.8.8.
• This repository contains source code for Android.

Getting Micro Client Launcher

You can get Micro Client Launcher via two methods:

1. Releases: Download the latest prebuilt app from our website.
2. Build from Source: Follow the building instructions below.

Building

Quick Build (Recommended)

The easiest way to build Micro Client Launcher Android is to use the pre-built JREs provided by our CI.

1. Clone the repository: git clone --recursive https://github.com/MicroClientPVP/MicroClient-Launcher-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/.

Detailed Build

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

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

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

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

4. Build the launcher: ./gradlew :app_pojavlauncher:assembleDebug (Replace gradlew with gradlew.bat on 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
• OpenGL in OpenJDK environment
• OpenAL (works on most devices)
• 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.

Contributing

Please 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

Micro Client Launcher Android is licensed under GNU LGPLv3.

Credits & Dependencies

• Amethyst: GNU LGPLv3.
• 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.
• Krypton Wrapper: MIT 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.

Roadmap

We are currently focusing on:

• Staying up to date with Amethyst-Android for more bug fixes and features.
• Optimizing performance and stability for Micro Client's Mobile version.

We welcome community feedback and suggestions for our roadmap. Please feel free to open a feature request in our issue tracker.