Minecraft Bedrock Launcher Documentation MrARM & contributors Jul 27, 2021 Contents: 1 Getting started 1 1.1 AppImage................................................1 1.2 Flatpak..................................................1 1.3 macOS..................................................2 1.4 Source build...............................................2 1.5 Getting help...............................................2 2 Frequently Asked Questions 3 2.1 Do I need to own Minecraft: Pocket Edition to play?..........................3 2.2 Does it work on Windows 7 / 8?.....................................3 2.3 How does it work?............................................4 2.4 Where are my worlds?..........................................4 2.5 Can I use resource packs?........................................4 2.6 Why would I want to use this projects server, instead of the official one?................4 3 Troubleshooting 5 3.1 Extracting APKs.............................................6 3.2 AppImage................................................6 3.3 Controller.................................................6 3.4 Game launcher..............................................7 3.5 Qt launcher UI..............................................9 4 Building from sources 11 4.1 Introduction (read first).......................................... 11 4.2 Compiling MSA (for Xbox Live).................................... 12 4.3 Compiling the game launcher...................................... 13 4.4 Compiling the Qt UI........................................... 14 4.5 Compiling the server launcher (Outdated as of 2021-07-27)...................... 15 5 Extract utility 17 5.1 Usage................................................... 17 5.2 Build instructions............................................. 17 6 Dedicated server 19 6.1 Server Properties............................................. 19 7 About 21 i ii CHAPTER 1 Getting started This launcher has been rewritten in 2020 to use mainly a fake Java Native Interface to communicate with Minecraft: Bedrock Edition. Additionally shortly after the release of the first 64bit versions on the Google Play Store, this previously 32bit only Launcher has been ported to arm64 and x86_64. 1.1 AppImage Prebuilt AppImage binary’s for linux x86_64, x86, armv7 hardfloat and armv8 are currently available here. Af- ter downloading simply open terminal, chmod +x Minecraft_Bedrock_Launcher-x86_64.0.0.661. AppImage and run it. With some Filemanagers you should be able to run it with double click, similar to running a *.exe file on Windows. Otherwise run it from a Terminal ./Minecraft_Bedrock_Launcher-x86_64.0. 0.661.AppImage If it’s your first time you have installed an AppImage and you want an Icon in your startmenu • install AppImageLauncher • run the AppImage like before • AppImageLauncher will ask you to integrate it, press yes • You can now start and update the Launcher directly from your startmenu 1.2 Flatpak You can also install mcpelauncher on Linux via Flathub. To install it, first setup Flatpak then run sudo flatpak install flathub io.mrarm.mcpelauncher If it’s your first time you have installed a Flatpak please logout from your Computer and sign back in to be able to find the Launcher inside your startmenu. To run it, run 1 Minecraft Bedrock Launcher Documentation flatpak run io.mrarm.mcpelauncher 1.3 macOS Prebuilt macOS binary’s are currently available here. Always copy the App to a writeable location otherwise the updater won’t work. If you want to compile from sources on macOS go here (Outdated as of 2021-07-27). 1.4 Source build If there are no packages available for your distribution, check out the Source build guide. You can also use the Linux build script (Outdated as of 2021-07-27). 1.5 Getting help We have a Discord chatroom, which you can join using the following link: https://discord.gg/TaUNBXr 2 Chapter 1. Getting started CHAPTER 2 Frequently Asked Questions 2.1 Do I need to own Minecraft: Pocket Edition to play? Yes. To download and update a compatible versions of the Game, the Google Play account you sign in with needs to own the game on the Play Store. Then you are able to download and play some previous versions of the game as well, althought not offically supported by Google Play. 2.1.1 The launcher cannot download the game from: • The Amazon App store, althought may or may not work on arm devices. You have to extract the apk from an amazon device. 2.1.2 The launcher cannot download and cannot launch the game from: This would require a completly different Launcher, if that would even possible • The Apple iOS App store • The Microsoft Store, previously by redeeming a gift code for Minecraft: Windows 10 Edition 2.2 Does it work on Windows 7 / 8? No, due to the amount of work required to get this running on Windows. Play the Windows 10 Edition instead if you can. Note that you can not play Minecraft in the current version of Windows Subsystem for Linux (WSL), as the mouse input is broken due to an issue with its graphic stack. 3 Minecraft Bedrock Launcher Documentation 2.3 How does it work? The project runs the native libraries from the Android version directly on your computer. This is accomplished by fixing the incompatibilities between the libc used on Android and the one used on desktop Linux or OS X (Android - Bionic; Linux - glibc). This is a simple compatibility layer which doesn’t impact performance in any significant way; it’s similar to Wine, but much more lightweight and simple. Aditionally, all Android-specific code has been rewritten to run on Linux (AppPlatform, Store, Xbox Live, etc.). 2.4 Where are my worlds? Linux: ~/.local/share/mcpelauncher/games/com.mojang/minecraftWorlds Linux (Flatpak): ~/.var/app/io.mrarm.mcpelauncher/data/mcpelauncher/games/com. mojang/minecraftWorlds Mac OS X: ~/Library/Application Support/mcpelauncher/games/com.mojang/ minecraftWorlds Each world has its own directory. If you have multiple worlds, you can identify them by their name in levelname. txt found in each world. The mcpelauncher-server creates and expects its world files in world. 2.5 Can I use resource packs? Yes, put them in ~/.local/share/mcpelauncher/games/com.mojang/resource_packs. (For Flatpak) ~/.var/app/io.mrarm.mcpelauncher/data/mcpelauncher/games/com.mojang/ resource_packs For Mac OS X, put them in ~/Library/Application Support/mcpelauncher/games/com.mojang/ resource_packs. Shaders are also resource packs. (Shaders must be GLSL based and must be compatible with your graphics drivers) Note: You will probably need to extract .zip and .mcpack files into their own subdirectory for them to work properly. 2.6 Why would I want to use this projects server, instead of the offi- cial one? If. • the official one doesn’t work for you • you need scripting on the server • some rarely needed particular modding capabilities 4 Chapter 2. Frequently Asked Questions CHAPTER 3 Troubleshooting • Extracting APKs – I downloaded a Minecraft APK from the internet and it doesnt work! – I copied the Minecraft APK from my phone over to my computer, but it doesnt extract – Can somebody give me the APK / extracted files? • AppImage – AppImage crashes when I try to sign in to Google • Controller – The player’s view drifts by itself when a controller is plugged in – The controller doesn’t work at all • Game launcher – Graphics performance issues (software rendering) - EGLUT: failed to initialize EGL display... – MSA daemon could not be found – No audio / music – Updating the launcher – MacOS X Catalina – Google prevents login This browser or app may not be secure. Try using a different browser – File picking doesn’t work or crashes – I compiled and/or installed everything, but Minecraft doesn’t start 5 Minecraft Bedrock Launcher Documentation – I used the Qt UI (metalauncher) to download the game, but mcpelauncher-client still doesn’t work – I run into lagspikes during gameplay • Qt launcher UI – Running the troubleshooter – Could not find the game launcher – The launcher crashes when I press Download and Play – Clearing the launcher UI data – Obtaining the game log 3.1 Extracting APKs 3.1.1 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. 3.1.2 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. 3.1.3 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. 3.2 AppImage 3.2.1 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. 3.3 Controller 3.3.1 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. 6 Chapter 3. Troubleshooting Minecraft Bedrock Launcher Documentation • Linux: https://wiki.archlinux.org/index.php/Gamepad#evdev_API_deadzones or if you have an Xbox360 Con- troller, open a terminal and run sudo xboxdrv --detach-kernel-driver --deadzone 6000 --silent --type xbox360 --mimic-xpad while you are ingame. • Mac OS X: TBA 3.3.2 The controller doesn’t work at all Under Linux, you may have to plug the controller after launching the game. 3.4 Game launcher 3.4.1 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.