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

Настройка ResourcePackManager

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

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

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

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

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

  • /rspm setup — печатает одну строчку с указанием редактировать файлы конфига напрямую (графического интерфейса нет)
  • /rspm reload — пересобирает и пере-хостит собранный пак
  • /rspm status — печатает полный диагностический дамп: состояние пака, режим хостинга, сетевой ключ, интеграции
  • /rspm itemsadder configure — автоматически настраивает ItemsAdder для хостинга через RSPM (см. ниже)
  • /rspm itemsadder dismiss — навсегда отключает предупреждение ItemsAdder для UUID вашего игрока
  • /rspm data_compliance_request — загружает все удалённо хранящиеся данные этого сервера

Корневая команда — /resourcepackmanager, с псевдонимом /rspm.

Права:

  • /rspm setup требует resourcepackmanager.setup и доступна только игрокам (просто печатает одну строчку, указывающую на файлы конфига).
  • /rspm reload, /rspm status, /rspm itemsadder <configure|dismiss> и /rspm data_compliance_request все требуют resourcepackmanager.*.

ItemsAdder​

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

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

/rspm itemsadder configure

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

  • устанавливает resource-pack.hosting.no-host.enabled: true
  • отключает protection_1, protection_2 и protection_3 в resource-pack.zip.protect-file-from-unzip
  • запускает /iazip
  • перезагружает ResourcePackManager после паузы в 5 секунд

Если 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 обнаружил режим прокси (см. Прокси-сети).

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

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

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

  • Plugin meta — версия + режим развёртывания (standalone vs network-backend)
  • Java Pack — собран да/нет, размер, префикс SHA1
  • Bedrock Pack — преобразован да/нет, маппинги присутствуют, с диагностическими подсказками, если преобразование было пропущено
  • Hosting — какой путь доставки активен (self-hosted / remote / ещё не готов), URL, который увидят клиенты, разрешённый внешний хост, авто-определённый публичный IP
  • Proxy extension jars — пути к встроенным jar-файлам Velocity/Bungee (извлекаются даже на отдельностоящих серверах — удобно, если вы когда-нибудь добавите прокси)
  • Integrations — определение Floodgate / Geyser-Spigot, число игроков онлайн

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

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