Tuning Tooltip Layout and Fade Settings in Held Item Info

Held Item Info lets you reshape how item tooltips are drawn and how long they linger, and the settings below cover line limits, spacing, offsets, and fade timing. Everything is adjusted through the mod's config interface, which opens under the Held Item Info Config title. There is no crafting step involved — you change values directly and the tooltip updates to match.

Controlling Line Count and Width

maxLines sets the ceiling on how many lines a tooltip may show. This count includes the item name itself, so a value of three means the name plus two more lines. The companion setting for characters per line is described as a maximum-ish figure — it is approximate rather than a hard cutoff. That character limit only applies to lore text and command block output; it does not constrain other tooltip content.

If you want the tooltip to reflect only what the item actually exposes, enable respectHideFlags. With it on, information suppressed by component properties stays hidden instead of being printed anyway.

Spacing, Height, and Offsets

Line height determines how tall each individual line is, measured in pixels. Increasing it spreads the text out vertically; decreasing it tightens the stack.

offsetPerExtraLine shifts all the text vertically for each additional line beyond the first. By default this behavior pulls the tooltip nearer to the hotbar as the line count grows, so longer tooltips sit lower on screen.

Name-to-line gap controls the empty space between the item name and whatever line follows it. Raising it separates the title from the body; lowering it brings them together.

Fade Timing

baseFadeDuration is the number of seconds a single-line tooltip takes to disappear. fadeDurationPerExtraLine adds extra time before the tooltip fades, applied once per additional line. Together they let a one-line tooltip vanish quickly while a long one stays readable longer.

Content Toggles Worth Knowing

Several switches decide which details appear at all, which affects how many lines you end up with:

• mergeSimilarContainerItems combines like items inside containers.
• showFireworkAttributes displays firework rocket attributes.
• showCommandBlockInfo reveals a command block's command, and maxCommandLines caps how many lines of that command are shown.
• showBeehiveContent shows what is inside a bee nest or beehive.
• showCrossbowProjectiles lists loaded crossbow projectiles.
• maxLoreLines limits how many lore lines appear.
• showPaintingDescription, showGoatHornInstrument, and showBookMeta add painting details, goat horn instrument names, and book author plus generation respectively.
• showBannerPatternName affects only Banner Pattern items, not placed banners.
• showEntityBucketContent names the entity type held in a bucket.
• showHiddenLinesCount reports how many extra lines were omitted.

Enchantment Filtering

enchantments holds your filter list, and showOnlyFilteredEnchantments decides its direction. Set it to Yes to display only the enchantments you listed; set it to No to display everything except those. In filteredEnchantments, enter identifiers such as `minecraft:silk_touch` rather than display names like Silk Touch. If the text field will not accept your entry, press TAB a few times to move focus.

Operating the Interface

Open the config screen, select a setting, and change its value. Move between fields with the corresponding hotkey configured in the controls menu, and use TAB where a text field needs focus. Adjust one value at a time and check the tooltip so you can see the effect of line height, offsets, the name gap, and fade durations before changing the next.