Плагин JAmbience v1.1 - Украсьте окружающую среду [1.8-26.1+]

[Loltik]

️JAmbience
Добавьте реалистичные погодные условия, тем самым улучшив окружающую среду.

SpigotMC.org | GitHub | Modrinth | SpigotMC.(RU)​

Этот плагин добавляет реалистичные погодные условия, получая данные через OpenWeatherAPI или ручной метод.

• $ Поддерживаются версии 1.8.1-26+. Возможно, и версия 1.7, но она не тестировалась.
• $ Плагин был протестирован на версиях: 1.8.8, 1.19.4, 1.21, 26+. Наилучшая производительность была отмечена в следующих версиях: 1.8.8, 1.12.2 и 1.16.5.
• $ На версиях ниже 1.9 может быть не тот результат, который вы ожидаете.
• $ Рекомендуется использовать ядро Paper и его форки, иначе функционал плагина может быть обрезан.

Спойлер: Обзор плагина (JAmbience v1.1 - Preview)

Погодные условия

• Ветер:
  • Управление частицами (двигаются по направлению ветра. На некоторых версиях - не могут корректно управляться):
    
  • Управление движением игрока (по направлению - быстрее, против направления - медленнее):
    
    
  • Громкость ветра (если скорость ветра увеличивается, то и увеличивается звук ветра):
    • Версии 1.9+ - звук летающей элитры.
    • Версии 1.8 и ниже - звук летающего дракона.
• Видимость:
  • Плагин управляет видимостью игроков в зависимости от погоды:
    • Видимость 1 чанк:
      
      
    • Видимость 2 чанка (не работает такой эффект на версиях ниже 1.19):
      
      
    • Видимость 3 чанка или более (на фото - 10 чанков):
      
• Эффект заморозки при определённых температурах (прогрессирует при пониженных температурах. Работает только на версиях 1.17+):
  
• Частицы:
  • Дождя:
    
  • Снега:
    
  • Сезонные частицы (под каждый сезон - свой цвет частицы. Не управляются ветром). Подробнее можно увидеть на фотографиях выше или в конфигурации.

Специальные погодные условия

• Порыв (толчок по направлению ветра. Зависит от скорости):
  
• Остальные не были продуманы, так как это сложно представить с обычной игрой. Вы можете отслеживать статус погоды через плейсхолдер %jambience_status%

Режимы

• OpenWeatherAPI (auto):
  • Автоматическое получение актуальных данных с сайта.
• Ручной (manual):
  • Подстраивается под данные из конфигурации.

️️Поддерживается:

• Поддержка HEX (1.16+, он работает на версиях и ниже, но отображая некорректные цвета), MiniMessage (1.18+)
• Плагины:
  
  • PlaceholderAPI (Система скорбоардов).
    
    • Вы можете скачать его здесь: Releases · PlaceholderAPI/PlaceholderAPI
    • Не забудьте включить его в конфигурации плагина.
    • Плейсхолдеры:
      • %jambience_name% - Название города, взятое из конфигурации.
      • %jambience_emoji% - Эмодзи погоды, взятое из конфигурации.
      • %jambience_windspeed% - Скорость ветра.
      • %jambience_color% - Цвет статуса погоды.
      • %jambience_temperature% - Получить температуру.
      • %jambience_winddeg% - Получить градусы ветра.
      • %jambience_visibility% - Видимость в чанках.
      • %jambience_time% - Время на данный момент, взятое из конфигурации.
      • %jambience_event% - Переведённое имя ивента из конфигурации.
      • %jambience_amount% - Количество частиц в заданные тики.
    • $ Готовая конфигурация скорбоарда:
      
      
      Спойлер: config.yml (TAB, кусок конфигурации)

        scoreboards:
          default:
            title: '&f&lWeather'
            lines:
            - ''
            - '%jambience_color%&l➤ &fCity: %jambience_color%%jambience_name%'
            - ' %jambience_color%》 &fTime: %jambience_color%%jambience_time%'
            - ''
            - '%jambience_color%✉ &fInformation:'
            - ' %jambience_color%》 &fTemperature: %jambience_color%%jambience_temperature%%jambience_emoji%'
            - ' %jambience_color%》 &fWind:'
            - '   %jambience_color%о &fSpeed: %jambience_color%%jambience_windspeed% m/s'
            - '   %jambience_color%о &fDeg: %jambience_color%%jambience_winddeg%°'
            - ' %jambience_color%》 &fVisibility: %jambience_color%%jambience_visibility% chunks.'
            - ' '
            - '%jambience_color%☁ &fWeather Type:'
            - ' %jambience_color%》 &fType: %jambience_color%%jambience_event%'
            - ' %jambience_color%》 &fPrecipitation: %jambience_color%%jambience_amount%'
            - ''

• OpenWeatherAPI:
  
  • Вы можете вставить ссылку, чтобы плагин начал работать с вашим городом:
    • OpenWeather APIs for Weather, Energy, and Environment
    • Шаги для подключения:
      • 1. Посетите сайт выше.
      • 2. Создайте аккаунт на этом сервисе.
      • 3. Найдите API-ключ в настройках аккаунта.
      • 4. Выберите локацию, следуя инструкциям сайта.
      • 5. Вставьте ссылку в конфигурацию плагина.
• Проверки:
  
  • Плагин автоматически определит версию вашего сервера, чтобы он начал корректно работать с вашим проектом.
  • Находится ли игрок в ГМ/флае, чтобы не мешать работе оператора.
  • Сколько некорректных подключений, чтобы перейти к работе ManualMode.
  • Проверка прав доступа.
  • И многое другое...

Функции:

• ⌨️ Команда (/jambience):
  
  • /jambience status - Узнать статус плагина.
  • /jambience reload - Перезагрузить конфигурацию плагина.
  • /jambience reloadSmoothly - Перезагрузить конфигурацию, но плавно.
  • /jambience update - Обновить информацию из OpenWeatherAPI.
  • /jambience updateSmoothly - Обновить информацию, но плавно.
  • /jambience set value double/int - Установить параметр погоды (эксперимент).
• Права:
  
  • jambience.use - Может ли игрок использовать команду?
• Урезанные действия:
  
  • [message] - Отправка сообщения игроку.
  • [broadcast] - Опубликовать сообщение всем игрокам.
  • [delay] - Задержка в тиках.
  • [console] - Отправка команды от имени консоли.
  • [log] - Отправить лог.
  • Информация:
    
    • Сообщения, отправленные в консоль, могут не заменять плейсхолдеры или выполнять определенные действия выше.
• Конфигурация:
  
  • Отправляйте действия игрокам с помощью сообщений. (Поддержка HEX в версии 1.16+, поддержка MiniMessage в версии 1.18+)
  • Настройки функций, которые поддерживаются (можно выключить не нужные).

Конфигурация:
Вы можете просмотреть конфигурацию здесь: https://github.com/mitriyf/JAmbience/blob/main/src/main/resources/config.yml
Остальные возможности вы можете рассмотреть при использовании плагина.
Boosty: JDevs - Creating Minecraft Projects

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