Home

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

Welcome to the mcpelauncher-linux wiki!

In this Wiki

• Requirements for installation
  • 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
• Compiling
  • Compiling on Linux
    • Starting mcpelauncher-linux
  • Compiling on macOS
    • Starting mcpelauncher-linux
• Updating Minecraft
  • Updating Minecraft version
  • Updating mcpelauncher-linux
• Bugs & Workarounds
  • No sound
  • Changing resolution changes the UI size
  • MCPE doesn't start (or lags, heavy lags) under nvidia-340 drivers or similar ones
• Useful Tips & Tricks
  • Creating a desktop shortcut for non installed builds
  • Running mcpelauncher in current working directory (useful for beta builds)
  • User data folder
  • Changing your skin (if you encounter issues when changing it normally)
  • Bypass Xbox Live sign-in
  • Backup your worlds manually
  • Manually create a .mcworld file
  • Import a .mcworld manually
  • Import a resource pack manually
  • Switch between fullscreen and windowed mode
• Dedicated Server
  • Server Properties
    • Default server.properties
    • Supported properties
    • Example of a custom server.properties file

Recommended OSes

This launcher requires either a 32-bit OS or a 64-bit OS with multiarch support.

• Ubuntu 16.04 or greater
• Linux Mint 18 or greater
• Debian 9 or Unstable
• elementary OS 0.4 or greater
• Deepin
• Arch Linux
• Manjaro Linux
• Antergos Linux
• Fedora 25 or greater
• OpenSUSE Tumbleweed
• macOS

Submitting a bug

Before submitting a bug please search for it in the issue tracker to avoid duplicates.

When submitting a bug, include:

• Minecraft version & complete APK name
• Launcher source branch
• CPU brand and model
• GPU brand and model
• Graphics drivers you are using, and their version
• Linux distribution
• If you think it's necessary, your PC/laptop brand and model

Testing procedure

The procedures described in this wiki have been tested using:

• A Vagrant box: vagrant init boxcutter/ubuntu1604-desktop
• A physical Linux Mint 18 installation, with an Intel i5 and a Nvidia GeForce GTX 970 GPU.
• A physical Xubuntu 16.04 64-bit installation, with an Intel Pentium E5300 and a Nvidia GeForce 9400GT GPU.

TODOs for this wiki:

• Describe update procedure (must be updated and must use sudo make install)
• Update requirements for Arch and Fedora
• Add requirements for other major distros (if any)
• Update and restyle the wiki, to make it user friendly
• Address all the new common bugs in Bugs and Workarounds
• Separate macOS compiling and running procedures from requirements