Item Tooltips

A simple, configurable mod which allows you to dynamically add item descriptions to any vanilla or modded item. Further, Item Tooltips has fully customisable enchantment descriptions, that are visible both on item tooltips & in the enchanting table.

Available for both Fabric & Neoforge.

Item Descriptions

Adding Item Descriptions

Simply add any blocks / items you'd like to add descriptions to to the #item_tooltips:has_description tag. The translation keys simply add a ".desc" onto the end of the original item name, as with other existing enchantment description mods.

For example, the description translation key for the Totem of Undying, if tagged in #item_tooltips:has_description, would be item.minecraft.totem_of_undying.desc

Blacklisting Item Descriptions

Any item added to the item tag #item_tooltips:util/description_blacklist will be excluded from having a description, regardless of other tags. Particularly useful for modpack developers.

Removing Shift Notices

Any item added to the item tag #item_tooltips:util/no_shift_notice will not have a shift notice, regardless of the mod config. This is particularly useful for adding tooltips to items which already have a shift notice added by another mod.

Details on description configuration options can be found further below.

Use in Modpacks

Item Tooltips can serve as a handy utility mod for modpack development. Simply add any items you want to the tag, write a translation, and you're good to go! For this purpose, I'd suggest a mod such as Simple Resource Loader in order to load your custom data/resources.

An example datapack and resourcepack format can be found here.

Enchantment Descriptions

Comes with enchantment descriptions for all vanilla enchantments, and uses the common enchantment.namespace.item_name.desc language key, which means many modded enchantments will work out-of-the-box.

Unlike many other enchantment description mods, Item Tooltips applies its tooltips to both the item and the enchanting table screen.

As with all other modules of this project, enchantment descriptions are fully configurable.

Wrapping Text

Item Tooltips adds text wrapping (ported from Adaptive Tooltips / Better Tooltips), which automatically moves descriptions to the next line should text get too long.

Details on tooltip configuration options can be found further below.

Configuration

Item Tooltips has a configuration file located at config/item_tooltips.json5

If Mod Menu is installed on Fabric, you can also edit the config file in-game.

Descriptions

add_descriptions - defaults to true. Dictates whether item descriptions are added to tagged blocks / items. This can be disabled should you only want the tooltip wrapping functionality.

require_shift - defaults to true. Indicates whether or not the shift key must be held for item descriptions to be shown.

shift_notice - defaults to true. Indicates whether or not there should be a small tooltip indicating to the player to hold the shift key on items with a description.

color - the decimal colour value of displayed tooltips. The default value is 5592405

prefix - empty by default, the contents of this string are added before any description, for example, this could be used to add indentation or a plus symbol before all item descriptions.

prefix_wrapping - defaults to false. Whether the prefix should be repeated on every new line if the tooltip is wrapped.

prefix_color - the decimal color value of displayed tooltip prefixes. The default value is 13027014

If you'd like help picking colors, a good hexadecimal to decimal converter can be found here.

Enchantments

enchantment_descriptions - defaults to true. Dictates whether enchantment descriptions are added to all enchanted items.

enchanting_table_descriptions - defaults to true. Dictates whether enchantment descriptions are added to enchantments in the enchanting table. These show up regardless of whether the player is holding shift, and are not affected by the auto_disable option.

auto_disable - defaults to true. Dictates whether enchantment descriptions for items should be automatically disabled if another mod which adds enchantment descriptions is detected.

require_shift - defaults to true. Indicates whether or not the shift key must be held for enchantment descriptions to be shown.

shift_notice - defaults to false. Indicates whether or not there should be a small tooltip indicating to the player to hold the shift key on enchanted items.

color - the decimal colour value of displayed enchantment tooltips. The default value is 5592405

prefix - by default a simple " ", the contents of this string are added before all enchantment descriptions.

prefix_wrapping - defaults to true. Whether the prefix should be repeated on every new line if the enchantment tooltip is wrapped.

prefix_color - the decimal color value of displayed enchantment tooltip prefixes. The default value is 13027014

If you'd like help picking colors, a good hexadecimal to decimal converter can be found here.

Tooltips

wrap_text - defaults to true. Whether text should be wrapped. You can disable this if you have another mod which handles text wrapping.

length - a static number value which dictates the maximum length of a tooltip before wrapping. When disabled, wrapping relies solely on the length cap. Defaults to -1

length_cap - the percentage length of the game window a tooltip will cover before wrapping. This also serves to cap the static length config value, should it get too long. Defaults to 50

Depending in a Mod

You may depend on / integrate with Item Tooltips within your own projects. Make sure to change the version number and modloader to the correct ones in your gradle.properties

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