Minecraft: Pi Edition For Docker

This is a project allowing Minecraft: Pi Edition to be run without a Raspberry Pi using Docker.

Setup

1. Download Appropriate Package (See Table Below) From Here
2. Install With sudo apt install ./<Path To File>

Packages

Package	Description
minecraft-pi-server	Minecraft Pi Edition Modded Into A Dedicated Server
minecraft-pi-virgl	Minecraft Pi Edition Using VirGL For Hardware Acceleration (Recommended For Desktop)
minecraft-pi-native	Minecraft: Pi Edition Using Docker Device Mounting For GPU Acceleration (Recommended For ARM Devices (ie. Raspberry Pi, PinePhone, etc))

General Notes

Docker Versions

While the distribution-provided version of Docker works fine on most systems, in rare cases it can be outdated and cause bugs. Before reporting a bug, try using the official builds of Docker. These can be installed by following your distribution's instructions at https://docs.docker.com/engine/install.

Specific Notes

Raspbian Buster

By default Raspbian Buster ships an older version of the package libseccomp2. This package is used to block certain dangerous system calls from running inside Docker containers. The included version accidentally blocks the system call clock_gettime64, this causes bugs inside Minecraft: Pi Edition. However, the Debian buster-backports repo includes an updated version. You can enable the buster-backports repo and update libseccomp2 by running:

# Install Backports Key
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 04EE7237B7D453EC
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 648ACFD622F3D138
# Install Backports Repository
echo 'deb http://deb.debian.org/debian buster-backports main' | sudo tee -a /etc/apt/sources.list
# Update APT Index
sudo apt update
# Install Updated libseccomp2
sudo apt install -t buster-backports libseccomp2

PinePhone (Mobian)

This supports running on a PinePhone using Mobian. However, you will need to attach a keyboard and mouse as Minecraft: Pi Edition does not have touch support.

Troubleshooting Crashes

Game logs are located in /tmp/minecraft-pi.

Error response from daemon: error gathering device information while adding custom device "/dev/dri": no such file or directory

Make sure you are using the correct GPU drivers for your system. If you are using a Raspberry Pi, make sure you have set your GPU driver to Full KMS or Fake KMS in raspi-config.

Segmentation Fault

1. Attempt To Reproduce Issue And Record Instructions
2. Report On Issue Tracker Including The Instructions To Reproduce

Dedicated Server

The dedicated server is a version of Minecraft: Pi Edition modified to run in a headless environment. It loads settings from a server.properties file.

To use, install the minecraft-pi-server package and run minecraft-pi-server. It will generate the world and server.properties in the current directory.

This is also compatible with MCPE 0.6.1.

Limitations

• Player data is not saved because of limitations with MCPE LAN worlds
  • An easy workaround is to place your inventory in a chest before logging off
• Survival mode servers are only compatible with minecraft-pi-docker clients

Modding

View Modding

Credits

View Credits