diff --git a/README.md b/README.md index fb3ac96..ef72cf9 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,20 @@ This is a project allowing Minecraft: Pi Edition to be run without a Raspberry P | ``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 Raspberry Pi) | +### 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. + +### Distribution-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: +```sh +echo 'deb http://deb.debian.org/debian buster-backports main' | sudo tee /etc/apt/sources.list +sudo apt update && sudo apt install libseccomp2 +``` + ## 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.