PocketMine Wiki

Установка PHP для PocketMine-MP

Готовый PHP binary 8.1–8.3 с расширениями PMMP, Linux/Windows, start.sh, типичные ошибки. Без «голого» apt-php для продакшена.

PHP 8.2 PHP 8.3 PMMP 5
Установка PHP для PocketMine-MP — Minecraft Wiki PocketMine

PocketMine-MP не запускается на обычном PHP из репозитория Ubuntu «как есть»: нужны специфичные расширения (chunkutils2, leveldb, crypto, libdeflate и др.). Официальный путь — prebuilt PHP binary проекта PMMP.

Какой PHP нужен (2026)

PocketMine-MP 5.xPHP ^8.1 64-bit
РекомендацияBinary 8.2 или 8.3 из релизов PHP-Binaries (PM5)
Системный apt phpМожно для сайта/WordPress, не как runtime PMMP
Архитектураx86_64 или aarch64 — берите binary под свою ОС
Важно. Не смешивайте /usr/bin/php сайта и ./bin/php7/bin/php (или актуальный путь binary) сервера Minecraft. Для PMMP используйте binary из комплекта.

Linux: установка binary (ручной метод)

  1. Создайте каталог сервера: mkdir -p ~/pmmp && cd ~/pmmp
  2. Скачайте prebuilt PHP для PM5 (Linux x86_64 / arm) из релизов pmmp/PHP-Binaries — тег вроде pm5-php-8.2-latest / pm5-php-8.3-latest.
  3. Распакуйте архив в папку сервера: должен появиться каталог bin/.
  4. Скачайте PocketMine-MP.phar и start.sh из релизов pmmp/PocketMine-MP.
  5. chmod +x start.sh
  6. Запуск: ./start.sh — скрипт сам вызовет PHP из bin/.

Проверка binary

Команда Ожидание
./bin/php7/bin/php -v (путь зависит от сборки) PHP 8.1 / 8.2 / 8.3
./bin/.../php -m Список модулей, в т.ч. pmmp-расширения
./start.sh Старт ядра, генерация server.properties

Точный путь к php внутри bin/ смотрите в распакованном дереве (имя каталога меняется между сборками). В актуальных start.sh путь уже прописан.

Windows

  1. Скачайте Windows PHP binary для PM5 из тех же релизов PHP-Binaries.
  2. Распакуйте в папку сервера вместе с PocketMine-MP.phar и start.cmd / start.ps1.
  3. Запускайте start-скрипт, а не «просто php.exe» без нужных ext.

Сборка PHP из исходников (advanced)

Нужна, если нет prebuilt под вашу платформу. Официальный скрипт compile.sh из PHP-Binaries тянет зависимости (make, cmake, autoconf, компилятор C/C++). На обычном VDS проще prebuilt.

Типичные ошибки

Unable to load dynamic libraryНе тот binary / битый unpack / неверная arch
API version mismatchПлагин под другой major API — обновите плагин или ядро
Permission denied start.shchmod +x start.sh
Сеть / портUDP 19132, firewall/security group
OOM / killМало RAM; снизьте view-distance, число плагинов

PHP сайта ≠ PHP PMMP

На этом VDS WordPress крутится на PHP 8.3 FPM — это другой стек. Для Minecraft-сервера всегда отдельный binary PMMP. Не указывайте в start.sh путь к php-fpm сайта.

Связанные гайды

PocketMine-MP 5 · Unphar · Команды · Установка Java (для Nukkit/Paper)