DevTools для PocketMine-MP: от папки плагина до PHAR

Создайте рабочую команду PocketMine, соберите плагин с DevTools 1.17.2 и проверьте PHAR на отдельном сервере без DevTools.

Язык материала

DevTools превращает редактируемую папку плагина PocketMine в PHAR, который можно перенести на другой сервер. Создайте небольшую команду ModonixWorkshop по примеру ниже, соберите плагин и проверьте ответ в Minecraft. Простая первая команда позволяет легко проследить путь от исходного кода до работающего плагина.

Установите DevTools на совместимый сервер PocketMine. Команды ниже выполняются в консоли сервера, без начального слеша; для заключительной проверки в игре используйте /workshop.

Установленный PHAR ModonixWorkshop отвечает в Bedrock 26.52 рядом с нашим деревянным причалом в лобби.

Установленный пример PHAR отвечает «ModonixWorkshop 0.0.1 is ready.». Причал — наша демонстрационная постройка, а не карта из комплекта DevTools.

Начните с подходящего сервера и файла DevTools

Для этого примера запустите Axolotl-PM 5.49.1 в отдельной папке для разработки с PHP 8.3.29 ZTS и расширениями, необходимыми серверу. Пока осваиваете сборку, держите основной сервер отдельно. Клиент Minecraft понадобится только для проверки команды в игре.

Остановите этот сервер, поместите DevTools 1.17.2 в папку plugins под именем DevTools.phar и запустите сервер снова. Введите:

plugins
genplugin ModonixWorkshop Modonix

Первая команда выводит список загруженных плагинов. Вторая создаёт plugins/ModonixWorkshop/plugin.yml и plugins/ModonixWorkshop/src/Main.php. Используйте эти имена в коде примера ниже: имя автора также становится частью пространства имён PHP.

Создание папки не загружает новый плагин сразу. Остановите сервер перед редактированием этих файлов и перезапустите после изменений.

Добавьте в пример одну команду для проверки

Замените содержимое plugins/ModonixWorkshop/plugin.yml следующим:

name: ModonixWorkshop
version: 0.0.1
main: Modonix\ModonixWorkshop\Main
api: 5.44.3
src-namespace-prefix: Modonix\ModonixWorkshop
commands:
  workshop:
    description: Check the workshop plugin
    permission: modonixworkshop.command.workshop
permissions:
  modonixworkshop.command.workshop:
    default: op

Пример выше сохраняет API 5.44.3 как минимальную версию из исходного руководства. В только что сгенерированном файле вместо неё может стоять API работающего сервера; здесь приведено значение, заявленное для примера. Сам DevTools заявляет минимальный API 5.0.0. Изменение любого из этих чисел не адаптирует код плагина к старому API.

Замените содержимое plugins/ModonixWorkshop/src/Main.php следующим:

<?php
declare(strict_types=1);

namespace Modonix\ModonixWorkshop;

use pocketmine\command\Command;
use pocketmine\command\CommandSender;
use pocketmine\plugin\PluginBase;

class Main extends PluginBase{
    public function onCommand(CommandSender $sender, Command $command, string $label, array $args): bool{
        if($command->getName() !== "workshop"){
            return false;
        }
        $sender->sendMessage("ModonixWorkshop 0.0.1 is ready.");
        return true;
    }
}

Перезапустите сервер. DevTools позволяет загружать плагины из папок, поэтому plugins покажет и DevTools, и ModonixWorkshop. Выполните workshop; команда ответит ModonixWorkshop 0.0.1 is ready. Так у вас будет простой результат для проверки до сборки.

Разрешение на команду по умолчанию предоставлено операторам. Для первой проверки /workshop в игре используйте аккаунт оператора. Если позднее команда понадобится обычным игрокам, целенаправленно выдайте разрешение modonixworkshop.command.workshop, вместо того чтобы делать всех операторами.

Соберите PHAR из загруженной папки

Когда ModonixWorkshop загружен, введите:

makeplugin ModonixWorkshop

DevTools создаст архив по пути plugin_data/DevTools/ModonixWorkshop_v0.0.1.phar. Сохраните исходную папку ModonixWorkshop как редактируемый проект. PHAR — это копия для установки на другой сервер.

Если makeplugin сообщает о неверном имени плагина, выполните plugins и проверьте, загрузился ли ModonixWorkshop после перезапуска. При ошибке загрузки сначала исправьте первую относящуюся к ней ошибку в консоли, а затем собирайте архив. Если PHP сообщает, что создание PHAR отключено, установите phar.readonly=0 в конфигурации PHP сервера для разработки и перезапустите его.

Установите пакет на отдельный сервер

Чтобы перенести плагин в другую установку, подготовьте отдельный сервер с теми же серверными компонентами и настройками PHP. Пока он остановлен, скопируйте архив в каталог plugins; удобное имя файла — ModonixWorkshop.phar. Имя самого плагина по-прежнему берётся из plugin.yml внутри архива.

Оставьте DevTools и редактируемую исходную папку на первом сервере. Запустите второй сервер и выполните:

plugins
workshop

Второй сервер должен загрузить ModonixWorkshop, а команда — вернуть ModonixWorkshop 0.0.1 is ready. Держите папку и PHAR на разных серверах, чтобы один плагин не загружался дважды. Собранную версию можно проверить и на сервере для разработки: остановите его, вынесите исходную папку из активного каталога плагинов, установите PHAR и перезапустите. Именно эта собранная версия показана на снимке Minecraft выше.

Сохраняйте совместимость клиента и сервера

Выберите серверный API, указанный для выбранного файла в разделе Файлы. Совместимость подключаемого клиента Bedrock с игровым протоколом сервера проверяется отдельно от минимального API плагина.

Исходные репозитории PocketMine-MP и DevTools архивированы. Для изучения или обслуживания этого сервера используйте поддерживаемую конфигурацию, указанную рядом с файлом; новый клиент не сможет подключиться к любому старому серверному протоколу.

Пока нет оценок

Файлы

Фильтр файлов Файлов: 3Стабильная версия
Показать все файлы

Версия 1.17.2

Стабильный

DevTools.phar

ПО сервера: PocketMine-MP
1 скачивание
Скачать · 43,7 KB
Требования и подробности
  • ПО сервера: PocketMine-MP · Версия API сервера: 5.0.0

Остановите сервер для разработки, поместите DevTools.phar в plugins и перезапустите. DevTools 1.17.2 заявляет минимальный PocketMine API 5.0.0. После создания или редактирования исходного плагина перезапустите сервер, прежде чем выполнять makeplugin. Держите редактируемую папку плагина и собранный PHAR в разных активных каталогах плагинов. Для сборки через консоль сервера клиент Minecraft не нужен.

Требования и примечания
Известные проблемы
Loading a source folder and its PHAR together can cause duplicate-plugin errors. Restart after editing source files. PocketMine-MP 5.44.3 targets Bedrock 26.30; match player clients to the server protocol. The example plugin requires API 5.44.3.
Требования к среде сервера
The original PHAR-building walkthrough used PocketMine-MP 5.44.3 with PHP 8.3.29 ZTS on Windows; that server targets Bedrock 26.30. The additional in-game /workshop example uses DevTools 1.17.2 on Axolotl-PM 5.49.1 with PHP 8.3.29 ZTS and Bedrock 26.52 on Windows. DevTools still declares minimum API 5.0.0; the example does not establish support for other server or client versions.

Версия 1.17.0

Стабильный

DevTools.phar

ПО сервера: PocketMine-MP
0 скачиваний
Скачать · 43,4 KB
Требования и подробности
  • ПО сервера: PocketMine-MP · Версия API сервера: 5.0.0
Требования и примечания
Требования к среде сервера
A compatible PocketMine-MP server and its supported PHP runtime.

Версия 1.16.0

Стабильный

DevTools.phar

ПО сервера: PocketMine-MP
0 скачиваний
Скачать · 36,4 KB
Требования и подробности
  • ПО сервера: PocketMine-MP · Версия API сервера: 4.0.0
Требования и примечания
Требования к среде сервера
A compatible PocketMine-MP server and its supported PHP runtime.

Изменения версий

Версия 1.17.2

Стабильный

Дата исходного выпуска: 2025-02-01.

Точный соответствующий исходный код: DevTools 1.17.2: исходный код

Источник: DevTools 1.17.2: примечания к выпуску
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Версия 1.17.0

Стабильный

Дата исходного выпуска: 2023-06-01.

Точный соответствующий исходный код: DevTools 1.17.0: исходный код

Источник: DevTools 1.17.0: примечания к выпуску
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Версия 1.16.0

Стабильный

Дата исходного выпуска: 2022-09-24.

Точный соответствующий исходный код: DevTools 1.16.0: исходный код

Источник: DevTools 1.16.0: примечания к выпуску
Сведения о совместимости ниже отражают заявленные автором целевые версии и устройства. Полную информацию о версиях и устройствах смотрите в источнике по ссылке.

Посмотреть файлы

Комментарии 0

Расскажите, что сработало, попросите помощи или ответьте другому игроку.

Присоединиться к обсуждению

1Ваше имя и почта

Аккаунт не нужен. Подтвердите почту кодом перед первым комментарием. Рядом с именем показывается только частично скрытый адрес. Комментарии гостей проверяются перед публикацией.

2Подтвердить и опубликовать

Комментариев пока нет. Расскажите, что помогло вам.

Поиск по Modonix

Искать в