Atmosphere Launcher

• From Boardwalk's ashes here comes PojavLauncher!

• PojavLauncher is a launcher that allows you to play Minecraft: Java Edition on your Android device!

• It can run almost every version of Minecraft, allowing you to use .jar only installers to install modloaders such as Forge and Fabric, mods like OptiFine and LabyMod, as well as hack clients like Wurst, and much more!

Navigation

• Introduction
• Building
• Current status
• License
• Contributing
• Credits & Third party components and their licenses
• More

Introduction

• PojavLauncher is a Minecraft: Java Edition launcher for Android based on Boardwalk.
• This launcher can launch almost all available Minecraft versions ranging from rd-132211 to 1.21.x snapshots (including Combat Test versions).
• Modding via Forge and Fabric are also supported.
• This repository contains source code for Android.
• Pojav Glow·Worm does not support IOS

Getting Pojav Glow-Worm

You can get PojavLauncher via three methods:

1. You can get the prebuilt app from stable releases or automatic builds.

2. You can build from source.

Building

If you want to build from source code, follow the steps below.

Java Runtime Environment (JRE)

• JRE for Android is here
• Follow build instruction on build script README.md.
• You can also get CI auto builds if you are lazy or are failing to build it for some reason.

• Either get the jre8-pojav artifact from auto builds, or split all artifacts by yourself:
  
  • Get JREs for all of 4 supported architectures (arm, arm64, x86, x86_64)
    
    • Split JRE into parts:
      Platform-independent: .jar files, libraries, configs, etc...
      Platform-dependent: .so files, etc...
      
      • Create:
        A file named universal.tar.xz with all platform-independent files
        4 files named bin-<arch>.tar.xz with all platform-dependent files per-architecture
        
      • Put these in the assets/components/jre/ folder
        
      • (If needed) update the Version file with the current date
        

LWJGL

• The build instructions for the custom LWJGL are available over the LWJGL repository

• This modified version of lwjgl uses the latest content from Vera-Firefly lwjgl3-build repository for automated builds

The Launcher

• Build GLFW stub (If need):

git submodule update --init --recursive

or

chmod +x scripts/UpdateSubmodule.sh
./scripts/UpdateSubmodule.sh

then run:

cd lwjgl3-build
./gradlew :jre_lwjgl3glfw:build

mv lwjgl3/* ../app_pojavlauncher/src/main/assets/components/lwjgl3
cd ../

• Build the launcher

./gradlew :app_pojavlauncher:assembleDebug

(Replace gradlew with gradlew.bat if you are building on Windows) (If you are having trouble with mv permissions, try using sudo mv)

Current status

• branding and other name related stuff (partly done now)
• revamp the ui
• better default renders
• alternative turnip selution for non adrenos
• Better java args by Default
• More to come!

Known Issues

• Controller mods aren't working.
• Random crashes could happen very often on Android 5.x when loading the game or joining a world.
• With big modpacks textures could be messed up
• Probably more, that's why we have a bug tracker

License

• Pojav Glow·Worm is licensed under GNU GPLv3.

Contributing

Contributions are welcome! We welcome any type of contribution, not only code. For example, you can help the wiki shape up. You can help the translation too!

Any code change to this repository should be submitted as a pull request. The description should explain what the code does and give steps to execute it.

Credits & Third party components and their licenses (if available)

• Pojav-Glow-Worm (for creating source base): GNU General Public License v3.0
• Boardwalk (JVM Launcher): Unknown License/Apache License 2.0 or GNU GPLv2.
• Android Support Libraries: Apache License 2.0.
• GL4ES: MIT License.
  
• OpenJDK: GNU GPLv2 License.
  
• LWJGL3: BSD-3 License.
• LWJGLX (LWJGL2 API compatibility layer for LWJGL3): unknown license.
  
• Mesa 3D Graphics Library: MIT License.
• Android-Mesa-Build: GNU GPLv3 License
• TurnipDriver-CI: Unknown License
• AdrenoToolsDrivers: Unknown 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.
• terminal-view: Apache 2.0.
• terminal-emulator: Apache 2.0.
• Thanks to MCHeads for providing Minecraft avatars.

More

• If you want a different experience, try some of the other good ones:ZalithLauncher