This is a legacy repository, go to https://github.com/minecraft-linux/mcpelauncher-manifest/wiki

Table of Contents

• Debian and Debian-based distributions
  • Installing the required dependencies
  • Ubuntu 16.04 - Installing CMake 3.7.1
• Arch Linux and Arch based distributions
  • Enabling multilib support
  • Installing the required dependencies
• Fedora
• macOS

Debian and Debian-based distributions (such as Ubuntu, Linux Mint, elementary OS, Deepin)

Installing the required dependencies

Firstly, you should make sure that your system is updated.

$ sudo apt update && sudo apt upgrade

If your system is based on 64 bit architecture then you must add i386 architecture to dpkg

$ sudo dpkg --add-architecture i386
$ sudo apt update

Now you can install the necessary packages to build mcpelauncher-linux. If you want a minimal build (No Xbox Live and no first time setup/Google Play APK download) do:

$ sudo apt install git cmake gcc-multilib g++-multilib zlib1g-dev:i386 libx11-dev:i386 libzip-dev:i386 libpng-dev:i386 libcurl4-openssl-dev:i386 libssl-dev:i386 libgles2-mesa-dev:i386 libudev-dev:i386 libevdev-dev:i386

If you also want Xbox Live compatibility, then install those packages as well (CEF build):

$ sudo apt install libgtk2.0-0:i386 libgtkglext1:i386 libasound2:i386 libnss3:i386 libxss1:i386 libgconf2-4:i386 libxtst6:i386 libudev1:i386

If you also want the ability to log in to Google Play and download the necessary APK from there at first launch, then install those packages as well (Google Play supported build):

$ sudo apt install protobuf-compiler libprotobuf-dev:i386

In some systems installing those packages isn't enough; if you have issues with dependencies there are a few more (source comment)

$ sudo apt install libmirclient-dev:i386 libmircommon-dev:i386 libxkbcommon-dev:i386 libmirclient-dev:i386 libwayland-dev:i386 libwayland-egl1-mesa:i386 libegl1-mesa-drivers libegl1-mesa-dev:i386 libegl1-mesa:i386 libgles2-mesa-dev:i386 

Ubuntu 16.04 - Installing CMake 3.7.1

You can get a recent enough cmake without breaking your system by doing a local compile of it.

$ wget "https://cmake.org/files/v3.7/cmake-3.7.1.tar.gz"
$ tar xvzf cmake-3.7.1.tar.gz 
$ cd cmake-3.7.1/
$ ./bootstrap 
$ sudo make install
$ cd ..
$ rm -r ./cmake-3.7.1/ # we need to clean up
$ rm cmake-3.7.1.tar.gz

Arch Linux and Arch-based distributions (Manjaro Linux, Antergos Linux)

Enabling multilib support

NOTE: It is recommended to use a trustworthy AUR helper. yaourt is insecure and vulnerable. Select a helper from this list. trizen will be used for this tutorial.

First, make sure you have the multilib repository enabled in your pacman.conf.

This isn't necessary for Manjaro and Antergos users.

$ sudo nano /etc/pacman.conf

Uncomment the multilib repository and then save (Ctrl + O).

Next, make sure your system is up-to-date.

$ sudo pacman -Syu

Installing the required dependencies

Now you can install the necessary packages to build mcpelauncher-linux. If you want a minimal build (No Xbox Live and no first time setup/Google Play APK download) do:

$ trizen -S git cmake gcc-multilib lib32-zlib lib32-libx11 lib32-libpng lib32-curl lib32-openssl lib32-mesa lib32-util-linux lib32-libstdc++5 lib32-gcc-libs lib32-glibc libzip lib32-libzip lib32-libevdev lib32-libudev0

If you also want Xbox Live compatibility, then install those packages as well (CEF build):

$ sudo pacman -S lib32-gtk2 lib32-alsa-lib lib32-alsa-plugins lib32-nss lib32-libxss lib32-gconf lib32-libxtst

If you also want the ability to log in to Google Play and download the necessary APK from there at first launch, then install those packages as well (Google Play supported build):

$ trizen -S protobuf lib32-libprotobuf

Fedora

NOTE: This section MUST be updated and no longer applies to mcpelauncher-linux.

Open a terminal and paste the following command to install all required packages.

$ sudo dnf install cmake gcc gcc-c++ libX11-devel.i686 mesa-libGLES-devel.i686 mesa-libEGL-devel.i686 glibc-devel.i686 
libpng-devel.i686 uuid-devel.i686 libuuid-devel.i686

macOS

Make sure you've got XCode set up: xcode-select --install (when the dialog pops up, just say you want the tools). Next, make sure you have Brew installed

The packages you'll need are as follows:

• cmake
• git (this will come pre-installed with xcode-select, but make sure it's up-to-date)

Everything else will be built automatically and statically linked against your executable. So do not install libzip, ossp-uuid, glfw or any other packages you think you need.

Next, you'll need to build the project.

CEF builds on macOS are not (yet) supported!

Compiling