Troubleshooting

Extracting APKs

I downloaded a Minecraft APK from the internet and it doesnt work!

APKs acquired from anything other than the Google Play store is unsupported by us. It might be possible, but we will not help you.

I copied the Minecraft APK from my phone over to my computer, but it doesnt extract

Your APK is made for the ARM architecture. You need an x86 (32-bit) or x86_64 (64-bit) APK to play on your computer. If you have an ARM laptop (most chromebooks, pinebook) it should work.

Can somebody give me the APK / extracted files?

NO. That is Piracy and we DO NOT support it on this project. Anyone caught asking this in the support server will face consequences.

Appimage

Appimage crashes when I try to sign in to Google

The current workaround is to use LD_PRELOAD for nss3, eg. LD_PRELOAD=/usr/lib/libnss3.so ./Minecraft_Bedrock_Launcher.AppImage Make sure you the libnss3 package installed.

Controller

The player’s view drifts by itself when a controller is plugged in

This happens when the controller’s Deadzones are not set properly for the game. You must manually set the deadzones for your controller.

Game launcher

Graphics performance issues (software rendering) - EGLUT: failed to initialize EGL display...

If the game is running poorly, it might be using software rendering (identified by the llvmpipe string in the renderer). If you have been redirected here by a link in the launcher this is the case.

You should make sure to install the proper 32-bit graphic drivers for your hardware.

  • For integrated graphics and most AMD GPUs (and maybe Nvidia on nouveau) - sudo apt-get install libegl1-mesa:i386 libegl1-mesa-drivers:i386
  • For some Nvidia cards (eg. GeForce series), assuming proprietary driver is already installed, install the associated libnvidia-gl-xxx package (where xxx = driver version for your hardware). For example, if the nvidia-driver-390 metapackage is installed, then sudo apt-get install libnvidia-gl-390.

You may need to reinstall the proprietary drivers if you had installed them manually before.

MSA daemon could not be found

Make sure you have properly installed the following packages: msa-daemon msa-ui-qt If compiling from sources, make sure to install the MSA component.

No audio / Music

❗Please note that the in-game Music is downloaded separately as a free item in the Marketplace.❗

  • Ubuntu: Make sure libasound2:i386 is installed. If it is, you may need to install libpulse0:i386.
  • Arch: Make sure lib32-libpulse and lib32-alsa-plugins are installed on your system.
  • Other distros: Make sure to install alsa (asound) and/or pulseaudio depending on your system configuration.

Updating the launcher

to update the launcher on newer versions of the launcher Press the gear icon and then check for updates

if your launcher is too old or you cant find these buttons in Ubuntu prebuilt packages do sudo apt-get update && sudo apt-get upgrade

and on Mac OS - Redownload the package

MacOS X Catalina

Currently, macOS Catalina does not support 32-bit applications at this time, so you will need to use the NG version of the launcher https://github.com/ChristopherHX/osx-packaging-scripts/releases/tag/ng.dmg which is not fully supported and may be behind on certain updates

Alternatively, you can:

  • Downgrade to Mojave
  • Find a suitable Linux Distro (anything Ubuntu-based will be the easiest)

macOS X Mojave - This browser or app may not be secure. Try using a different browser

Try using [@ChristopherHX’s fork](https://github.com/ChristopherHX/mcpelauncher-manifest/releases) which uses a different workaround for 1.13+ support than the standard launcher. For support, contact @ChristopherHX on the [Discord chat room](https://discord.gg/TaUNBXr).

File picking doesn’t work or crashes

You need to install the zenity utility:

  • Ubuntu - sudo apt-get install zenity

I compiled and/or installed everything, but Minecraft doesn’t start

Chances are, you don’t have the actual game yet. This project does not provide MCPE/Minecraft Bedrock Edition itself.

The easiest way to download and start the game is through the graphical Qt UI (mcpelauncher-ui-qt, sometimes called metalauncher). This requires to log into a Google Play Account with Minecraft purchased.

Otherwise, obtain a valid Minecraft x86 .apk file and use the extract utility.

I Used the Qt UI (metalauncher) to download the game, but mcpelauncher-client still doesn’t work

To start a given version of Minecraft you can run mcpelauncher-client with the -dg argument, eg. mcpelauncher-client -dg ~/.local/share/mcpelauncher/versions/DESIRED_VERSION.

ls ~/.local/share/mcpelauncher/versions/ will list all versions you have installed.

I run into lagspikes during gameplay

This can be fixed by starting the game manually via the command line. To do this, open a terminal and run the following:

Linux:

  • mcpelauncher-client -dg ~/.local/share/mcpelauncher/versions/1.2.3.4 - Replace 1.2.3.4 with the version of Minecraft you want to run.

Mac OS X:

  • cd /Applications/Minecraft\ Bedrock\ Launcher.app/Contents/MacOS
  • ./mcpelauncher-client -dg ~/Library/Application\ Support/mcpelauncher/versions/1.2.3.4 - Replace 1.2.3.4 with the version of Minecraft you want to run.

Qt launcher UI

Running the troubleshooter

Click the gear icon (settings) in the top right corner of the Qt launcher window, and press the [Run troubleshooter] button.

Could not find the game launcher

This may happen when the game launcher has not been installed or set properly. The launcher (mcpelauncher-client) must be available in the PATH variable for the launcher to work. If you are compiling from sources and do not want to install the launcher, please set the GAME_LAUNCHER_PATH at compile time with cmake (eg. cmake -DGAME_LAUNCHER_PATH-/home/paul/mcpelauncher/build/mcpelauncher-client .., make sure that this is the path to the directory containing the binary, and not the binary itself). Otherwise make sure the launcher is properly installed in your system.

The launcher crashes when I press Download and Play

First of all, make sure a version name is displayed under the Download and Play button. If it’s not, please wait some time and/or try restarting the launcher. A window asking you to accept Google Play TOS should appear first.

If the launcher still fails to download, it’s possible you are trying to download a beta version of the game. Make sure to register in the beta first at https://play.google.com/apps/testing/com.mojang.minecraftpe.

You must have purchased Minecraft on the account you’re trying to use.

In some cases, you may need to clear the launcher data.

Clearing the launcher UI data

Run the following commands:

rm -rf ~/.config/Minecraft\ Linux\ Launcher
rm -rf ~/.local/share/Minecraft\ Linux\ Launcher
rm -rf ~/.cache/Minecraft\ Linux\ Launcher

Obtaining the game log

In order to be able to view the game log, in the launcher press the gear in the top right corner and check the “Show log when starting the game” option. This will show a log and update it in realtime. You can copy it by pressing the icon in the top-right corner of the log window. Additionally, the log will be shown if the game crashes.