Перейти к основному содержимому

Настройка ResourcePackManager

Эта страница описывает настройку для одиночного (отдельностоящего) сервера. Если вы держите сеть BungeeCord / Waterfall / Velocity, следуйте Прокси-сети — вы устанавливаете тот же ResourcePackManager.jar на прокси, но он генерирует собственный конфиг и играет роль на стороне прокси.

ResourcePackManager 2.x поставляется как единственный универсальный jar. Ровно тот же ResourcePackManager.jar запускается на бэкендах Bukkit/Paper И на прокси Velocity / BungeeCord / Waterfall — он автоматически определяет платформу по загрузчику, под которым работает. Больше нет отдельных файлов resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar, которые нужно было бы извлекать. (Если RSPM обнаруживает, что этот бэкенд стоит за прокси, который ни разу не выдал ему ключ, он выкладывает копию собственного jar в plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar, чтобы вы скопировали его на прокси — тот же самый файл, просто положенный в удобное место.)

Дескриптор бэкенд-плагина объявляет Bukkit API 1.21.4, поэтому сервер Bukkit/Paper должен быть на Minecraft 1.21.4 или новее. Встроенное расширение Geyser для кастомных сущностей рассчитано на Geyser 2.11+.

Рекомендуемая настройка (отдельностоящая)​

  1. Положите ResourcePackManager.jar в папку plugins/ вашего сервера. (Это тот же jar, который вы бы использовали на прокси Velocity / BungeeCord — отдельных прокси-jar нет.)
  2. Запустите сервер один раз, чтобы сгенерировались папки конфига, миксера, чертежей и выходных файлов.
  3. Определитесь, нужно ли вам:
    • самостоятельный хостинг (по умолчанию включён)
    • резервный бесплатный авто-хостинг MagmaGuy (по умолчанию включён)
    • принудительное принятие клиентом
    • ручные кастомные паки в папке миксера
  4. Выполните /rspm reload после изменения конфига или после ручного добавления кастомных паков.

Это всё для счастливого пути. С настройками по умолчанию RSPM сначала попробует self-host и автоматически откатится на CDN MagmaGuy, если что-то выглядит не так.

Вы поймёте, что всё сработало, по одной строке в консоли:

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

RSPM намеренно держит консоль тихой — он сообщает результат, а не каждый шаг, и не предупреждает об условиях, из которых восстанавливается сам (неудачная проверка self-host с последующим успешным откатом — это успех, а не сбой). Если что-то нужно продиагностировать, выполните /rspm verbose on (или задайте verboseLogging: true в config.yml) и перезагрузите. См. Устранение неполадок.

Папки, которые создаёт RSPM​

Внутри plugins/ResourcePackManager/:

ПапкаДля чего она
mixer/Кладите сюда готовые .zip-паки, чтобы они попали в объединение. Ссылайтесь на них в priorityOrder по точному имени файла, включая .zip.
resource_pack/Кладите сюда распакованный пак (дерево папок с assets/, pack.mcmeta, ...). RSPM запакует его и объединит под записью приоритета ResourcePackManager, которая стоит наверху дефолтного priorityOrder.
blueprint/Содержит дефолтные pack.png и pack.mcmeta, которые RSPM вносит в объединение. Отредактируйте их, чтобы изменить иконку собранного пака или описание в его pack.mcmeta; папка перепаковывается в blueprint.zip при каждом запуске.
output/Готовые артефакты: ResourcePackManager_RSP.zip, а также ResourcePackManager_Bedrock.zip и rspm_geyser_mappings.json, когда их произвело преобразование в Bedrock.
compatible_plugins/По одному YAML на каждую поддерживаемую интеграцию с плагином.
data_compliance/Куда /rspm data_compliance_request записывает свою загрузку.
proxy-extension/Появляется только на бэкенде, который стоит за прокси, ни разу не выдавшим ему ключ. Содержит копию работающего ResourcePackManager.jar для установки на прокси.
geyser-extension/Появляется только когда Floodgate локальный, а Geyser — внешний процесс. Содержит копию jar для папки extensions/ того Geyser.

Основные команды​

  • /rspm setup — открывает игровое GUI-меню настройки (статус обновления плагина, рекомендуемые плагины, переключатель автоматических обновлений и кнопку с информацией и кликабельными ссылками на вики, Discord и токен вашего аккаунта Nightbreak)
  • /rspm recommendedplugins — показывает общее меню рекомендуемых плагинов Nightbreak
  • /rspm downloadpluginupdate — скачивает доступное обновление ResourcePackManager к следующему перезапуску
  • /rspm downloadall — скачивает все доступные обновления, которые предоставляет этот плагин (сейчас это обновление ResourcePackManager)
  • /rspm reload — пересобирает и пере-хостит собранный пак
  • /rspm status — печатает полный диагностический дамп: состояние пака, режим хостинга, отпечаток сетевого ключа, интеграции
  • /rspm verbose [on|off] — включает или выключает подробное диагностическое логирование, не открывая config.yml. Без аргумента переключает. Выбор записывается обратно в verboseLogging в config.yml, поэтому переживает перезапуски. Псевдоним — /rspm verboselogging.
  • /rspm itemsadder configure — автоматически настраивает ItemsAdder для хостинга через RSPM (см. ниже)
  • /rspm itemsadder dismiss — навсегда отключает предупреждение ItemsAdder для UUID вашего игрока
  • /rspm data_compliance_request — загружает все удалённо хранящиеся данные этого сервера

Корневая команда — /resourcepackmanager, с псевдонимом /rspm. Команды обновления и рекомендуемых плагинов выше — это общие команды MagmaCore/Nightbreak, регистрируемые RSPM.

Права:

  • /rspm setup и /rspm recommendedplugins требуют resourcepackmanager.setup. /rspm setup доступна только игрокам, потому что открывает GUI инвентаря.
  • /rspm downloadpluginupdate, /rspm downloadall, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> и /rspm data_compliance_request требуют resourcepackmanager.*.

ItemsAdder​

Текущий предпочтительный путь для ItemsAdder больше не является исключительно ручным.

Используйте:

/rspm itemsadder configure

Этот помощник обновляет соответствующие настройки ItemsAdder, перегенерирует пак ItemsAdder, затем перезагружает ResourcePackManager. Конкретно он:

  • устанавливает resource-pack.hosting.no-host.enabled: true
  • отключает protection_1, protection_2 и protection_3 в resource-pack.zip.protect-file-from-unzip
  • устанавливает resource-pack.zip.compress-json-files: false (RSPM нужен несжатый, поддающийся разбору модельный JSON для миксера и Bedrock-конвертера)
  • запускает /iareload, затем /iazip
  • перезагружает ResourcePackManager примерно через 15 секунд, после того как у ItemsAdder было время перезагрузиться и перегенерировать

Если ItemsAdder уже настроен на размещение собственного пака (self-host, external-host или lobfile), помощник останавливается и сообщает, что сначала нужно вручную отключить хостинг в ItemsAdder.

Поддержка Bedrock / GeyserMC​

RSPM автоматически преобразует собранный Java-пак в Bedrock-пак для GeyserMC. Преобразование обрабатывает любой пак плагина в формате определений предметов 1.21.4+ — не только FreeMinecraftModels — включая 3D-предметы в руке, кастомную броню и моделируемое снаряжение.

bedrockConversionEnabled по умолчанию true, поэтому свежая установка на сервере с GeyserMC заработает «из коробки».

Для отдельностоящего сервера преобразование запускается, когда выполняется любое из: Geyser-Spigot установлен на этом сервере, Floodgate установлен на этом сервере, или RSPM обнаружил режим прокси (см. Прокси-сети).

Если Geyser-Spigot установлен на этом сервере, RSPM также устанавливает себя в plugins/Geyser-Spigot/extensions/ как расширение Geyser — именно это заставляет кастомные Bedrock-сущности отображаться вместо стоек для брони. Это тот же ResourcePackManager.jar — ничего дополнительно скачивать не нужно, — но для вступления в силу требуется один перезапуск сервера. Задайте geyserExtensionAutoInstall: false в config.yml, чтобы RSPM перестал устанавливать и подготавливать это расширение. См. Расширение Geyser и кастомные сущности.

См. Преобразование в Bedrock / Geyser для полного конвейера, путей вывода и настройки смещений отображения.

Проверка настройки​

Запустите /rspm status в консоли или от имени op. Вывод разделён на секции:

  • Plugin meta — версия + режим развёртывания (standalone vs network-backend). На сетевом бэкенде также печатается короткий несекретный отпечаток сетевого ключа и источник этого ключа (provided by the proxy / saved on this server / adopted from Floodgate's key / not set yet).
  • Java Pack — собран да/нет, размер, префикс SHA1
  • Bedrock Pack — преобразован да/нет, маппинги присутствуют, с диагностическими подсказками, если преобразование было пропущено
  • Hosting — какой путь доставки активен (self-hosted / remote / ещё не готов), URL, который увидят клиенты, разрешённый внешний хост, авто-определённый публичный IP
  • Proxy deployment — напоминание о том, что сетевой прокси-jar — это тот же ResourcePackManager.jar; в сети скопируйте его в папку plugins/ прокси
  • Integrations — определение Floodgate / Geyser-Spigot, число игроков онлайн

Если что-то выглядит не так, см. Устранение неполадок.

Куда идти дальше​