PojavLauncher (a.k.a. Pojav Reborn)

Readme на русском

Readme বাংলা ভাষায়

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

This is not the original PojavLauncher. This project is based on MojoLauncher. For more details, please see DISCLAIMER.md.

Table of Contents

• Introduction
• Getting PojavLauncher
• Building
  • Quick Build (Recommended)
  • Detailed Build
• Current Status
• Known Issues
• FAQ
• Contributing
• Support
• License
• Credits & Dependencies
  • Core Components
  • Framework & Library Support
  • Graphics & Rendering
  • Java & Game Libraries
  • Security & System
  • Audio
  • Other Services
• 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 26.x 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 five methods:

1. Releases: Download the latest release.apk from our stable releases.
2. Google Play (Deprecated): Get it from Google Play by clicking on this badge:
3. Nightly.link: Get the latest pre-built app from nightly.link
4. Automated builds: Download the latest debug.apk from automatic builds.
5. 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/TeamPojavLauncher/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:

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

Current Roadmap

• 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
• Added MobileGlues Renderer
• Added NG_GL4ES (Krypton Wrapper) Renderer as GL4ES backend
• Added Freedreno for Adreno devices
• Instance system in favor of profiles
• Out-of-the-box 1.21.5 support
• mrpack/CurseForge zip import
• LTW: resolve issues with Create
• LTW: enable compute shader/image extensions
• LTW: switch to a color-renderable format for framebuffers
• Add MobileGL for Mali devices
• Modpack/mod management tool
• MMC-compatible instance import
• Implement common native library standard
• Patch-on-dlopen for mod native libraries
• 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. (Currently an outdated wiki.)

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

PojavLauncher is licensed under GNU LGPLv3.

Credits & Third Party Components and Their Licenses

Core Components

• PojavLauncher: GNU LGPLv3 License
• Boardwalk (JVM Launcher): Unknown License / Apache License 2.0 or GNU GPLv2
• MojoLauncher: GNU LGPLv3 License

Framework & Library Support

• Android Support Libraries: Apache License 2.0
• OpenJDK: GNU GPLv2 License

Graphics & Rendering

• GL4ES: MIT License
• Holy GL4ES: MIT License
• MobileGlues: LGPL-2.1 License
• Krypton Wrapper: MIT License
• Mesa 3D Graphics Library: MIT License

Java & Game Libraries

• LWJGL3: BSD-3 License
• GLFW: zlib license
• LWJGL2-GLFW: 3-Clause BSD license

Security & System

• pro-grade (Java sandboxing security manager): Apache License 2.0
• bhook (Exit code trapping): MIT License
• Authlib-Injector (Authorization via ely.by): AGPL-3.0

Audio

• OpenAL-Soft: GNU LIBRARY GENERAL PUBLIC LICENSE and modified PFFFT
• oboe: Apache License 2.0

Other Services

• Thanks to Mineskin and 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.