Ядро сервера

PocketMine-MP 5

Ядро Bedrock на PHP: установка, API 5.x, плагины.phar, PHP 8.1+. Для телефонов и Windows Bedrock.

API 5 PHP 8 Bedrock
PocketMine-MP 5 — Minecraft Wiki PocketMine

PocketMine-MP — открытое ядро сервера для Minecraft Bedrock на PHP. Актуальная ветка 5.x: плагины в .phar, свой PHP binary, тысячи серверов в экосистеме PocketMine.ru.

netherite sword command block chest front book writable emerald hopper

Что такое PocketMine-MP

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

Требования (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Совпадает с версией ядра (версии (major.minor.patch)): 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 NamespaceMain 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 (не старые числовые ID)
  • 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

Кому подходит PMMP

Bedrock-аудитория, PHP-плагины, относительно лёгкий VDS. Не ждите 1:1 ванили Java: часть блоков и редстоуна упрощена. Ставьте PHP binary под ветку 5.x, не смешивайте плагины от PM3/PM4 без проверки API. См. PHP, Termux, команды.