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

Установленный пример 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 архивированы. Для изучения или обслуживания этого сервера используйте поддерживаемую конфигурацию, указанную рядом с файлом; новый клиент не сможет подключиться к любому старому серверному протоколу.
Комментарии 0
Расскажите, что сработало, попросите помощи или ответьте другому игроку.
Войдите в аккаунт Modonix, чтобы участвовать в обсуждении и управлять своими комментариями.
Войти и комментироватьКомментариев пока нет. Расскажите, что помогло вам.