ResourcePackManager

ResourcePackManager — плагин для объединения и хостинга паков ресурсов

ResourcePackManager решает проблему ручного управления паками ресурсов (resource packs) на серверах Minecraft. Плагин автоматически собирает паки от совместимых аддонов, объединяет их в один файл с соблюдением приоритетов, размещает на сервере или передаёт на удалённый хостинг, а затем автоматически отправляет итоговый пакет всем подключившимся игрокам. Для сетей с использованием GeyserMC плагин также конвертирует объединённый Java-пак в формат, понятный Bedrock-клиентам.

Принцип работы и основные возможности

Плагин автоматизирует процесс управления паками ресурсов, избавляя администраторов от необходимости вручную скачивать, объединять и пересчитывать хеш-суммы (SHA1) для каждого аддона. Он находит паки от совместимых плагинов (automerge-compatible), объединяет их согласно настройкам приоритета в конфигурационном файле и размещает итоговый результат на сервере. Игроки получают готовый пакет автоматически при подключении.

Ключевые возможности:

• Автоматическое объединение: Плагин собирает все паки ресурсов с сервера в единый файл.
• Прямой хостинг: По умолчанию паки размещаются на самом сервере. Если сервер не имеет доступа к интернету или порты закрыты, плагин автоматически переключается на бесплатный удалённый хостинг через серверы Nightbreak.
• Автоматическая доставка: Игрокам не нужно ничего настраивать — пакет загружается при входе в игру.
• Поддержка Bedrock: Встроенная конвертация объединённого Java-пакета в формат, совместимый с GeyserMC. Это позволяет Java- и Bedrock-игрокам видеть одинаковые кастомные модели и предметы.
• Поддержка прокси-сетей: Работает с Velocity, BungeeCord и Waterfall. Для сетей с GeyserMC плагин объединяет паки со всех серверов в один пакет, так как клиенты Bedrock принимают только один пакет на сетевое соединение.
• Ручное добавление: Администратор может вручную добавить дополнительные паки в специальную папку mixer на сервере.
• Минимальная настройка: Плагин работает по умолчанию с рекомендованными настройками. Дополнительная конфигурация требуется только при желании изменить приоритеты или режим хостинга.

Поддержка сетей Bedrock и GeyserMC

Для серверов, использующих GeyserMC, плагин автоматически конвертирует объединённый Java-пак ресурсов в формат, понятный клиентам Bedrock. Это обеспечивает визуальную целостность кастомного контента для всех игроков, независимо от платформы.

В сетях с использованием прокси (Velocity, BungeeCord, Waterfall) возникает ограничение: клиенты Bedrock могут принимать только один пакет ресурсов на всё сетевое соединение. ResourcePackManager решает эту проблему, объединяя паки со всех бэкенд-серверов в один единый файл, который затем отправляется Bedrock-клиентам при их подключении. Java-игроки при переключении между серверами получают пакеты напрямую от каждого бэкенда.

Настройка для прокси-сетей:

• Установите ResourcePackManager.jar как на прокси-сервер, так и на все бэкенд-серверы (используется один и тот же файл).
• После установки выполните двойную перезагрузку прокси-сервера, чтобы корректно сохранить маппинги для GeyserMC.

Рекомендуемые плагины и совместимость

Плагин разработан для работы с широким спектром аддонов, но для полной поддержки кастомных моделей и предметов рекомендуется использовать экосистему от разработчика MagmaGuy:

• FreeMinecraftModels — основной плагин для кастомных моделей.
• EliteMobs — плагин для кастомных боссов.
• EternalTD — плагин для мини-игр.

Также плагин поддерживает работу с рядом других популярных аддонов, таких как BetterHUD, ItemsAdder, MMOInventory, ModelEngine, Nova, Oraxen, ValhallaMMO, BackpackPlus, RealisticSurvival и Vane-Core. Некоторые из них требуют дополнительных действий (например, отключения шифрования или запуска команды /valhalla resourcepack download), чтобы плагин мог корректно извлечь их ресурсы.

Команды управления

Для управления работой плагина доступны следующие команды:

• /resourcepackmanager reload — перезагружает плагин без остановки сервера.
• /resourcepackmanager status — отображает текущий статус работы ResourcePackManager.
• /resourcepackmanager data_compliance_request — загружает все размещённые данные на удалённом хостинге для проверки администратором. Эта команда формирует архив с полным списком файлов и метаданных, связанных с сервером.

Режимы хостинга и политика конфиденциальности

ResourcePackManager по умолчанию пытается разместить паки ресурсов непосредственно на сервере. Это требует открытого доступа к портам сервера извне. Если это невозможно или администратор предпочитает не использовать серверные ресурсы, плагин автоматически переключается на удалённый хостинг.

Удалённый хостинг предоставляется бесплатно через серверы студии Nightbreak. Данные передаются анонимно: серверу присваивается случайный UUID, который используется для идентификации файлов. Никакие IP-адреса или идентифицирующая информация не сохраняются, если администратор не добавит её вручную в паки ресурсов.

Политика обработки данных:

• Псевдоанонимность: Nightbreak использует случайный UUID для каждого запуска сервера.
• Отсутствие логов: Не ведутся логи запросов на скачивание клиентами Minecraft.
• Отсутствие продаж: Данные никогда не продаются.
• Срок хранения: Все данные удаляются автоматически через 24 часа после остановки сервера. При каждом запуске сервера данные загружаются заново.
• Согласие с Takedown: Nightbreak выполняет запросы на удаление контента от администраторов серверов и правоохранительных органов.

Администраторы могут запросить полную копию данных своего сервера через команду /resourcepackmanager data_compliance_request или связаться с разработчиком для удаления данных.

Ограничения и совместимость

Плагин объединяет паки ресурсов там, где это технически возможно, но не может исправить фундаментальные конфликты между ними. К таким конфликтам относятся проблемы с кодировкой символов в интерфейсах (GUI unicode spacing) или дублирование ID моделей предметов. В случае конфликтов плагин выбирает ресурсы из пака с более высоким приоритетом, указанным в конфигурации.

Лицензия и контакты

Плагин распространяется под лицензией LGPL-3.0-only. Для получения поддержки или обсуждения добавления новых плагинов в список совместимых можно обратиться на официальный Discord-сервер разработчика.

Автор: MagmaGuy · Лицензия: LGPL-3.0-only