Item Tooltips

Item Tooltips

Цель Item Tooltips — стать самым полным решением для распространённых потребностей игроков, сборок модов и разработчиков модов в отношении подсказок. Поэтому в этом моде содержится множество новых функций подсказок — от прочности до атрибутов, от пользовательских описаний предметов до описаний зачарований и многого другого. Item Tooltips уделяет большое внимание настраиваемости, позволяя вам легко создавать пользовательские визуальные стили для каждой функции в объёме, который часто не предоставляется другими проектами, — через пользовательские цвета, стили текста и другое, что можно менять индивидуально для каждой функции.

О, и у нас также есть настраиваемый перенос подсказок, чтобы всё вышеперечисленное помещалось.

Подсказки прочности и атрибутов

Подсказки прочности

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

Скорость добычи

По умолчанию добавляется зелёная подсказка атрибута для скорости добычи инструмента, соответствующая подсказкам урона и скорости атаки, присутствующим в ванили. Хотя мы можем отфильтровать большинство предметов, у которых не должно быть этой подсказки, есть дополнительный тег предметов (#item_tooltips:hidden_mining_speed), который можно использовать, чтобы запретить указанным предметам отображать скорость добычи.

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

Добавление описаний предметов

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

Например, ключ перевода описания для Totem of Undying, если он добавлен в тег #item_tooltips:has_description, будет item.minecraft.totem_of_undying.desc

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

Чёрный список описаний предметов

Любой предмет, добавленный в тег предметов #item_tooltips:util/description_blacklist, будет исключён из получения описания, независимо от других тегов. Особенно полезно для разработчиков сборок модов.

Удаление уведомлений о Shift

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

Подробности о параметрах конфигурации описаний можно найти ниже.

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

Item Tooltips может служить удобным утилитарным модом для разработки сборок модов. Просто добавьте любые предметы в тег, напишите перевод — и всё готово! Для этой цели я бы посоветовал такой мод, как Simple Resource Loader, чтобы загружать ваши пользовательские данные/ресурсы.

Пример формата датапака и ресурспака можно найти здесь.

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

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

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

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

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

Item Tooltips добавляет перенос текста (портировано из Adaptive Tooltips / Better Tooltips), который автоматически переносит описания на следующую строку, если текст становится слишком длинным.

Подробности о параметрах настройки подсказок можно найти ниже.

Настройка

У Item Tooltips есть файл конфигурации по пути config/item_tooltips.json5

Если на Fabric установлен Mod Menu, вы также можете редактировать файл конфигурации прямо в игре.

Предметы

enum DurabilityTooltip {
  ALWAYS, // always shows the tooltip
  DAMAGED, // only shows the tooltip when the item is not at full durability
  HOLD_KEY, // only shows the tooltip when the specified key is held
  NONE // disables the feature entirely
}

durability.durability_tooltip — по умолчанию ALWAYS. Как должна отображаться прочность, согласно перечислению DurabilityToolip

durability.max_durability_tooltip — по умолчанию DAMAGED. Как должна отображаться максимальная прочность, согласно перечислению DurabilityToolip

durability.division_text — по умолчанию /. Что должно стоять между текущей и максимальной прочностью

durability.color — по умолчанию 11184810. Цвет, используемый для подсказки прочности — за единственным исключением текущего значения прочности, которое использует цвет полосы прочности

mining_speed_tooltip — показывать ли подсказку скорости добычи. Использует тот же стиль, что и ванильные подсказки урона и скорости атаки. По умолчанию true

Описания

add_descriptions — по умолчанию true. Определяет, добавляются ли описания предметов к блокам / предметам с тегами. Это можно отключить, если вам нужна только функция переноса подсказок.

require_key_hold — по умолчанию true. Указывает, нужно ли удерживать заданную клавишу для отображения описаний предметов.

key_hold_notice — по умолчанию true. Указывает, должна ли отображаться небольшая подсказка, сообщающая игроку о необходимости удерживать shift на предметах с описанием.

color — десятичное значение цвета отображаемых подсказок. Значение по умолчанию — 5592405

prefix.text — по умолчанию пусто, содержимое этой строки добавляется перед любым описанием, например, это можно использовать для добавления отступа или символа плюса перед всеми описаниями предметов.

prefix.align_wrapped_text — по умолчанию true. Должны ли перенесённые строки текста выравниваться по заданному префиксу

prefix.color — десятичное значение цвета отображаемых префиксов подсказок. Значение по умолчанию — 13027014

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

Зачарования

enchantment_descriptions — по умолчанию true. Определяет, добавляются ли описания зачарований ко всем зачарованным предметам.

enchanting_table_descriptions — по умолчанию true. Определяет, добавляются ли описания зачарований к зачарованиям в столе зачаровывания. Они отображаются независимо от того, удерживает ли игрок shift, и на них не влияет параметр auto_disable.

auto_disable — по умолчанию true. Определяет, должны ли описания зачарований для предметов автоматически отключаться, если обнаружен другой мод, добавляющий описания зачарований.

require_key_hold — по умолчанию true. Указывает, нужно ли удерживать заданную клавишу для отображения описаний зачарований.

key_hold_notice — по умолчанию true. Указывает, должен ли отображаться небольшой тултип, подсказывающий игроку зажать клавишу Shift на зачарованных предметах.

color — десятичное значение цвета отображаемых тултипов зачарований. Значение по умолчанию — 5592405

prefix.text — по умолчанию простой " ", содержимое этой строки добавляется перед всеми описаниями зачарований.

prefix.align_wrapped_text — по умолчанию true. Должны ли перенесённые строки текста выравниваться по установленному префиксу

prefix.color — десятичное значение цвета отображаемых префиксов тултипов зачарований. Значение по умолчанию — 13027014

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

Тултипы

required_key — по умолчанию SHIFT. Определяет, какую клавишу нужно удерживать для отображения связанных тултипов. Может быть SHIFT, ALT или CTRL

wrap_text — по умолчанию true. Должен ли текст переноситься. Вы можете отключить это, если у вас есть другой мод, который занимается переносом текста.

retain_empty_space — должен ли применяться фикс, чтобы принудительно не давать ванильному пространству тултипа исчезать. По умолчанию true

length — статическое числовое значение, задающее максимальную длину тултипа перед переносом. Когда отключено, перенос полагается исключительно на ограничение длины. По умолчанию -1

length_cap — процентная длина окна игры, которую тултип будет занимать перед переносом. Это также служит ограничением для статического значения длины, если оно окажется слишком большим. По умолчанию 50

Зависимость от мода

Вы можете зависеть от Item Tooltips / интегрировать его в свои проекты. Убедитесь, что изменили номер версии и загрузчик модов на правильные в вашем gradle.properties

build.gradle

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