PaperResources

PaperResources - это нишевый, но очень полезный плагин для серверов на Paper и Purpur, который решает одну из самых раздражающих проблем администрирования: как заставить игроков загрузить сразу несколько ресурспаков, не собирая их в один гигантский архив вручную.

Если вы когда-нибудь пытались совместить на сервере, скажем, кастомные модели оружия, уникальные звуки и текстурпак для интерфейса, то знаете эту боль. Раньше приходилось скачивать все нужные пакеты, вручную распаковывать, разбираться в конфликтах файлов pack.mcmeta и assets, а потом молиться, чтобы ничего не сломалось. С выходом обновлений Minecraft 1.20.3 и новее разработчики из Mojang добавили нативную поддержку загрузки нескольких серверных ресурспаков. Именно эту фишку и использует PaperResources, позволяя клиенту игры самому разруливать слияние контента.

Как это работает и зачем нужно

Вместо того чтобы склеивать zip-архивы на стороне сервера, плагин просто отправляет игроку при входе список ссылок на отдельные ресурспаки. Клиент Minecraft получает их по очереди и самостоятельно объединяет в правильном порядке. Это значит, что вы можете спокойно обновлять один пакет, не трогая остальные, и не пересобирать монолитный файл каждый раз, когда захотели поменять одну текстуру.

Плагин поддерживает версии Minecraft Java Edition 1.20.3 - 1.20.6 и всю линейку 1.21.x. Отдельно отмечена совместимость с Paper 26.1, так что на актуальных сборках сервера всё работает стабильно. Если вы держите сервер на более старых версиях, увы, придётся искать альтернативы или обновляться.

Установка и настройка

Настройка предельно проста, но есть один важный нюанс, о котором часто забывают. После первого запуска плагина в папке /plugins/PaperResources/ появится файл resources.txt. В него вы построчно вписываете прямые ссылки на zip-архивы ваших ресурспаков. Каждая строка - отдельный пакет. Порядок имеет значение: пакеты, указанные ниже по списку, будут перекрывать те, что выше, если в них есть одинаковые файлы.

Чтобы изменения вступили в силу, не нужно перезагружать сервер. Достаточно выполнить команду:

/paperresources reload

Важный совет из практики: в файле server.properties параметр resource-pack должен оставаться пустым. Если вы впишете туда ссылку, как делали раньше, клиент может запутаться и попытаться загрузить и старый пакет, и новые от PaperResources, что приведёт к конфликтам или багам отображения.

Для разработчиков

С версии 2.0.0 в плагине появился полноценный API, доступный через класс PaperResourcesManager. Теперь другие плагины могут программно добавлять, удалять или просматривать список активных ресурспаков на лету, не трогая конфигурационные файлы. Это открывает возможности для создания сложных систем, где, например, разные миры или игровые режимы на одном сервере используют разные наборы текстур. JavaDocs поставляются вместе с каждым релизом, так что разобраться в методах не составит труда.

Практические замечания

В последней версии 2.0.1 разработчики исправили важный момент с порядком загрузки: теперь плагин инициализируется раньше, до загрузки мира. Это устраняет редкие баги, когда игроки с очень быстрым подключением могли проскочить момент отправки пакетов.

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

Для игры с друзьями на собственном сервере это тоже находка. Вы можете разделить ответственность: один человек отвечает за модели, другой за звуки, и каждый просто кидает ссылку на свой архив, не мешая остальным. А если вы используете хостинг вроде BungeeHost, установка плагина сводится к паре кликов в панели управления, и вы сразу можете начинать добавлять свои ресурспаки через веб-интерфейс или FTP.

В общем, если устали от ручного слияния ресурспаков и хотите использовать современные возможности Minecraft по максимуму, PaperResources - must-have инструмент в арсенале администратора.