Gold  Plugin Utility ForceResourcepacks [1.12.19]

Описание плагина ForceResourcepacks:​

Хотелось ли вам когда-нибудь заставить игроков использовать определенный серверный ресурспак на одном из ваших серверов? Может быть, для мини-игры в рамках вашей сети? А может быть, вы не хотите навязывать этот пакет пользователям, а просто хотите проинформировать тех, кто его не принял, о том, что они теряют? Тогда это тот плагин, который вы всегда искали!
Force Resourcepacks - это расширенная версия моих плагинов Bungee Resourcepacks и World Resourcepacks. Помимо того, что вы можете устанавливать различные ресурспаки для каждого мира, сервера или всей вашей прокси-сети (при установке в папку плагинов Bungee или Velocity), вы также можете реагировать на то, принял ли пользователь загрузку пакета, и посылать ему сообщение или даже кикать его, если он этого не сделал!

Он даже замечает, когда Bukkit-сервер за прокси отправляет ресурспак, и применяет к нему правила статуса пака сервера! Таким образом, он совместим с плагинами для мини-игр, которые управляют своими собственными ресурспаками на сервере, и при этом предоставляет возможность выгнать пользователя с сервера игры, если он не скачал пакет!

• Тестовый сервер: test.phoenix616.dev
• Трекер проблем и репо: GitLab
• Команды, разрешения и многое другое: Documention Tab
• IRC-канал: #forceresourcepacks на irc.esper.net
• Канал Discord: Join the Phoenix616's stuff Discord Server!
• Присоединение по этому приглашению автоматически подписывает вас на уведомления об обновлениях, если вы не хотите этого, используйте этот.

Особенности плагина ForceResourcepacks:​

• Кикайте игроков или не позволяйте им присоединяться к серверам/мирам, если они не принимают пакет!
• Отображение пользовательского сообщения на экране запроса для клиентов старше 1.17 и использующих функцию required-pack.
• Устанавливать различные серверные ресурспаки для каждого мира, сервера или всей сети BungeeCord/Velocity.
• Сопоставлять имена серверов/миров с помощью regex!
• Пакеты для каждой версии! Отправлять правильный пакет в зависимости от версии клиента и "кикать" игрока, если он использует версию без доступного пакета (требуется ViaVersion или ProtocolSupport при использовании на сервере Spigot, а не Bungee или Velocity!)
• Автоматическое исключение игроков с Geyser/Floodgate (не работает с Geyser standalone без Floodgate)
• Автоматически генерирует хэши sha1!
• Установка паков с помощью флагов WorldGuard (требуется WorldGuard выше версии 6.1.3)
• Переопределение пакетов текстур xray (например, с помощью такого пакета, пожалуйста, обратите внимание, что это не на 100% надежно и может быть обойдено с помощью модов)
• Языковая система с сообщениями в зависимости от локали клиента
• Расширенная поддержка форматирования MineDown для сообщений о нажатии и наведении курсора
• Настраиваемая задержка перед отправкой пака игроку
• Информировать пользователя о том, какой пакет ему отправил сервер, если это было сделано автоматически
• Позволять пользователям самостоятельно выбирать пакет. Пакет может быть повторно применен при каждом входе в систему и будет использоваться при перезагрузке на серверах, где нет этого пакета
• Запоминает, какой пакет был применен пользователем в данный момент, и не отправляет тот же пакет повторно при смене сервера (больше не работает на 1.20.2+ из-за изменений в клиенте Minecraft и работе прокси-серверов Minecraft)
• Выкидывать с сервера игроков, не принимающих ресурспак, или отправлять их на определенный сервер (таким образом можно иметь две версии одного и того же сервера - с ресурспаками и без)
• Выполнять команды в зависимости от того, принял игрок пакет или нет
• Отправлять игроку сообщение или заголовок, когда он принимает, загружает, отрицает или не загружает ресурспак
• Защита экрана загрузки от обхода ESC с таймаутом
• Запретить пользователю подключаться к определенному серверу в вашей сети, если он не принял ресурспак ранее
• Различный набор действий для случаев, когда игрок впервые присоединяется к вашему серверу
• ResourcePackStatusEvent (для Bukkit используется PlayerResourcePackStatusEvent) для разработчиков, чтобы они могли реагировать на принятие или отказ в приеме пакета в своих плагинах.
• Совместимость с AuthMe Reloaded, AuthMeVelocity, OpenLogin, NLogin, LibrePremium, JPremium.
• Вам нужна совместимость с другими плагинами? Свяжитесь со мной!
• PlaceholderAPI: %frp_pack%, %frp_pack_<pack>%, %frp_status%, %frp_status_<status]%, %frp_storedpack%, %frp_pack_<pack>_online%, %frp_pack_<pack>_stored%

Важные замечания​

В настоящее время этот плагин совместим с BungeeCord выше 1.8, Velocity версии 1.1.0, Spigot выше 1.8.8 и клиентами выше 1.8. Поддержка Velocity является экспериментальной, поэтому, пожалуйста, сообщайте о любых проблемах!
Обычно я стараюсь поддерживать обратную совместимость, но иногда это невозможно, и для работы плагина может потребоваться установить более старую версию. (Например, для Spigot 1.12.2 может потребоваться версия плагина ниже 1.7.22).
Если вы заметили ошибку, но считаете, что она должна работать, пожалуйста, свяжитесь со мной, и я попробую ее исправить.

Пожалуйста, обратите внимание, что в клиенте Vanilla Minecraft применяются только пакеты ресурсов сервера размером менее 100 MiB! (50MiB до версии 1.15, 250MiB начиная с версии 1.18).

Также клиенты до версии 1.17 не могут использовать некоторые новые SSL-сертификаты для URL (например, Let's Encrypt), так как они поставляются со старой версией Java (Java 1.8.0_51, сообщение об ошибке было подано в Mojang и было исправлено в релизе 1.17 с Java 16), поэтому вам придется либо использовать другой сертификат, либо загружать файлы без шифрования (не рекомендуется!).

Сервер не может определить клиентские ресурс-паки, поэтому плагин работает только с серверными ресурс-паками!

Для того чтобы плагин работал, он подключается к внутреннему коду Bungee, что может привести к проблемам, если произойдет обновление Bungee, которое изменит его внутреннюю структуру. Я буду стараться поддерживать работу плагина на должном уровне (в конце концов, я сам его использую), но если вы считаете, что что-то сломалось без обновления плагина, пожалуйста, свяжитесь со мной как можно скорее!
Подобные проблемы также могут возникнуть, если плагины изменят внутреннее устройство Bungee неподдерживаемым образом. На данный момент известно, что единственным плагином, вызывающим такую проблему, является SKungee. К сожалению, единственным способом решения этой проблемы (помимо SKungee) является удаление SKungee или установка Force Resourcepacks на сервер Spigot, а не на Bungee.

Команды плагина ForceResourcepacks:​

/frp reload [resend] - Перезагружает файл конфигурации; повторно отправляет пакеты каждому сетевому игроку, если 2-й аргумент - "resend"
/frp generatehashes - Загружает файлы ресурсных пакетов и генерирует их хэши sha1
/frp version - Показывает версию данного плагина
/frp pack <pack> [url|hash|version|format|restricted|permission] - Редактирование значения пакета
/frp addpack <имя> <url> - Добавить новый пакет (проверьте mc-packs.net, если вам нужен хост пакета серверных ресурсов)
/frp removepack <имя> - Удалить пакет
/frp getpack [<игрок>] - Получить текущий примененный пакет игрока
/frp getstoredpack [<игрок>] - Получить сохраненный пакет игрока (требуется UUID для оффлайн игроков)
/frp packusage <pack> - Получить количество примененных и сохраненных пакетов
/frp listassignments - Список всех назначений сервера/мира
/frp deleteassignment <assignment> - Удалить определенное назначение сервера/мира
/frp globalassignment|assignment <assignment> - Показать/изменить значения определенного или глобального назначения.
Подкоманды:

• - info
• - pack <пак>
• - required true|false
• - promptmessage <сообщение>
• - addoptionalpack <пакет>
• - removeoptionalpack <пакет>
• - regex <regex>
• - senddelay <задержка в тиках>
• - addaction <status> <action> <value>
• - removeaction <status> [<action>]
• - addfirstjoinaction <status> <action> <value>
• - removefirstjoinaction <status> [<action>]

/usepack - Перечислить все пакеты, которые можно выбрать
/usepack <packname> [<имя игрока>] [<temporary>] - Отправляет определенный пакет себе или другому игроку, в зависимости от значения параметра temporary он будет действовать только в этой сессии или также будет повторно применен при следующем входе в систему. Значения - true или false, при отсутствии этого значения будет использоваться значение конфигурации usepack-is-temporary (по умолчанию true).
/resetpack [<имя игрока>] [<temporary>] - Сбросить пакет игрока.
Смотрите документацию по всем командам. Все команды и функции также имеют права доступа, которые перечислены на странице документации!

Права плагина ForceResourcepacks:​

forceresourcepacks.command - Доступ к команде /frp
forceresourcepacks.command.reload - Доступ к команде /frp reload
forceresourcepacks.command.generatehashes - Доступ к /frp generatehashes
forceresourcepacks.command.version - Доступ к /frp version

forceresourcepacks.command.usepack - Доступ к /usepack
forceresourcepacks.command.usepack.others - Отправка пакетов другим игрокам с помощью команды /usepack
forceresourcepacks.command.usepack.temporary - Выбор того, является ли выбранный пакет временным или должен быть сохранен и применен повторно

forceresourcepacks.command.resetpack - доступ к команде /resetpack
forceresourcepacks.command.resetpack.others - Сбросить пак других игроков
forceresourcepacks.command.resetpack.temporary - Устанавливает, должен ли пакет быть сброшен только временно и не сохраняться

forceresourcepacks.command.getpack - Доступ к команде /frp getpack
forceresourcepacks.command.getpack.others - Получить примененный пакет других игроков

forceresourcepacks.command.getstoredpack - Доступ к /frp getstoredpack
forceresourcepacks.command.getstoredpack.others - Получить сохраненный пакет других игроков

forceresourcepacks.command.packusage - Доступ к /frp packusage

forceresourcepacks.command.addpack - Доступ к /frp addpack
forceresourcepacks.command.pack - Доступ к /frp pack для редактирования пакетов

forceresourcepacks.command.assignment - Доступ к /frp assignment для добавления и редактирования назначений серверов/миров
forceresourcepacks.command.deleteassignment - Доступ к /frp deleteassignment для удаления назначений сервера/мира
forceresourcepacks.command.globalassignment - Доступ к /frp globalassignment для просмотра и редактирования глобального назначения

forceresourcepacks.pack.<packname> - Предоставляет доступ к пакету через команду /usepack, вы можете определить эти разрешения через config.yml для каждого пакета.

forceresourcepacks.updatenotification - Получение уведомлений об обновлениях в игре

forceresourcepacks.bypass.required - Обход настройки "required", в результате чего клиенты 1.17+ не смогут отклонить запрос на загрузку.
forceresourcepacks.bypass.<assignment>.required - Обход настройки "required" для определенного задания
forceresourcepacks.bypass.<action> - Обход определенного действия для всех статусов и назначений
forceresourcepacks.bypass.<status>.<action> - Обход определенного действия для определенного статуса во всех назначениях
forceresourcepacks.bypass.<assignment>.<action> - Обход определенного действия определенного назначения для всех статусов
forceresourcepacks.bypass.<assignment>.<status>.<action> - Обход определенного действия для определенного статуса определенного назначения

Конфиг плагина ForceResourcepacks:​

Конфиги по умолчанию для работы плагина на Bungee и Bukkit вы можете найти на gist!
Они немного отличаются друг от друга, прочитайте это примечание к обновлению для получения информации о том, как конфигурация Bukkit отличается от конфигурации Bungee, или просто посмотрите на конфигурации по умолчанию, ссылки на которые были даны ранее.
(Версии плагина выше 1.6.5 будут пытаться генерировать хэши sha1 автоматически и включать команду /frp generatehashes!)

О замораживании клиента​

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

Сколько времени это займет, зависит от производительности ПК и размера текстур (HD-пакеты занимают больше времени), которые используются во всех ресурс-паках, примененных игроком. (Таким образом, даже если серверный пакет ресурсов не содержит HD-текстур или текстур вообще, клиент все равно полностью перезагрузит все локально примененные пакеты ресурсов) Это то, что должно быть исправлено в клиенте Mojang, например, путем перезагрузки только тех ресурсов, которые изменились. Я мало что могу сделать в этой ситуации, кроме как посоветовать людям оказать давление на Mojang, чтобы улучшить это поведение.

В версиях 1.14 и 1.15 есть ряд серьезных улучшений, поэтому советую игрокам использовать их вместо старых версий, если у них есть проблемы с ресурспаком вашего сервера!

Внешние запросы​

Данный плагин выполняет определенные веб-запросы к внешним серверам, которые могут раскрывать некоторую информацию о вашей машине, игровом сервере и использовании плагина. Вы можете отказаться от всех запросов, и ни один из них не будет загружать какие-либо исполняемые данные!
Плагин отправляет метрики на bStats.org, а также на мои собственные серверы. Отказаться от этого можно, изменив опцию disable-metrics в config.yml плагина или в файле plugins/bStats/config.yml!
Плагин также включает в себя программу проверки обновлений, которая предоставляет информацию о новых версиях в консоль/журнал. Если у вас есть определенные права, эта проверка может быть отключена с помощью параметра update-check.