PocketMine-MP Documentation

PocketMine-MP is a custom server software for the Minecraft: Bedrock family of Minecraft editions (includes Android, iOS, W10 and others).

What features does it have?

• A powerful plugin API, which allows you to extend and customize your server far more easily and extensively than any competing server implementations, including the official vanilla server.
• Multi-world support, allowing you to offer a more varied game experience to players without transferring them to other server nodes.
• Performance fit to hold 100+ players (depends on hardware, see the requirements section).
• Continuously updated to support latest Minecraft versions. PocketMine-MP has the longest and best track record of any custom server for compatibility with new Minecraft versions.

Getting Started

• Installation
  • Setup requirements
  • Using https://get.pmmp.io (Linux/MacOS only)
  • Installing manually
  • Starting for the first time
• Updating
  • Update using the installer (Linux/MacOS only)
  • Manually update
• Configuration
  • Default configuration files
• Plugins
  • Downloading plugins
  • Installing/updating a plugin
  • Writing your own plugins

Frequently Asked Questions

• Connecting
  • Can’t connect to the server after updating Minecraft
  • What does “Opening server on 0.0.0.0:19132” mean?
  • How do I add an external server which is not on my network?
  • Do I have to open ports in my firewall?
  • Can other users connect to my server?
  • Do I have to configure port forwarding?
  • RakLib Thread Blocked x.x.x.x for x seconds
  • Can’t connect to localhost Win10 server with Minecraft Win10 Edition
• Installation
  • Failed loading opcache.so (or other PHP extensions)
  • Can’t install as user root
  • Can I install PocketMine-MP on Windows XP?
• Playing
  • Why doesn’t X or Y gameplay feature work on PocketMine-MP? Is it a bug?
  • Can Minecraft: Java Edition (PC) clients connect to a PocketMine-MP server?
• Plugins
  • How do I install plugins?
  • What does “Incompatible API version” mean when loading a plugin?
  • I can’t get a .phar for a plugin. How do I create one?
  • Can I run a plugin from source without creating a .phar?

Issues, Bugs and Crashes

• Crashes
  • Reporting a crash
  • What’s in a crashdump file?
• Using the GitHub Issue Tracker
  • Issue template

Other

• Contact and Support
• Links
  • Downloads
    • PocketMine-MP prebuilt phars
    • Linux & MacOS installer script
    • Prebuilt PHP binaries and related packages
      • Linux, Windows & MacOS
  • Other links