Embers Text API

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

Возможности системы

Разработчики получают доступ к многопоточному API с понятным синтаксисом, который поддерживает:

• Интуитивный конструктор — создание сложных текстовых эффектов через последовательное соединение методов
• Пользовательские шрифты — возможность использования собственных растровых шрифтов, размещаемых в папке assets/emberstextapi/font/
• Фоновое оформление — рамки в стиле подсказок многоцелевых панелей с точной настройкой масштабирования и отступов
• Продвинутое оформление текста — монохромные оттенки, градиентные переходы, полужирное и курсивное начертание, поддержка RGB-цветов
• Анимационные системы — постепенное появление текста по буквам, эффекты искажения, вибрация отдельных символов или всего сообщения
• Гибкое позиционирование — различные точки привязки, выравнивание по осям, сдвиги относительно краёв экрана, автоматический перенос строк

Интеграция для разработчиков

Отправка сообщений с сервера осуществляется простым способом:

ImmersiveMessage msg = ImmersiveMessage.builder(100f, "Hello world!")
    .anchor(TextAnchor.CENTER_CENTER)
    .gradient(0xFF0000, 0x00FF00)
    .typewriter(2f, true);
EmbersTextAPI.sendMessage(player, msg);

(// Создать анимированное сообщение с градиентом)

Поддерживается как отправка отдельным игрокам, так и массовая рассылка всем подключённым участникам. Все визуальные элементы, включая фоновые текстуры, полностью настраиваются разработчиком.

Консольные команды

Для тестирования и отладки встроены инструменты командной строки:

• /emberstextapi send <player> <duration> <text> — упрощенная отправка стандартных сообщений
• /emberstextapi sendcustom <player> <nbt> <duration> <text> — полная персонализация через NBT-формат
• /emberstextapi test <id> — воспроизведение демонстрационных примеров из коллекции

Для создателей сборок

Это библиотечный мод, который сам по себе не вносит изменений в геймплей. Однако встроенная система команд открывает широкие возможности для реализации креативных решений. Идеально подходит для создания иммерсивных кат13цен, визуального оформления битв с боссами, заданий квестов и стильных игровых объявлений.