BlossomLib

BlossomLib — это утилитарная библиотека для модов Fabric и Quilt, разработанная автором CodedSakura. Она служит фундаментом для серии модов Blossom, предоставляя серверу необходимые инструменты для реализации сложных механик, таких как телепортация игроков с анимацией, система таймеров и кастомные сообщения в чате. Мод не содержит игрового контента и необходим для корректной работы соответствующих сборок.

Настройка конфигурации и логирования

Конфигурация BlossomLib хранится в файле config/BlossomMods/BlossomLib.json и генерируется после первого запуска сервера с модом. Основное управление ведётся через раздел LoggingConfig, где администратор может задавать уровень детализации вывода в консоль (consoleLogLevel) и в файлы (fileLogLevel). Доступные уровни: OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL. Также можно указать путь к файлу логов (fileLogPath), настроить поведение при перезапуске (fileLogAppend) и полностью отключить кастомный логгер в случае конфликтов (disableCustomLogger).

Настройки телепортации и анимаций

Ключевой функционал библиотеки — управление телепортацией, настраиваемое через TeleportationConfig. Пользователи могут включить или отключить отображение полоски здоровья (BossBar) в процессе перемещения и настроить её цвет (pink, blue, red, green, yellow, purple, white). Важной опцией является cancelOnMove: если игрок сдвинется с места во время ожидания телепортации, процесс отменится. Для визуального эффекта используются кривые Безье (CubicBezierCurve), определяющие изменение поля зрения (FOV) перед и после перемещения. Анимация может быть полностью отключена через параметр enabled.

Система сообщений и цветов

Библиотека позволяет глубоко кастомизировать сообщения, используя настройки TitleMessage и Colors. Можно настроить отображение заголовков и подзаголовков для таймеров (titleCounting, subtitleCounting), а также финальных сообщений об успешном выполнении (titleDone, subitleDone). Для каждого заголовка и подзаголовка доступны настройки цвета текста, жирного начертания (b), курсива (i), подчеркивания (u) и зачёркивания (s). Раздел Colors определяет базовые цвета для сообщений в чате: базовый (base), предупреждений (warn), ошибок (error), успехов (success), а также цвета для имен игроков (player) и команд (command).

Команды администратора

Команда /tpcancel позволяет мгновенно отменить текущую телепортацию или таймер. Основная команда /blossomlib (доступна администраторам уровня 2) открывает подменю для управления библиотекой. В неё входят: reload-config для перезагрузки настроек без рестарта сервера, clear-countdowns для очистки таймеров у игроков, clear-cooldowns для сброса кулдаунов и debug для отладки. Команда debug позволяет создавать произвольные таймеры, телепортации и менять FOV для тестирования.