Changelog

v3.0.3 (2026-08-10)

• A <scroll> span is now a single unbreakable unit of layout. Multi-line scroll content garbled into overlapping tiles because the effect measured its width from the per-frame x progression, which restarts on every wrapped line, so it sized the whole marquee from the first line alone. A scroll span no longer wraps and reserves only its viewport width. Text written after </scroll> therefore starts one viewport past the marquee rather than past the entire hidden string.
• New [clamp] attribute and clampToScreen(boolean) builder method. Screen clamping stays on by default; turn it off for a message that is meant to sit partly off screen. Clamping also no longer inverts on a message larger than the window, which used to snap it to the wrong corner.
• The anvil rename limit now counts visible characters. Vanilla's 50 still applies, but markup tags no longer count toward it, so <✨>Excalibur</✨> is 9 characters rather than 28. A 256-character raw ceiling keeps a name from being padded with unlimited markup. On 1.20.1 and 1.21.1 the text field rejects an over-long name as you type; on 26.1 and 26.2 the server declines the rename, because those versions removed the text-field filter hook.
• Removed the anvil.nameMaxLength server config option. It is replaced by the rule above and needs no setting. On 1.20.1 it never worked at all, because the mixin targeted setItemName while the length constant lives in validateName.
• The continuous message effects breathe, drift, float, grow, rock, spin and vibrate take three new timing params, so they can run in bursts instead of looping forever: every (seconds between bursts, 0 for continuous), hold (seconds a burst lasts) and delay (seconds before the first burst). Each burst restarts the effect's own clock at zero, so a sine-driven effect enters and leaves at rest rather than snapping mid-swing. Existing messages are unaffected; every defaults to 0.
• <item> and <entity> now take hover and click from an enclosing <hover> or <click> tag. The parser rebuilt icon spans from scratch and dropped everything but the icon's own attributes, so wrapping an icon in <click> did nothing.
• New tooltip attribute on <item> and <entity>. tooltip=true shows the game's own tooltip for that item or entity, built from the tag's count and nbt; any other value is used as literal tooltip text.
• <hover> accepts action=show_item and action=show_entity, so ordinary text can carry an item or entity tooltip too.
• The hover region of an inline icon now matches the sprite. It was the icon's layout advance, which is deliberately 4px narrower than the 16px sprite so icons tuck into surrounding text, leaving the right edge dead. Chat is now hit-tested from the drawn sprite rather than the advance.
• Hover tooltips now work in mod GUIs, not just chat. Vanilla only hit-tests text in the handful of screens that implement it, so interactive markup in FTB Quests or any other custom UI had nothing to hook. Each interactive glyph's on-screen rect is now recorded as it is drawn and tested against the cursor in any screen, clipped to the active scissor so scrolled-out text is not hoverable. 1.20.1 and 1.21.1 only; 26.1 and 26.2 use a different text pipeline and are not covered yet.
• Fixed inline icons vanishing once they carried a hover or click event. Deriving a style through withHoverEvent/withClickEvent dropped the icon's registry id, so the tooltip appeared over empty space. This also restores icons combined with <type> and <obfuscate>, which lost them the same way.
• Fixed the hover and click region of an inline icon. Icons draw 16px wide but rode on a single space, so only about 4px responded to the cursor, and line wrapping measured them the same way.