Custom Tooltip API - Полный контроль над подсказками в Майнкрафт

В ванильном Minecraft подсказки (tooltips) предметов выглядят одинаково скучно: название, редкость, характеристики и всё. Но что если ты хочешь добавить лор для своего меча, вывести текущее количество энергии из Industrial Revolution или просто сделать красивые цветные подсказки? Custom Tooltip API для Minecraft - это мощный клиентский мод и библиотека для разработчиков, который даёт полный контроль над отображением тултипов.

Какую проблему решает Custom Tooltip API?

Обычно, чтобы изменить подсказку предмета в Майнкрафт, приходилось писать хитрые датапаки или моды. Если нужно вывести динамические данные (например, потраченную прочность или зачарования) - это всё сложнее и не поддерживается на сервере. Custom Tooltip API делает всё просто и гибко: через удобный интерфейс в игре, через JSON-конфиги или через API для коддеров.

Ключевые возможности

Выравнивание иконок

• Icon Alignment: Выравнивание иконок из внешних ресурспаков к началу строки, чтобы позиция оставалась стабильной.

Продвинутый таргетинг

• Targeting: Можно указать ID предмета (minecraft:diamond_sword), группу тегов (#c:swords), всё пространство имён мода (minecraft:*), регулярное выражение (regex:.*_sword) или вообще все предметы разом (*).

Динамические плейсхолдеры

• Placeholders: Вставляй прямо в текст переменные вроде %durability%, %max_durability%, %weapon_damage%, %enchantments%. Или добавь подсказку с клавишей: <key:key.jump> превращается в [Space].

Многострочная Lore

• Multi-line Support: Добавляй целые абзацы описания, навыков или лора для каждого предмета.

Визуальные эффекты и градиенты

• Gradients:
  • ✨: Анимированная радуга.
  • Slide Gradient: Двухцветный градиент, который движется по тексту.
  • Breathing Gradient: Плавное переливание между двумя цветами.
  • Static Gradient и Solid: Фиксированные градиенты или обычный однотонный текст.
• Colors: Используй Hex-коды (#RRGGBB), legacy коды (&d) или имена цветов из Minecraft (blue).

Кастомные фоны и границы

• Backgrounds & Borders: Solid, Gradient, Texture (Stretch) или Texture (Framed / Nine-Slice) с полным контролем прозрачности. Просто кидай любое фоновое изображение в config/custom-tooltip-api/backgrounds/ и включай для каждого тултипа через динамический ресурспак. Есть совместимость с Tierify.

Кастомные шрифты

• Fonts: Кидай шрифты в config/custom-tooltip-api/fonts/ и включай для каждого тултипа.

Позиционирование текста

• Positioning: Решай, где именно появится твой текст:
  • Top: Сразу под названием предмета.
  • Bottom: В самом конце описания.
  • Prepend: В начале конкретной строки.
  • Append: В конце конкретной строки.
  • Replace Name: Замени название предмета на свой текст.
  • Replace Line: Замени конкретную строку на свой текст.
  • Replace All: Полностью замени оригинальную подсказку на свою.

Условия видимости

• Visibility Conditions: Показывай тултип, только когда предмет повреждён, зачарован или неразрушим. Используй Require Keybind, чтобы скрывать подсказки, пока игрок не зажмёт определённую клавишу.

Модификаторы текста

• Text Modifiers: Жирный, курсив, подчёркнутый, зачёркнутый и даже запутанный (Obfuscated) текст.

Встроенный интерфейс

• Управляй всеми тултипами прямо из Mods Menu. Не нужно лезть в файлы вручную.
• Зажми CTRL на экране редактирования - включится Live Preview, где сразу видно результат.
• Копируй, вставляй, изменяй порядок, дублируй, включай/выключай и сортируй записи по дате или алфавиту.

Для разработчиков (API)

Разработчики могут регистрировать тултипы и кастомные плейсхолдеры прямо через код, используя .dynamicText() для отображения живых данных (энергия, мана, NBT). Полный пример кода - в README на GitHub.

Для сборщиков модов

Мод генерирует файл custom_tooltip_api/config.json5 в папке config. Он поддерживает комментарии, так что документируй системы своей сборки прямо внутри конфига. Кидай фоны в config/custom-tooltip-api/backgrounds/, шрифты в config/custom-tooltip-api/fonts/ и активируй динамический ресурспак.

Зависимости

Обязательны на всех платформах:

• S-Lib
• YACL

Только для Fabric:

• Fabric API
• ModMenu

Скачай Custom Tooltip API для Minecraft и преврати скучные подсказки в информативные и красивые элементы интерфейса. Мод работает на Fabric, Forge и NeoForge (проверь актуальные версии). Если собираешь сборку модов - обрати внимание на совместимость с другими модами, которые меняют тултипы.