Плагин hHideStream [1.21-26.X] | Аналог уже известного HideStream v1.0

---

hHideStream — компактный служебный плагин для серверов на Paper, которым нужен чистый чат во время стримов, мероприятий, дуэлей, PvP-сессий или обычной игры.

Плагин постоянно убирает стандартные сообщения о входе, выходе, кике и смерти игроков, а также позволяет централизованно управлять gamerule, временем и погодой в разных мирах.

Вместо ручной настройки каждого мира вы описываете общие правила, добавляете точечные переопределения и объединяете миры с одинаковыми настройками в группы. hHideStream применит конфигурацию при запуске, при загрузке новых миров, после перезагрузки настроек и затем будет периодически восстанавливать нужные значения.

---

Версия 1.0 глобально отключает четыре вида стандартных сообщений:

• вход игрока на сервер;
• выход игрока с сервера;
• отключение игрока через kick;
• сообщение о смерти игрока.

Эти четыре обработчика включены постоянно и не имеют отдельных переключателей в конфигурации. Скрытие относится к публичным внутриигровым сообщениям этих событий во всех мирах; отдельные строки подключения и отключения в консоли плагин не удаляет.

Дополнительный системный шум настраивается через gamerule. Например, можно отключить объявления о достижениях, вывод командных блоков, обратную связь команд и запись административных команд в консоль.

---

В файле gameRules.yml можно задавать логические и числовые gamerule. Названия сопоставляются без учёта регистра, дефисов и нижних подчёркиваний, а для удобства предусмотрены понятные альтернативные имена.

Стандартная конфигурация уже содержит следующие правила:

• showAdvancementMessages: false — отключает объявления о достижениях;
• showDeathMessages: false — отключает стандартные сообщения о смерти на уровне мира;
• logAdminCommands: false — отключает ванильную запись выполненных администраторами команд в серверный лог;
• commandBlockOutput: false — убирает вывод командных блоков;
• sendCommandFeedback: false — отключает обратную связь о выполнении команд;
• locatorBar: false — отключает панель поиска игроков;
• spawnPhantoms: false — запрещает естественное появление фантомов;
• spawnPatrols: false — запрещает появление патрулей разбойников;
• spawnWanderingTraders: false — запрещает появление странствующих торговцев;
• raids: false — запрещает рейды;
• commandBlocksWork: false — отключает работу командных блоков;
• maxEntityCramming: 12 — задаёт предел скученности сущностей;
• advanceTime: false — останавливает естественное течение времени в выбранных мирах;
• advanceWeather: false — останавливает естественную смену погоды в выбранных мирах.

Можно использовать и другие доступные в установленной версии Paper gamerule с типом boolean или integer. Это позволяет оставить в файле только действительно нужные серверу правила.

Набор gamerule зависит от конкретной версии Minecraft/Paper. Неизвестное текущей сборке имя пропускается; например, locatorBar и commandBlocksWork сработают только там, где установленная версия сервера предоставляет соответствующие правила.


Секция '*' применяется ко всем загруженным мирам. Затем настройки конкретного мира накладываются поверх общих и переопределяют совпадающие gamerule.


Несколько миров с одинаковым набором правил можно объединить через точку с запятой:


Названия миров обрабатываются без учёта регистра. Для мира, загруженного во время /hhidestream reload, правило возвращается к значению Bukkit по умолчанию только тогда, когда соответствующий GameRule полностью исчез из нового итогового набора — и из '*', и из секции мира. Если удалено только локальное переопределение, продолжает действовать общее значение.

---

Файл weatherWorlds.yml отвечает за отдельные параметры времени и погоды. Для каждого мира или группы миров обе системы можно включать независимо.

• time.enable — применять указанное время;
• time.value — время мира в тиках;
• time.lock — при включённом time.enable отменять каждый Bukkit TimeSkipEvent и возвращать заданное время;
• weather.enable — применять выбранную погоду;
• weather.type — тип погоды;
• weather.duration — длительность состояния в тиках;
• weather.lock — отменять конфликтующие с настройкой события WeatherChangeEvent и ThunderChangeEvent.

Поддерживаемые типы погоды:

• CLEAR — ясная погода;
• RAIN — дождь без грозы;
• THUNDER — дождь с грозой;
• THUNDER_ONLY — состояние грозы без дождя.

Пример фиксации полудня и ясной погоды сразу в нескольких мирах:


Настройки применяются при старте плагина и при загрузке мира. Включённый time.lock отменяет события пропуска времени, а weather.lock — только переходы погоды и грозы, которые не совпадают с заданным состоянием.

Чтобы время действительно стояло на месте между повторными применениями, для тех же миров установите advanceTime: false в gameRules.yml. Параметр time.lock блокирует события пропуска времени, но сам по себе не отключает естественный ход суток.

---

Другой плагин, команда администратора или серверная механика могут попытаться изменить gamerule, время либо погоду. Поэтому hHideStream не ограничивается однократной настройкой.

Плагин периодически повторно применяет правила ко всем загруженным мирам. Интервал задаётся в config.yml:


Стандартное значение — 600 тиков, то есть один запуск примерно каждые 30 секунд. Значение должно быть больше нуля.

Такой подход помогает сохранять одинаковое состояние арен, лобби и служебных миров без тяжёлой проверки каждого игрока или выполнения логики каждый тик.

Если для времени или погоды установлено enable: true, их целевое состояние всё равно применяется периодической задачей даже при lock: false. Параметр lock отвечает за немедленную отмену соответствующих игровых событий.

Значения gamerule, времени и погоды применяются непосредственно к мирам. Выключение или удаление плагина не возвращает прежнее состояние автоматически. Полностью исчезнувший из итогового набора gamerule сбрасывается при reload только для загруженного мира. Удалённые либо выключенные настройки времени и погоды перестают поддерживаться, но их последнее установленное значение остаётся до следующего изменения.

---

• /hhidestream — вывести настраиваемую подсказку по синтаксису;
• /hhidestream reload — перечитать все конфигурационные файлы и повторно применить настройки;
• /hhidestream info <мир> — вывести управляемые gamerule и их текущие значения для указанного загруженного мира.

Автодополнение учитывает доступ пользователя: показывает только разрешённые подкоманды, а для info предлагает названия загруженных миров. Игрокам без доступа основная команда также скрывается из отправляемого сервером списка команд.

• hhidestream.reload — доступ к перезагрузке конфигурации;
• hhidestream.info — доступ к просмотру правил мира.

Оба права по умолчанию доступны операторам сервера.

В config.yml можно заменить стандартные права собственными или указать сразу несколько вариантов. Для доступа достаточно любого права из соответствующего списка. Пустой список отключает проверку прав и разрешает использовать соответствующую подкоманду всем.

---

После первого запуска создаются пять понятных YAML-файлов:

• config.yml — префикс, интервал повторного применения и права;
• gameRules.yml — общие gamerule и настройки отдельных миров;
• weatherWorlds.yml — время, погода и их блокировка;
• messages.yml — сообщения команд;
• logs.yml — текст ошибки перезагрузки для консоли.

Сообщения и префикс поддерживают современный формат MiniMessage: HEX-цвета, градиенты, оформление и другие компоненты Adventure. Область замены зависит от конкретного сообщения:

• {prefix} и %prefix% — префикс из config.yml;
• {reason} — причина ошибки перезагрузки;
• {world} — название мира в сообщении об отсутствующем мире и выводе info;
• {count} — количество итоговых правил, заменяется только в первом элементе messages.general.info;
• {rule}, {value} и {configured} — данные правила в последующих элементах info, которые повторяются для каждого итогового gamerule.

В версии 1.0 только первый элемент messages.general.info отправляется один раз; все следующие элементы используются как повторяемые шаблоны правил. Учитывайте это при изменении оформления команды.

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

---

hHideStream не выполняет постоянное сканирование игроков и не обрабатывает их перемещение.

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

Плагин хранит только конфигурационные YAML-файлы. Он не собирает IP-адреса, сообщения чата, координаты, историю команд или другую информацию об игроках.

---

• Сервер: Paper 1.21.x;
• Java: 21;
• Зависимости: отсутствуют;

---

1. Остановите сервер.
2. Поместите hHideStream-1.0.jar в папку plugins.
3. Запустите сервер, чтобы плагин создал конфигурационные файлы.
4. Обязательно замените стандартные списки миров в gameRules.yml и weatherWorlds.yml на реальные названия миров вашего сервера.
5. Проверьте gamerule, время, погоду и права доступа.
6. Выполните /hhidestream reload или перезапустите сервер.