Item Tooltips - настраиваемые подсказки для предметов

Item Tooltips - мод для Майнкрафт, который делает подсказки (tooltips) действительно удобными и информативными. В ванильной игре ты видишь только базовые цифры, а здесь можно настроить буквально всё: от цвета и шрифта до отображения прочности и описаний зачарований. Пригодится и обычным игрокам, и сборщикам модпаков, и разработчикам.

Мод заточен под максимальную гибкость - хочешь показывать прочность только у повреждённых предметов, хочешь добавить текстовое описание каждому блоку - без проблем. Всё настраивается через конфиг (прямо в игре через Mod Menu, если он есть).

Прочность и атрибуты

Прочность

Тут всё просто: Item Tooltips показывает текущую и максимальную прочность. Цвет подсказки можно поменять, а сама цифра прочности подтягивает цвет прямо из полоски прочности - выглядит единообразно. Можно выбрать один из четырёх режимов: показывать всегда, только у повреждённых, при зажатой клавише, или вообще отключить.

Скорость копания

По умолчанию добавляется зелёная подсказка со скоростью добычи для инструментов - так же, как ванильные подсказки для урона и скорости атаки. Мод старается не показывать её там, где не нужно, но если что-то мешает, можно добавить предмет в тег #item_tooltips:hidden_mining_speed - и подсказка пропадёт.

Описания предметов

Как добавить описание

Любому блоку или предмету можно присвоить текстовое описание. Для этого добавь его в тег #item_tooltips:has_description, а потом создай перевод с ключом предмет.desc. Например, для тотема бессмертия ключ будет item.minecraft.totem_of_undying.desc. Всё как с другими модами на описания зачарований.

Важно: сама по себе эта фича ничего не делает без контента от разработчика или модпака. То есть описание нужно написать самому - это инструмент для авторов.

Чёрный список

Если какой-то предмет не должен иметь описание (даже если он в теге), добавь его в #item_tooltips:util/description_blacklist. Удобно для модпаков, когда нужно переопределить поведение.

Убираем подсказку про Shift

Мод может показывать сообщение "Зажми Shift", но его можно отключить для конкретных предметов через тег #item_tooltips:util/no_shift_notice. Полезно, если другой мод уже добавляет такое же сообщение.

Использование в модпаках

Item Tooltips отлично подходит как утилита для сборки. Добавил предметы в тег, написал переводы - и готово. Для загрузки своих ресурсов удобно использовать мод Simple Resource Loader.

Описания зачарований

В мод уже встроены описания для всех ванильных чар, и используются стандартные ключи переводов enchantment.мод.название.desc. Это значит, что многие чары из других модов тоже будут работать сразу - без лишних плясок.

Отличие Item Tooltips от многих аналогов: подсказки с описаниями зачарований показываются не только на предмете в инвентаре, но и прямо в экране стола зачарований. Не надо лезть в интернет, чтобы вспомнить, что даёт книжка - всё написано тут же.

Настройки для зачарований такие же гибкие: цвет, префикс, необходимость зажатия клавиши, автоотключение при обнаружении другого мода с описаниями.

Обёртывание текста

Если подсказка получается слишком длинной, мод автоматически переносит текст на следующую строку. Эта функция портирована из Adaptive Tooltips / Better Tooltips. В конфиге можно настроить максимальную длину строки как в пикселях, так и в процентах от ширины окна.

Настройка

Конфиг лежит в config/item_tooltips.json5. Если на Fabric стоит Mod Menu, можно менять настройки прямо в игре.

Прочность и скорость

• durability.durability_tooltip - как показывать прочность (ALWAYS, DAMAGED, HOLD_KEY, NONE). По умолчанию ALWAYS.
• durability.max_durability_tooltip - как показывать максимальную прочность (DAMAGED).
• durability.division_text - разделитель между текущей и максимальной прочностью (по умолчанию " / ").
• durability.color - цвет подсказки (десятичное число, например 11184810).
• mining_speed_tooltip - показывать ли скорость копания (true/false).

Описания предметов

• add_descriptions - включать описания (true).
• require_key_hold - нужно ли зажимать клавишу (true).
• key_hold_notice - показывать подсказку "зажми Shift" (true).
• color - цвет текста описания (5592405).
• prefix.text - текст перед описанием (пусто).
• prefix.align_wrapped_text - выравнивать перенесённые строки по префиксу (true).
• prefix.color - цвет префикса (13027014).

Зачарования

• enchantment_descriptions - показывать описания чар на предметах (true).
• enchanting_table_descriptions - показывать в столе зачарований (true).
• auto_disable - автоотключение при наличии другого мода (true).
• require_key_hold - нужно ли зажимать клавишу (true).
• key_hold_notice - подсказка про Shift (true).
• color, prefix.text, prefix.align_wrapped_text, prefix.color - аналогично описаниям предметов.

Обёртывание

• required_key - клавиша для показа (SHIFT, ALT, CTRL).
• wrap_text - включить обёртывание (true).
• retain_empty_space - сохранять пустое место в подсказке (true).
• length - максимальная длина в пикселях (-1 = автоматически).
• length_cap - максимальная длина в процентах от окна (50).

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

Item Tooltips можно использовать как зависимость в своём проекте. Просто добавь maven Modrinth и подключи артефакт:

repositories {
	maven { url = "https://api.modrinth.com/maven" }
}

dependencies {
	modImplementation("maven.modrinth:item-tooltips:$tooltips_version")
}

Версию указывай в gradle.properties, например tooltips_version=26.1-r2.0-fabric.