BlossomLib

BlossomLib

BlossomLib — это библиотечный мод для Minecraft Fabric, созданный для модов серии Blossom.

Содержание

• Зависимости
• Конфиг
• Команды и их разрешения
• Ключи перевода

Зависимости

• Fabric API (CurseForge / Modrinth), или Quilt Standard Libraries (Modrinth) если используете Quilt
• fabric-permissions-api / LuckPerms / и т.д. (Опционально)
• server-translations-api (Встроено)

Конфиг

Файл конфигурации этой библиотеки можно найти по пути config/BlossomMods/BlossomLib.json, после запуска сервера с модом хотя бы один раз.

logging: LoggingConfig - настройки, связанные с логированием BlossomMods
baseTeleportation: TeleportationConfig - настройки телепортации по умолчанию
colors: Colors - цвета текста
dimNameOverrides: Map<String, String> - карта переопределений названий измерений, например установите { "minecraft:the_nether": "The Underworld" }, чтобы отображать The Nether как The Underworld
enableMC124177Fix: boolean - Включить исправление для MC-124177 / CrossDimTPFix

LoggingConfig

consoleLogLevel: String (OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL) - уровень логирования BlossomMods для вывода в консоль
fileLogLevel: String (OFF, FATAL, ERROR, WARN, INFO, DEBUG, TRACE, ALL) - уровень логирования BlossomMods для вывода в файл
fileLogPath: String - куда помещать файл лога BlossomMods
fileLogAppend: boolean - сохранять ли старые логи BlossomMods при запуске сервера
disableCustomLogger: boolean - полностью обходить кастомный логгер в случае несовместимости модов

TeleportationConfig

bossBar: BossBar - настройки, изменяющие боссбар
titleMessage: TitleMessage - настройки, изменяющие сообщение заголовка
actionBarMessageEnabled: boolean - показывать ли сообщение в action bar при отсчёте
fovEffectBefore: CubicBezierCurve - анимация FOV до телепортации
fovEffectAfter: CubicBezierCurve - анимация FOV после телепортации
cancelOnMove: boolean - отменять ли отсчёт, если игрок движется
particleAnimation: ParticleAnimation - какую анимацию частиц использовать

BossBar

enabled: boolean - включён ли боссбар
color: String (pink, blue, red, green, yellow, purple, white) - цвет боссбара
textColor: String (допустимый цвет текста) - цвет названия боссбара

TitleMessage

titleCounting: TitleConfig* - настройки, изменяющие отображение отсчитываемого Title
subtitleCounting: TitleConfig* - настройки, изменяющие отображение отсчитываемого Subtitle
titleDone: TitleConfig - настройки, изменяющие отображение завершённого Title
subitleDone: TitleConfig - настройки, изменяющие отображение завершённого Subtitle

TitleConfig

color: String (допустимый цвет текста) - цвет title / subtitle
modifiers: String - символы b - жирный, i - курсив, u - подчёркнутый, o - обфусцированный, s - зачёркнутый, могут располагаться в любом порядке
*counterColor: String (допустимый цвет текста) - цвет счётчика в title / subtitle

CubicBezierCurve

Генератор кубических кривых Безье

enabled: boolean — нужно ли вообще проигрывать анимацию
values: float[4] — 4 значения, задающие кривую cubic-bezier; 1-е и 3-е значения должны быть между 1 и 0, иначе произойдут странные вещи!
start: float — начальное значение
end: float — конечное значение
stepCount: int — сколько шагов должна сгенерировать анимация

Colors

Эти цвета будут применяться только к ответам Blossom в чате модов

base: String — цвет текста, в котором будет большинство текстовых ответов
warn: String — цвет текста, в котором будут предупреждающие сообщения
error: String — цвет текста, в котором будут сообщения об ошибках
success: String — цвет текста, в котором будут сообщения об успехе
variable: String — цвет текста, в котором будут переменные
player: String — цвет текста, в котором будут имена игроков
command: String — цвет текста, в котором будут команды
commandDescription: String — цвет текста, в котором будут описания команд

Команды и их права

• /tpcancel — отменить любое текущее телепортирование / отсчёт
  Право: blossom.tpcancel (по умолчанию: true)

• /blossomlib — команды, специфичные для библиотеки
  Право: blossom.lib.base-command (по умолчанию: OP level 2)

  • reload-config — перезагрузить и применить конфиг из файла конфигурации
    Право blossom.lib.base-command.reload-config (по умолчанию: OP level 3)
  • `clear-countdowns []— очистить отсчёты всех или конкретных игроков Правоblossom.lib.base-command.clear.countdowns` (по умолчанию: OP level 2)
  • `clear-cooldowns [] []— очистить перезарядки конкретного типа у всех или конкретных игроков Правоblossom.lib.base-command.clear.cooldowns` (по умолчанию: OP level 2)
  • debug — отладочные команды
    Право blossom.lib.base-command.debug (по умолчанию: OP level 4)
  • `countdown ` — создать произвольный отсчёт
  • `teleport [] ` — создать произвольное телепортирование
  • `fov ` — установить FOV игрока

Ключи перевода

показаны только ключи с доступными аргументами, полный список смотрите в src/main/resources/data/blossom/lang/en_us.json

• blossom.countdown.boss_bar.name: 1 аргумент — оставшиеся секунды
• blossom.countdown.action_bar.counting: 1 аргумент — оставшиеся секунды
• blossom.countdown.title.counting.title: 1 аргумент — оставшиеся секунды
• blossom.countdown.title.counting.subtitle: 1 аргумент — оставшиеся секунды
• blossom.clear-countdowns.one: 1 аргумент — игрок, чей отсчёт был очищен
• blossom.clear-cooldowns.one: 1 аргумент — игрок, чья перезарядка была очищена
• blossom.clear-cooldowns.type: 2 аргумента — игрок, чья перезарядка была очищена, тип очищенной перезарядки
• blossom.debug.countdown.start: 1 аргумент — время standstill
• blossom.debug.teleport.no-cooldown: 1 аргумент — время standstill
• blossom.debug.teleport.cooldown: 2 аргумента — время standstill, время перезарядки
• blossom.config-reload: 1 аргумент — название модуля
• blossom.text.command.display: 1 аргумент — отображаемый текст
• blossom.text.command.plain: 1 аргумент — отображаемый текст/выполняемая команда
• blossom.text.command.description: 2 аргумента — отображаемый текст/выполняемая команда, описание

zh_cn (китайский, упрощённый), zh_tw (китайский, традиционный) — добавлено @BackWheel
ko_kr (корейский) — добавлено @biryeongtrain
es_mx (испанский, Мексика) — добавлено @FabrizioCoder
fr_fr (французский) — добавлено @WalTho