Плагин DatapackLoader 1.4.1 +1.3.0

DatapackLoader — серверный плагин, который автоматически добавляет датапаки в Minecraft. Он упрощает установку готовых наборов данных и ускоряет разработку, когда пакет приходится часто заменять или проверять. Категории проекта — utility и worldgen.

Плагин требуется только серверу: server=required, client=unsupported. Автор в подтверждённых метаданных — lichenaut. Лицензия — MIT, канонический идентификатор SPDX — MIT. При локализации и распространении следует сохранять название, авторство и лицензию, не приписывая автору редакционные выводы.

Назначение и способы добавления​

DatapackLoader не является датапаком и не меняет содержимое архивов. Он организует их добавление на сервер. Официально описаны три метода:

• импорт .zip через консольную команду /dl import;
• ручное перемещение файла в папку datapacks плагина;
• включение starter-datapack в config.yml.

Импорт подходит для готового архива из доверенного источника, ручное размещение — для локальной разработки. Ни один метод не исправляет неверную структуру пакета и не конвертирует его между версиями Minecraft.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

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

Практические сценарии:

• частая замена тестовых сборок;
• импорт готового .zip через консоль;
• хранение рабочих пакетов в отдельной папке;
• подготовка worldgen-датапака до создания новых территорий;
• проверка пакета на нескольких серверных сборках.

Если датапак устанавливается один раз, выгода может быть небольшой. DatapackLoader не обещает совместимость стороннего содержимого с конкретным ядром: отдельно проверяются плагин и каждый пакет.

Совместимость и стороны установки​

Подтверждены Paper, Purpur и Spigot. В перечень версий Minecraft входят 1.14–1.14.4, 1.15–1.15.2, 1.16–1.16.5, 1.17–1.17.1, 1.18–1.18.2, 1.19–1.19.4, 1.20–1.20.6 и 1.21. Более поздние выпуски ветки 1.21 не подтверждены.

В официальном тексте отдельно заявлена поддержка Folia, но плагин не делает несовместимые с Folia датапаки совместимыми. Запуск DatapackLoader на этой платформе поэтому не доказывает работоспособность конкретного пакета.

Клиентский JAR не нужен. В выбранных метаданных обязательные project dependencies не указаны, однако у импортируемого датапака могут быть собственные условия.

Установка плагина​

• Остановить совместимый сервер.
• Создать резервную копию мира, plugins и текущих датапаков.
• Выбрать нужную версию DatapackLoader.jar.
• Поместить один JAR в папку plugins.
• Запустить сервер и проверить журнал.
• Убедиться, что появились рабочие данные плагина.
• Добавить один тестовый датапак официальным способом.

Не следует оставлять несколько версий DatapackLoader в plugins. Первый запуск разумно проводить на копии сервера, особенно с пакетами, меняющими генерацию, функции или глобальные данные.

Команды и разрешения​

Официальный перечень включает:

• /dl — доступ к командам; datapackloader.command;
• /dl help — справка; datapackloader.command.help;
• /dl import — импорт из адреса на .zip, только из консоли;
• /dltp — телепортация к точке появления указанного мира в режиме наблюдателя; datapackloader.command.tp.

Неуказанные параметры здесь не предполагаются. Для импорта следует использовать доверенный источник: механизм загрузки не подтверждает качество или корректность архива.

Проверка результата​

Успешная загрузка JAR не означает, что датапак применён правильно. Проверку проводят последовательно:

• убедиться, что плагин загружен без ошибки;
• проверить создание ожидаемой папки;
• подключить один совместимый тестовый пакет;
• просмотреть журнал на ошибки формата и версии;
• проверить конкретную функцию датапака;
• перезапустить сервер и повторить тест;
• для worldgen-пакета исследовать новые чанки.

Существующие территории не подходят для оценки новой генерации. Отсутствие ошибок в консоли тоже не гарантирует работу всех функций, поэтому нужен тест по назначению пакета.

Файлы и контроль целостности​

Предоставлены две сборки:

• версия 1.4.1 — DatapackLoader.jar, 6 150 624 байта; SHA-1 4565a5c1cea733b7de778ef4688ce23702015659; SHA-512 6ad5c8c47658ae4db84e6f9d7afbabb8b8010877a88fded7f751823858e53765bf0f96449528bbe9691a256d25558947624d345974e76e592ae035af91d1ec16;
• версия 1.3.0 — DatapackLoader.jar, 387 478 байт; SHA-1 feec199e6aa5a6b43a89e9e534052243931df061; SHA-512 5b20567e574624bb2e01f94007c37baaad6fc3715f47460c6c088ab1da83c0207e949c8dbb586f62d199195745854c09963c72902ad63cb7973c6a570241e180.

Разница размеров сама по себе ничего не доказывает; сверять нужно версию, размер и хеш. Файлы получены по официальному HTTPS, локально сопоставлены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся, поэтому реальное серверное поведение не подтверждено.

Ограничения и риски​

DatapackLoader упрощает доставку, но не отвечает за внутреннюю логику пакета. Ошибочный датапак способен конфликтовать с другим содержимым, вызывать сбои, нагрузку или менять уже сгенерированные данные.

Основные ограничения:

• совместимость плагина не равна совместимости датапака;
• поддержка Folia не переносится автоматически на пакет;
• архив должен иметь корректную структуру;
• удаление пакета не обязано отменять изменения мира;
• зависимости плагина не указаны, но они могут быть у датапака;
• клиентская установка JAR не предусмотрена.

Worldgen-датапаки следует особенно осторожно менять в действующем мире: старые и новые чанки могут формироваться по разным правилам.

Безопасное обновление и откат​

Перед обновлением фиксируют рабочую версию сервера, JAR и набор пакетов, затем копируют миры и данные плагина. Новый файл сверяют по размеру и хешу, старый сохраняют вне plugins.

Порядок обновления:

• Остановить сервер.
• Скопировать миры, данные плагина и датапаки.
• Удалить старый JAR из рабочей папки.
• Поместить одну новую версию.
• Запустить сервер и изучить журнал.
• Проверить импорт и загрузку тестового пакета.
• После проверки вернуть обычную нагрузку.

Для отката возвращают прежний JAR и совместимую копию данных. Если обновлялся датапак или создавались новые чанки, одного возврата плагина может быть недостаточно; тогда используют резервную копию мира.

Диагностика​

Сначала отделяют ошибку DatapackLoader от ошибки пакета. Проверяют расположение JAR, хеш, версию ядра и раннюю часть журнала, затем воспроизводят сбой с одним тестовым архивом.

Полезный порядок:

• убрать сторонние плагины и лишние пакеты на копии сервера;
• проверить структуру .zip;
• сопоставить версию датапака с Minecraft;
• повторить загрузку после полного перезапуска;
• на Folia отдельно подтвердить совместимость пакета;
• сравнить результат с ранее работавшей связкой;
• при регрессии выполнить подготовленный откат.

FAQ​

Нужна ли установка игрокам?​

Нет. DatapackLoader обязателен на сервере и не поддерживается как клиентский компонент.

Можно ли добавить датапак без ручного копирования?​

Да. Официально предусмотрен консольный импорт через /dl import для .zip. Также доступно ручное размещение в папке datapacks.

Делает ли плагин любой датапак совместимым с Folia?​

Нет. Поддержка Folia относится к DatapackLoader, но проект исключает автоматическое исправление несовместимых пакетов.

Есть ли обязательные зависимости?​

В выбранных метаданных обязательные project dependencies не указаны. У датапаков могут быть отдельные требования.

Можно ли удалить плагин без последствий?​

Удаление JAR не отменяет автоматически изменения, внесённые датапаками. Для безопасного возврата нужна резервная копия, особенно при изменениях генерации.

Какая лицензия используется?​

Проект распространяется по MIT. Следует сохранять название DatapackLoader, авторство lichenaut и сведения о лицензии.