mcpe

This MCP server hosts PocketMine-MP, a highly customizable PHP-based server for Minecraft: Bedrock Edition. It enables a plugin-driven experience, allowing you to add custom gameplay features, world management, and server-side automation through a rich ecosystem of plugins. The Docker option lets you spin up a ready-to-run instance with PocketMine-MP and its plugin ecosystem, while Docker also helps isolate dependencies and simplify updates. After starting the server via Docker, you’ll manage plugins and configurations through the PocketMine-MP directory inside the container or via mounted volumes if you prefer local persistence. The server supports multi-world setups, a robust plugin API, and is regularly updated to accommodate new Bedrock versions.

Prerequisites:

• Docker installed on your machine (Docker Desktop for Windows/macOS or Docker Engine for Linux)
• Sufficient hardware for your expected player count and plugins

Option A: Run with Docker (recommended for quickest setup)

1. Ensure Docker is running on your system.
2. Pull and run PocketMine-MP container: docker run -it --name mcpe-pocketmine -p 19132:19132/udp ghcr.io/pmmp/pocketmine-mp:latest
3. Wait for the server to initialize. Logs will appear in your terminal.
4. To stop the server: docker stop mcpe-pocketmine
5. To restart: docker start mcpe-pocketmine

Option B: Manual PHP installation (advanced)

1. Install PHP 7.4+ and required extensions (depending on plugin needs).
2. Download PocketMine-MP from the official repo: git clone https://github.com/pmmp/PocketMine-MP.git cd PocketMine-MP
3. Install dependencies via Composer (if required by your setup): composer install
4. Run the server: php PocketMine-MP.phar
5. Manage plugins by placing them into the plugins/ directory and restarting the server.

Note: For production, using the Docker image is generally simpler and provides better portability.

Tips and common issues:

• Always verify compatibility of plugins with the Bedrock edition version you’re running. Incompatible plugins can crash the server or cause unstable behavior.
• If you’re using Docker, consider mounting a local directory as a volume to persist the world and plugins between restarts.
• When exposing ports, ensure 19132/UDP is reachable by clients if you intend players outside your network to join.
• Regularly update PocketMine-MP and plugins to stay in sync with Bedrock version updates.
• Review official docs and plugin repositories for compatibility notes and configuration specifics.
• If you run into startup errors, check PHP version compatibility, missing PHP extensions, and plugin dependencies.