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

Настройка ResourcePackManager

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

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

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

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

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

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

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

Корневая команда — /resourcepackmanager, с псевдонимом /rspm. RSPM также наследует несколько общих подкоманд MagmaCore/Nightbreak (например, /rspm recommendedplugins, /rspm downloadall), на которые ссылается меню настройки.

Права:

  • /rspm setup требует resourcepackmanager.setup и доступна только игрокам (она открывает GUI инвентаря, поэтому не может быть запущена из консоли).
  • /rspm reload, /rspm status, /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 обнаружил режим прокси (см. Прокси-сети).

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

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

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

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

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

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