Bisquit Wiki

Appearance

Как установить ресурспак на сервер ​

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

Что вам понадобится ​

  • Файл ресурспака: В формате .zip. Убедитесь, что он совместим с версией вашего сервера
  • Место для хостинга ресурспака: Нужен прямой URL-адрес для скачивания ресурспака (например, Dropbox, Google Drive, собственный веб-сервер, Discord CDN, GitHub)

1. Подготовка ресурспака ​

Убедитесь, что ваш ресурспак в формате .zip и готов к использованию. Проверьте его структуру (обычно папка assets и файл pack.mcmeta находятся в корне архива)

2. Загрузка ресурспака на хостинг ​

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

  1. Выберите хостинг для ресурспака:

    • Dropbox, Google Drive: Убедитесь, что вы получаете прямую ссылку на скачивание, а не на страницу предпросмотра.
      • Для Dropbox: измените dl=0 на dl=1 в конце ссылки
      • Для Google Drive: ссылка должна быть вида https://drive.google.com/uc?export=download&id=ВАШ_ID_ФАЙЛА. Проще всего использовать генераторы прямых ссылок для этих сервисов
    • Discord: Можно загрузить файл в любой свой канал, скопировать ссылку на него, а затем заменить cdn.discordapp.com на media.discordapp.net для прямой ссылки (на момент написания статьи это работало, но может измениться)
    • GitHub:
      1. Создайте публичный репозиторий на GitHub (или используйте существующий)
      2. Загрузите .zip файл вашего ресурспака в репозиторий
      3. Перейдите к файлу в репозитории на GitHub
      4. Нажмите кнопку "Download" или "Raw". Это даст вам ссылку, начинающуюся с raw.githubusercontent.com. Это и есть ваша прямая ссылка Пример прямой ссылки с GitHub: https://raw.githubusercontent.com/ВАШ_ЮЗЕРНЕЙМ/ВАШ_РЕПОЗИТОРИЙ/ИМЯ_ВЕТКИ (обычно main или master)/путь/к/файлу/ваш_ресурспак.zip

      Примечание по GitHub

      GitHub не является специализированным CDN для больших файлов, и хотя он хорошо работает для ресурспаков умеренного размера, для очень больших файлов или очень популярного сервера могут быть ограничения. Учитывайте это

    • Собственный веб-сервер или файловый хостинг: Наиболее надежный вариант, особенно для больших файлов и высокой посещаемости.

  2. Загрузите .zip файл вашего ресурспака выбранным способом

  3. Получите прямую ссылку на скачивание. Она должна заканчиваться на .zip. Проверьте ее, вставив в браузер – должна начаться загрузка файла

3. (Опционально, но рекомендуется) Получение SHA-1 хеша ресурспака ​

Minecraft использует SHA-1 хеш файла ресурспака для проверки его целостности и для кеширования. Если хеш указан, клиенты не будут повторно скачивать тот же самый ресурспак, если он не изменился

Вы можете получить SHA-1 хеш с помощью:

  • Онлайн-генераторов SHA-1: Найдите в Google "sha1 online generator" и загрузите ваш .zip файл
  • Командной строки:
    • Windows (PowerShell): Get-FileHash ваш_файл.zip -Algorithm SHA1 | Format-List (скопируйте значение Hash)
    • Linux/macOS: sha1sum ваш_файл.zip (скопируйте первую часть вывода)

Сохраните полученный хеш (в нижнем регистре), он понадобится на следующем шаге

Обновление ресурспака с хешем

Если вы обновили файл ресурспака на хостинге, обязательно пересчитайте и обновите SHA-1 хеш в server.properties. Иначе клиенты со старым хешем не скачают новую версию

4. Настройка server.properties ​

  1. Откройте файл server.properties, который находится в корневой директории вашего сервера

  2. Найдите или добавьте следующие строки:

    properties
    resource-pack=ССЫЛКА_НА_ВАШ_РЕСУРСПАК.zip
resource-pack-sha1=ВАШ_SHA1_ХЕШ
# resource-pack-prompt=Сообщение, которое увидит игрок (опционально, используйте \n для переноса строки)
# require-resource-pack=false

  3. Замените:

    • ССЫЛКА_НА_ВАШ_РЕСУРСПАК.zip на прямую ссылку, полученную на 2-ом Этапе
    • ВАШ_SHA1_ХЕШ на хеш, полученный на Шаге 3 (если вы его генерировали). Если нет, оставьте это поле пустым или удалите строку resource-pack-sha1. Хеш должен быть в нижнем регистре
    • resource-pack-prompt (опционально): Можно добавить кастомное сообщение, которое будет показано игроку перед загрузкой ресурспака. Сообщение должно быть в формате JSON (можно экранировать символы, если это одна строка, или использовать многострочный формат, если ваш сервер это поддерживает). Например: resource-pack-prompt={"text":"Сервер рекомендует использовать специальный ресурспак!\\nЗагрузить?","color":"gold"}. Вы можете использовать генераторы JSON текста.
    • require-resource-pack:
      • false (по умолчанию): Игрок может отказаться от загрузки
      • true: Игрок должен принять ресурспак для входа на сервер. Если он откажется или загрузка не удастся, его не пустит на сервер

ОСТОРОЖНО с require-resource-pack=true

Используйте require-resource-pack=true с осторожностью. Если ресурспак большой или у игрока медленный интернет, это может помешать ему войти на сервер. Также, если ссылка на ресурспак по какой-то причине станет недействительной, никто не сможет зайти на сервер

Размер ресурспака

Стандартный Minecraft сервер (Vanilla) имеет ограничение на размер ресурспака, который он может предложить (около 50MB (1.7.10–1.15.2), затем увеличено до 100MB (1.16–1.17.1), а на новейших версиях до 250MB (1.18+)). Учитывайте это при выборе ресурспака и хостинга для него

5. Перезагрузка сервера ​

Сохраните изменения в server.properties и перезапустите ваш Minecraft сервер, чтобы изменения вступили в силу

6. Тестирование ​

  1. Запустите ваш Minecraft клиент
  2. Убедитесь, что в настройках "Сетевая игра" -> [Ваш сервер] (кнопка "Редактировать") -> "Наборы ресурсов сервера" установлено значение "Включено" или "Запрашивать". По умолчанию "Включено"
  3. Подключитесь к вашему серверу. Вы должны увидеть запрос на загрузку ресурспака (или сообщение из resource-pack-prompt)
  4. Примите его и дождитесь загрузки. Ресурспак должен примениться

Устранение неполадок ​

  • Ресурспак не предлагается:
    • Проверьте правильность URL в server.properties. Убедитесь, что это прямая ссылка, которая при вставке в браузер сразу начинает скачивание .zip файла
    • Проверьте, что сервер перезагружен после изменений
    • Убедитесь, что у игрока включена опция "Наборы ресурсов сервера" в настройках клиента
    • Проверьте консоль сервера на наличие ошибок, связанных с ресурспаком (например, "Failed to parse resource pack prompt JSON", "Resource pack SHA-1 hash mismatch", "Resource pack link is not a valid URL", "Resource pack URL is not valid HTTP or HTTPS")
  • Ресурспак скачивается, но не применяется:
    • Убедитесь, что ресурспак совместим с версией Minecraft вашего клиента и сервера
    • Проверьте структуру .zip файла ресурспака (должен быть файл pack.mcmeta и папка assets в корне архива)
  • SHA-1 хеш вызывает проблемы: Если вы указали SHA-1 и ресурспак не загружается, попробуйте временно убрать строку resource-pack-sha1 или оставить значение пустым для диагностики. Возможно, хеш был вычислен неверно, файл изменился после вычисления или он указан не в нижнем регистре
  • Ошибка Failed to download resource pack, server resource pack URI is not valid: Чаще всего это означает, что ссылка в resource-pack некорректна, ведет не на прямой .zip файл. Некоторые сервисы (например, стандартный интерфейс GitHub, Google Drive без правильной ссылки) могут возвращать HTML-страницу вместо файла