PocketMine Wiki

PocketMine-MP 5

Ядро сервера Minecraft Bedrock Edition на PHP. API 5.x, плагины .phar, актуальная ветка 5.44+.

API 5 PHP 8.1+ Bedrock
PocketMine-MP 5 — Minecraft Wiki PocketMine

PocketMine-MP (PMMP) — open-source серверное ПО для Minecraft: Bedrock Edition, написанное с нуля на PHP. На 2026 год актуальная ветка — 5.x (релизы 5.44+). Используется тысячами серверов и маркетплейсов плагинов, в том числе экосистемой PocketMine.ru.

Что такое PocketMine-MP

В отличие от Java-ядер (Spigot/Paper), PMMP обслуживает клиентов Bedrock (Windows, mobile, console). Плагины пишутся на PHP и пакуются в .phar. Есть события, команды, permissions, миры, сущности, inventory API и REST-подобные внутренние интерфейсы ядра.

Требования (2026)

PHP^8.1 (64-bit), рекомендуется 8.2/8.3
Расширенияpmmp-специфичные: chunkutils2, crypto, leveldb, libdeflate, mop, encoding… (см. binary/release)
ОСLinux x86_64 / aarch64; Windows через готовые builds
RAMОт 1–2 ГБ для теста; 4–8+ ГБ для онлайна
APIСовпадает с версией ядра (semver): major.minor.patch

Установка (кратко)

  1. Скачайте официальный release PocketMine-MP (phar + start script) с GitHub pmmp/PocketMine-MP.
  2. Установите PHP binary от PMMP (или свой 8.1+ с нужными ext).
  3. Запустите ./start.sh / start.cmd, примите EULA, укажите порт (по умолчанию 19132 UDP).
  4. Плагины кладите в plugins/, перезапускайте или используйте loaders.

Структура сервера

  • pocketmine.yml — настройки ядра, сеть, performance
  • server.properties — gamemode, max-players, motd, level
  • plugins/ — .phar плагины
  • worlds/ — миры
  • plugin_data/ — конфиги плагинов
  • crashdumps/, logs/ — отладка

Плагины: plugin.yml

Минимальный манифест плагина API 5:

Поле Значение
name Имя плагина
version 1.0.0
main Namespace\Main class
api 5.0.0 (минимум совместимости)
author Автор
commands Список команд + permission
permissions Дерево прав

API 5 — ключевые концепции

  • Events — Listener + #[EventHandler] / registerEvents
  • Commands — Command class или plugin.yml + onCommand
  • Items — string ID через StringToItemParser (не legacy numbers)
  • Entities — EntityFactory / spawn
  • Forms — UI формы для Bedrock
  • Scheduler — отложенные задачи, не блокировать main thread
  • Permissions — pocketmine.command.* и custom nodes

Команды ядра (часто используемые)

/versionВерсия PMMP и API
/pluginsСписок плагинов
/stopКорректная остановка
/op <player>Оператор
/whitelistБелый список
/timingsПрофилирование лагов
/statusTPS / память
/gcСборка мусора PHP

PMMP vs Nukkit vs Vanilla Bedrock

  • Vanilla Realms/BDS — официальный Bedrock Dedicated Server, мало кастомизации.
  • PocketMine-MP — PHP, огромная база плагинов RU/EN, .phar, Forms API.
  • Nukkit/PowerNukkitX — Java-альтернатива для Bedrock, другой API плагинов.

Производительность и безопасность

  • Не вызывайте тяжёлый I/O в main thread — async/tasks.
  • Не раздавайте op публично; настраивайте permissions.
  • Бэкапы worlds/ и plugin_data/ по cron.
  • Обновляйте ядро вместе с протоколом Bedrock (minor bumps часто = новая версия клиента).
  • Phar-плагины проверяйте: Unphar на сайте распакует локально.

Полезные ссылки на PocketMine.ru

Команды · ID предметов · Unphar · Glyph · Плагины · Spigot/Paper wiki