README

PojavLauncher









From Boardwalk's ashes here comes PojavLauncher!

PojavLauncher is a launcher that allows you to play Minecraft: Java Edition on your Android and iOS devices.

For more details, check out our wiki!

 Important Notes

PojavLauncher has been discontinued and is no longer supported. Its successor is available here.

 Table of Contents

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

 Introduction

 PojavLauncher is a Minecraft: Java Edition launcher for Android and iOS based on Boardwalk
 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 PojavLauncher_iOS.

 Getting PojavLauncher

You can get PojavLauncher via three methods:

1. Releases: Download the prebuilt app from our stable releases or automatic builds.
2. Google Play: Get it from Google Play by clicking on this badge: 
3. Build from Source: Follow the building instructions below.

 Building

 Quick Build (Recommended)

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

1. Clone the repository: git clone https://github.com/PojavLauncherTeam/PojavLauncher.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. 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:
     bash
     chmod +x scripts/languagelist_updater.sh
     bash scripts/languagelist_updater.sh
     
    Windows:
     batch
     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).

 Current Status

 [x] OpenJDK 8 Mobile port: ARM32, ARM64, x86, x86_64
 [x] OpenJDK 17 Mobile port: ARM32, ARM64, x86, x86_64
 [x] OpenJDK 21 Mobile port: ARM32, ARM64, x86, x86_64
 [x] Headless mod installer
 [x] Mod installer with GUI
 [x] OpenGL in OpenJDK environment
 [x] OpenAL (works on most devices)
 [x] Support for Minecraft 1.12.2 and below
 [x] Support for Minecraft 1.13 and above
 [

Top issues

Latest release

Fixes:
- Fully fixed a bug when 1.21.1+ did not show anything with GL4ES
- Other minor launcher crash fixes
Technical changes:
- Refactored screen size management for better screen dimension changing support
- Improved ReplayMod support (available by installing the FFMpeg plugin)
Additions:
- Added new renderer: LTW
   - Supports incomplete OpenGL 3.2, based on OpenGL ES 3.0 (with optional features from 3.1 and 3.2)
   - Allows you to run Sodium, Iris (note that shader support is limited), Immersive Portals (GL_EXT_clip_cull_distance required), Create and most other mods for new versi