Run your own PocketMine-MP server directly on your Android device with this Magisk module. This module provides a native ARM64 build of PocketMine-MP and its dependencies, allowing you to host a Minecraft Bedrock Edition server on your phone or tablet.
Important
The binary included in this Magisk module is now only prebuilt from TukangM/php8-aarch64-builds/releases. As of December 2024, PocketMine-MP at PHP-Binary releases has added CI automation builds for linux-arm64. Therefore, the update-pmmp
function will remain updated to the latest version in the next update from PHP-Binary.
Notes about binary
Prebuilt binary from this module (left) and official PocketMine-MP binary (right). The size is slightly bigger than the prebuilt binary included with the module.
There are several ways to install the PocketMine-MP4Android Magisk module:
- Download the latest release of the module from the Releases page.
- Open your Magisk Manager or KernelSU application.
- Navigate to the "Modules" section.
- Tap the "+" or "Install" button and select the downloaded ZIP file.
- Reboot your Android device to activate the module.
You can also use a third-off-party module manager that supports the Magisk-Modules-Alt-Repo, such as:
Simply enable the Magisk-Modules-Alt-Repo in the settings of your chosen module manager and install the "PocketMine-MP4Android" module directly from there.
- Open a terminal emulator on Android (e.g., Termux) or use ADB shell.
- Execute these commands:
- Superuser access:
su start-pmmp
- For Termux:
su start-pmmp
- Superuser access:
- If
start-pmmp
doesn’t work, manually run the start script:cd /data/local/pmmp sh start.sh
You can use Magisk Tailscaled, Tailscale from Play Store, or Playit.gg (development in progress). Currently, playit-linux-aarch64 has issues on Android, requiring changes or running on proot. For now, tunneling with Playit.gg on Android is not possible. Running it in Termux with a proot Ubuntu core image is an alternative.
The pmmp
folder will not be removed upon uninstalling the module. This ensures that your world data, plugins, and server settings remain intact.
To update the PHP8 binaries and PocketMine-MP, use the update-pmmp
script. This script allows you to selectively update components as needed. Here are the available options:
update-pmmp [options]
--all, -a
: Update both PocketMine-MP.phar and PHP binaries.--phar-only, -p
: Update only the PocketMine-MP.phar file.--php-only, -b
: Update only the PHP binaries.--help
: Show this help message.
The PHP8 precompiled binary is sourced from TukangM/php8-aarch64-builds.
Make sure to check the terminal output for any errors during the update process.
- Function update binary php8 and server phar
- rewrite update-pmmp (update.sh)
- amd64 php8 binary support
- WebUI functionality
- PocketMine-MP: LGPL-3.0
- PocketMine-MP4Android: MIT License