Custom Tooltip API

Мод Custom Tooltip API для Minecraft 1.20.1

Custom Tooltip API — это мощный клиентский мод и библиотека для разработчиков, дающий полный контроль над подсказками предметов в Minecraft. С его помощью можно добавлять кастомные легенды, динамические данные в реальном времени, анимированные градиенты и собственные фоны, настраивая их как через удобный игровой интерфейс, так и через код. Мод поддерживает работу с переменными, Regex, кастомные шрифты и фоны, а также предоставляет API для интеграции в другие проекты.

Ключевые возможности и управление

Мод позволяет создавать подсказки с полным контролем над внешним видом и содержанием. Вы можете выравнивать иконки из сторонних пакетов ресурсов, настраивать их положение и использовать продвинутое таргетирование. Поддерживаются конкретные ID предметов (например, minecraft:diamond_sword), группы тегов (#c:swords), целые пространства имен модов (minecraft:*), шаблоны Regex или все предметы сразу (*).

В текст подсказок можно встраивать переменные для отображения данных в реальном времени: %durability%, %max_durability%, %weapon_damage%, %enchantments%. Также доступны подсказки для кнопок привязок в формате -> [Space]. Поддержка многострочного текста позволяет добавлять целые абзацы легенд или описаний навыков.

Визуальные эффекты включают анимированный радужный эффект, скользящие и пульсирующие градиенты, а также статичные цвета. Для настройки используются HEX-коды (например, #RRGGBB), устаревшие коды (&d) или названия цветов Minecraft. Можно добавить собственные фоны и рамки с полной настройкой прозрачности, а также кастомные шрифты. Поддерживается полная совместимость с кастомным рендерингом Tierify.

Настройка интерфейса и отображения

Позиция текста полностью настраивается: можно разместить его сразу под названием предмета, в самом конце описания, или использовать режимы Prepend и Append для начала и конца конкретных строк. Есть функции замены: можно заменить стандартное название предмета, конкретную строку или полностью очистить оригинальную подсказку, показав только кастомную.

Условия видимости позволяют показывать подсказку только если предмет повреждён, проклят или нерушим. Режим Require Keybind скрывает подсказки до нажатия определённой клавиши. Поддерживаются текстовые модификаторы: жирный шрифт, курсив, подчёркивание, зачёркивание и обфусцированный текст.

Управление осуществляется через модное меню. Удерживая CTRL во время редактирования, можно увидеть мгновенный предпросмотр. Можно копировать/вставлять записи в буфер обмена, переставлять их, дублировать, включать/выключать и сортировать по дате создания или алфавиту.

API для разработчиков и создателей сборок

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

Создатели модпаков получают файл custom_tooltip_api/config.json5 в папке config. Он поддерживает комментарии в коде, что упрощает документацию систем модпака для команды разработки или сообщества. В папке config/custom-tooltip-api/backgrounds/ можно разместить собственные фоны, а в fonts/ — кастомные шрифты. Активация динамически сгенерированного пакета ресурсов включает эти настройки.

Ограничения и особенности

Мод работает исключительно на стороне клиента и не поддерживается на сервере. В архиве отсутствуют исполняемые файлы и встроенные JAR-файлы. Русский язык в файлах конфигурации отсутствует, подтверждённые языки: немецкий, английский и испанский. Если в вашем модпаке или конфигурации используются русские ресурсы, они должны быть добавлены вручную или через сторонние инструменты локализации, так как мод не предоставляет автоматического перевода.

Связанные материалы

• Curios API — похожий мод
• Trinkets — похожий мод
• Just Enough Items (JEI) — похожий мод
• Geckolib — похожий мод

Автор: Stalemated · Лицензия: MIT