PocketMine-MP
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.
Click to view screenshots
[!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, theupdate-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.
Installation
There are several ways to install the PocketMine-MP4Android Magisk module:
Method 1: Using Magisk Manager or KernelSU
- 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.
Method 2: Using a Module Manager App
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.
Usage
- 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
Workaround for Port Forwarding
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.
Uninstallation
The pmmp
folder will not be removed upon uninstalling the module. This ensures that your world data, plugins, and server settings remain intact.
Updating
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]
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.
Roadmap
- Function update binary php8 and server phar
- rewrite update-pmmp (update.sh)
- amd64 php8 binary support
- WebUI functionality
License
- PocketMine-MP: LGPL-3.0
- PocketMine-MP4Android: MIT License
Download Link
Module Info
- Module By
- Root SupportMagisk KernelSU APatch
- Source View on GitHub/Source
- Date Release
PocketMine-MP is a Module that supports installation on Magisk, KernelSU, APATCH, KSUNext