Install Minecraft Java GDLauncher on Raspberry Pi

Minecraft Java GDLauncher

GDLauncher is simple, yet powerful Minecraft launcher with a strong focus on the user experience. This is a CUSTOM BUILD of GDLauncher for ARM32/ARM64 support.

Features of the launcher:

  • Microsoft, Mojang, and PC GamePass Account support
  • Curseforge and FTB Mod and Modpack browser and updater
  • Automatic Java 8/17 installation
  • Fabric and Forge mod loading

Features NOT in this launcher (but available in others):

  • Modrinth ATLauncher and Technic Mod and Modpack browser and updater
  • Quilt mod loading
  • Old Snapshots

NOTE: The use of performance enhancing mods is highly encouraged, such as optifine with Optifabric and Fabric/Forge or Sodium/Lithium/Starlight Fabric Mods.

To run: Menu -> Games -> GDLauncher
To run in a terminal: MESA_GL_VERSION_OVERRIDE=3.3 gdlauncher

theofficialgman's custom meta repo is used for arm32 and arm64 native libraries. (
This supports all currently released versions of minecraft.

Note: GDLauncher GitHub/Discord does NOT support this CUSTOM BUILD, any issues should be directed to the Pi-Apps Discord or Pi-Apps GitHub issues.

Fortunately, Minecraft Java GDLauncher is very easy to install on your Raspberry Pi in just two steps.

  1. Install Pi-Apps - the best app installer for Raspberry Pi.
  2. Use Pi-Apps to install Minecraft Java GDLauncher.


For the best chance of this working, we recommend using the latest version of Raspberry Pi OS, which is currently version Bookworm.
Raspberry Pi OS has 32-bit and 64-bit variants, both of which will run on most Raspberry Pi computers, including the Pi 3, Pi 4, and Pi5.
Minecraft Java GDLauncher will run on either PiOS 32-bit or 64-bit.

Install Pi-Apps

Pi-Apps is a free tool that makes it incredibly easy to install the most useful programs on your Raspberry Pi with just a few clicks.

Open a terminal and run this command to install Pi-Apps:

wget -qO- | bash

Feel free to check out the Pi-Apps source code here:

Install Minecraft Java GDLauncher

Now that you have Pi-Apps installed, it is time to install Minecraft Java GDLauncher.
First launch Pi-Apps from your start menu:

Then click on the Games category.

Now scroll down to find Minecraft Java GDLauncher in the list.

Just click Install and Pi-Apps will install Minecraft Java GDLauncher for you!

Pi-Apps is a free and open source tool made by Botspot and other contributors. Find out more at