Item Tooltips

Item Tooltips

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

Мод совместим с Fabric и Neoforge.

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

Добавление описаний

Для добавления описания к предмету достаточно включить его в тег #item_tooltips:has_description. Ключ перевода формируется путем добавления суффикса ".desc" к оригинальному названию предмета, что соответствует стандартной практике для модов с описаниями зачарований.

Например, для тотема бессмертия с идентификатором item.minecraft.totem_of_undying ключ перевода описания будет item.minecraft.totem_of_undying.desc.

Исключение описаний

Предметы, добавленные в тег #item_tooltips:util/description_blacklist, не будут отображать описания, независимо от других настроек. Эта функция особенно полезна разработчикам модпаков.

Отключение уведомлений о Shift

Для предметов в теге #item_tooltips:util/no_shift_notice не будет отображаться подсказка о необходимости удерживать Shift, даже если эта опция включена в настройках мода. Это полезно для предметов, которые уже имеют подобные уведомления от других модов.

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

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

Примеры структуры датапаков и ресурспаков доступны по ссылке.

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

Мод включает описания для всех стандартных зачарований Minecraft и использует общепринятый формат ключей перевода enchantment.namespace.item_name.desc, что обеспечивает совместимость со многими модифицированными зачарованиями без дополнительной настройки.

В отличие от аналогичных модов, Item Tooltips отображает описания зачарований как в инвентаре, так и непосредственно в интерфейсе стола зачарований.

Перенос текста

Мод автоматически переносит длинный текст на новую строку, если он не помещается в отведенное пространство. Эта функция была портирована из модов Adaptive Tooltips и Better Tooltips.

Настройки

Все параметры мода настраиваются через файл конфигурации config/item_tooltips.json5. При установленном Mod Menu на Fabric настройки можно изменять непосредственно в игре.

Основные параметры описаний

• add_descriptions - включение/отключение описаний предметов (по умолчанию: true)
• require_shift - необходимость удерживать Shift для показа описаний (по умолчанию: true)
• shift_notice - отображение подсказки о необходимости Shift (по умолчанию: true)
• color - цвет текста описаний в десятичном формате (по умолчанию: 5592405)
• prefix - префикс перед описанием (по умолчанию: пусто)
• prefix_wrapping - повторение префикса при переносе текста (по умолчанию: false)
• prefix_color - цвет префикса (по умолчанию: 13027014)

Параметры зачарований

• enchantment_descriptions - включение описаний зачарований (по умолчанию: true)
• enchanting_table_descriptions - отображение описаний в столе зачарований (по умолчанию: true)
• auto_disable - автоматическое отключение при обнаружении конфликтующих модов (по умолчанию: true)
• require_shift - необходимость Shift для описаний зачарований (по умолчанию: true)
• shift_notice - подсказка о Shift для зачарований (по умолчанию: false)
• color - цвет текста описаний зачарований (по умолчанию: 5592405)
• prefix - префикс для описаний зачарований (по умолчанию: пробел)
• prefix_wrapping - повторение префикса при переносе (по умолчанию: true)
• prefix_color - цвет префикса зачарований (по умолчанию: 13027014)

Настройки подсказок

• wrap_text - включение переноса текста (по умолчанию: true)
• length - максимальная длина строки перед переносом (по умолчанию: -1)
• length_cap - процент ширины экрана для ограничения длины (по умолчанию: 50)

Интеграция с другими модами

Разработчики могут интегрировать Item Tooltips в свои проекты. Необходимо добавить соответствующие зависимости в файлы конфигурации проекта.

build.gradle

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

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

gradle.properties

tooltips_version=1.21.1-v1.3.0-fabric