PocketMine-MP4Android

Run Minecraft Bedrock Edition on Android.

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, 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.

Installation

1. Download the latest release from the Releases page.
2. Flash the Magisk module using one of the following methods:
   • Magisk Manager:
     1. Open Magisk Manager.
     2. Go to the "Modules" section.
     3. Tap the "+" button and select the downloaded PMMP Magisk module.
     4. Reboot your device.
   • KernelSU:
     1. Open Magisk Manager.
     2. Go to the "Modules" section.
     3. Tap the "+ Install" button and select the downloaded PMMP Magisk module.
     4. Reboot your device.
3. Alternatively, use Androidacy Module Manager or MMRL (enable Magisk-Modules-Alt-Repo in settings).

Usage

1. Open a terminal emulator on Android (e.g., Termux) or use ADB shell.
2. Execute these commands:
   • Superuser access:

     su
     start-pmmp

   • For Termux:

     su
     start-pmmp

3. 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.

Todo

• Function update binary php8 and server phar.
• WebUI functionality (coming soon)
• rewrite update-pmmp

License

• PocketMine-MP: LGPL-3.0
• PocketMine-MP4Android: MIT License