PocketMine-MP for android

Have you ever wanted to run a Minecraft server just for you on your Android device? This module makes that idea come true by giving your rooted phone or tablet the power of PocketMine-MP. It comes with everything you need to host a Minecraft Bedrock Edition (MCPE) world that your friends can join, including the required ARM64 PHP executables and their dependencies.

This module is flexible and works with all of the most popular modern root solutions, such as Magisk, KernelSU, and Apatch. You can start a persistent server, manage plugins, and have a full Minecraft experience at home or on the go without needing a PC or a third-party hosting service. This article will show you how to set up, run, and take care of your new mobile server.

Installation and Server Operation

It’s easy to get started. You install the module just like you would any other Magisk, KSU, or Apatch module. After you flash the module and restart your device, the core server files will be in a separate folder, ready to use.

You need a terminal environment on your Android device to run your server.

• Using a Terminal Emulator (e.g., Termux):

  1. Open your terminal application.
  2. Request superuser (root) permissions by typing su.
  3. Execute the server’s startup script using the simple command: start-pmmp.

• Using ADB Shell:

  1. Use a USB cable to connect your device to your computer.
  2. Start a session with the ADB shell.
  3. Gain root access with su.
  4. Run the start-pmmp command.

Manual Startup (Fallback)

You can always start the server by hand if the start-pmmp command alias doesn’t work for some reason. Go to the installation folder and run the “start.sh” script directly:

su
cd /data/local/pmmp
sh start.sh

When you run this for the first time, PocketMine-MP will open a setup wizard right in the terminal. This wizard will set up the most important settings for your server, like the name of the server, the game mode, the port, and other things.

Making Your Server Public (Port Forwarding)

By default, only devices that are connected to your local Wi-Fi network will be able to access your server. You need to use a tunneling service to get around your mobile carrier or router’s firewall so that friends can connect over the internet (WAN).

The module developer offers a number of possible fixes:

• Tailscale: A lot of the time, this is the easiest way. You can get the Magisk Tailscaled module or the official Tailscale app from the Play Store. This makes a safe private virtual network (VPN) for you and your friends, so they can see your server as if they were on your local network.
• Playit.gg: The developer says that the playit-linux-aarch64 binary has problems working with Android right now, even though it is a popular choice for desktop servers. It might need a lot of changes or to be run in a complicated “proot” environment, like a proot-based Ubuntu image in Termux. Right now, it’s not easy to use this module to do direct tunneling with Playit.gg on Android.

Updating Your Server Software

The module comes with a handy script that will keep your server software and its PHP base up to date. Run the command “update-pmmp” from your terminal (while logged in as “su”) to use it.

The script gives you a few choices for small updates:

update-pmmp [options]

• --all or -a: This updates both the PocketMine-MP.phar server file and the PHP binaries.
• --phar-only or -p: This updates only the PocketMine-MP.phar file, leaving your PHP binaries untouched.
• --php-only or -b: This updates only the PHP binaries.
• --help: This displays the help message with all available options.

We get the precompiled PHP8 binaries from the TukangM/php8-aarch64-builds repository. During the update process, always keep an eye on the terminal output for any mistakes.

Data Persistence on Uninstallation

The fact that this module can be uninstalled without damaging anything is very important. The /data/local/pmmp folder will not be deleted when you use Magisk, KernelSU, or Apatch to remove the module.

This is a deliberate design choice to keep your important server data safe. Your world files, player data, plugin settings, and server.properties settings will all stay safe and sound, so you won’t lose them by accident. You can update, reinstall, or temporarily turn off the module without losing your community’s progress.

Module Status and Future Roadmap

The developer has made a plan for future improvements, but it’s important to know what stage the module is currently in.

Roadmap Goals:

• Done: A function that updates the server .phar file and the PHP8 binaries.
• Pending: A full rewrite of the “update-pmmp” (update.sh) script to make it work better.
• Pending: Support for amd64 PHP binaries, which will probably be used in Android emulators that run on x86.
• Pending: A WebUI (Web User Interface) that will make server management easier by getting rid of the need for terminal-only commands.

Important Note: Based on what is happening in the source repository, this module may not be being worked on anymore. Please be careful and know that some features, especially those that have to do with the newest versions of Minecraft, may not work as expected or may be out of date.

Download Link

Link

Module Info

• Module By
  SayaAEP
• Root Support
  Magisk KernelSU APatch
• Source View on GitHub/Source
• Latest Update 28 August 2025
• Word Counter 863
• Character Counter 7343

PocketMine-MP for android is a Module that supports installation on Magisk, KernelSU, APATCH, KSUNext