Перейти к содержимому
Mineforgian

Custom Tooltip API

Data-driven tooltip text creation.

Загрузки
57K
Подписчики
0
Обновлён
22 июля 2026 г.
Лицензия
MIT

Опубликован 7 апреля 2026 г.

Исходный кодСообщить об ошибке

Custom Tooltip API

Custom Tooltip API is a powerful client-side Minecraft mod and developer library that gives you full control over item tooltips. Add custom lore, dynamic real-time data, animated gradients, and custom backgrounds, all configurable in-game or through code.

No need to code for basic usage, as it features a powerful in-game interface and full JSON support. However, it also provides a robust Developer API for those who want to inject tooltips via code.

Key Features

  • Icon Alignment: Align tooltip icons from external resource packs to the start of the line so the position stays consistent!

  • Advanced Targeting: Target specific item IDs (minecraft:diamond_sword), tag groups (#c:swords), entire mod namespaces (minecraft:*), Regex patterns (regex:.*_sword), or every item at once (*).

  • Dynamic Placeholders: Embed real-time item data directly into your text using variables like %durability%, %max_durability%, %weapon_damage%, or %enchantments%. You can also embed keybind hints using the format <key:key.jump> -> [Space].

  • Multi-line Support (Lore): Add entire paragraphs of lore or skill descriptions.

  • Visual Effects & Gradients:

    • Rainbow: Animated rainbow effect.
    • Slide Gradient: Two-color gradients that flow through the text.
    • Breathing Gradient: A smooth pulse between two colors.
    • Static Gradient & Solid: Fixed gradients or traditional solid text.
    • Colors: Hex codes (e.g. #RRGGBB), legacy codes (e.g. &d) or Minecraft color names (e.g. blue).

  • Custom Backgrounds & Borders: Solid, Gradient, Texture (Stretch), or Texture (Framed / Nine-Slice) modes with full opacity control. Drop any background image into config/custom-tooltip-api/backgrounds/ and enable it per tooltip via the dynamically generated resource pack. Supports full compatibility with Tierify custom rendering.

  • Custom Fonts: Drop any font into config/custom-tooltip-api/fonts/ and enable it per tooltip via the dynamically generated resource pack.

  • Positioning: Decide exactly where your text appears:

    • Top: Right below the item's name.
    • Bottom: At the very end of all descriptions.
    • Prepend: At the start of a specific line.
    • Append: At the end of a specific line.
    • Replace Name: Swap the item's default name for your custom text.
    • Replace Line: Replace a specific line with your custom text.
    • Replace All: Completely clear the original tooltip and show only yours.

  • Visibility Conditions: Show a tooltip only when an item is Damaged, Enchanted, or Unbreakable. Use Require Keybind mode to hide tooltips until the player holds a configurable key.

  • Text Modifiers: Full support for Bold, Italic, Underlined, Strikethrough, and O̷͍̞͐͑b̷̻̌f̶̯̈u̸̲͗͐s̶̩̬͝c̵͎̊a̸̹̟̎ẗ̴͖̿e̴̟̪͊̈́ď̴̹̪ (obfuscated) text.

In-Game Interface (GUI)

  • Manage all your tooltips directly from the Mods Menu. No need to manually edit files unless you want to.

  • Hold CTRL in the edit screen for an instant Live Preview of your tooltip.

  • Copy/paste entries to clipboard, reorder, duplicate, enable/disable, and sort by creation date or alphabetically.

For Developers (API)

Developers can use the built-in API to register tooltips and custom placeholders directly through code, with full .dynamicText() support for live per-frame data like energy, mana, or any custom NBT.

  • Check out the project's README.md file on GitHub!
  • A code example can be found here

For Modpack Creators

The mod generates a custom_tooltip_api/config.json5 file in your config folder. It fully supports code comments, making it incredibly easy to document your modpack's systems for your development team or community.

Drop custom backgrounds into config/custom-tooltip-api/backgrounds/ and custom fonts into config/custom-tooltip-api/fonts/. Enable the dynamically generated resource pack to activate them.

Dependencies

Required on all platforms:

Fabric only:

Ченджлог

5.0.2+1.21.1Релиз1.21.1 · 22 июля 2026 г.

Full Changelog

5.0.2+1.21.1

New Features

  • Added a new slider in the background editing screen that allows backgrounds to be scaled in 5% intervals. This only applies to the Texture (Framed) and Texture (Repeating) background types.

5.0.1+1.21.1

New Features

  • Added an automatic fallback rendering pipeline for background textures. CTA can now render external GUI textures directly using raw texture identifiers, even if they aren't stitched into Minecraft's block atlas or if the autogenerated resource pack is disabled.
  • Added seamless color integration with Legendary Tooltips. Custom top border colors defined in CTA now automatically synchronize with Legendary Tooltips' item title separator and 3D item model box.
  • Updated localization files for all supported languages.

Dependencies & Technical Updates

  • Updated S-Lib dependency to 1.0.5
5.0.2+1.21.1Релиз1.21.1 · 22 июля 2026 г.

Full Changelog

5.0.2+1.21.1

New Features

  • Added a new slider in the background editing screen that allows backgrounds to be scaled in 5% intervals. This only applies to the Texture (Framed) and Texture (Repeating) background types.

5.0.1+1.21.1

New Features

  • Added an automatic fallback rendering pipeline for background textures. CTA can now render external GUI textures directly using raw texture identifiers, even if they aren't stitched into Minecraft's block atlas or if the autogenerated resource pack is disabled.
  • Added seamless color integration with Legendary Tooltips. Custom top border colors defined in CTA now automatically synchronize with Legendary Tooltips' item title separator and 3D item model box.
  • Updated localization files for all supported languages.

Dependencies & Technical Updates

  • Updated S-Lib dependency to 1.0.5
5.0.2+1.20.1Релиз1.20.1 · 22 июля 2026 г.

Full Changelog

5.0.2+1.20.1

New Feature

  • Added a new slider in the background editing screen that allows backgrounds to be scaled in 5% intervals. This only applies to the Texture (Framed) and Texture (Repeating) background types.
5.0.2+1.20.1Релиз1.20.1 · 22 июля 2026 г.

Full Changelog

5.0.2+1.20.1

New Feature

  • Added a new slider in the background editing screen that allows backgrounds to be scaled in 5% intervals. This only applies to the Texture (Framed) and Texture (Repeating) background types.
5.0.1+1.20.1Релиз1.20.1 · 22 июля 2026 г.

Full Changelog

5.0.1+1.20.1

New Features

  • Added an automatic fallback rendering pipeline for background textures. CTA can now render external GUI textures directly using raw texture identifiers, even if they aren't stitched into Minecraft's block atlas or if the autogenerated resource pack is disabled.
  • Added seamless color integration with Legendary Tooltips. Custom top border colors defined in CTA now automatically synchronize with Legendary Tooltips' item title separator and 3D item model box.
  • Updated localization files for all supported languages.

Dependencies & Technical Updates

  • Updated S-Lib dependency to 1.0.5
5.0.1+1.20.1Релиз1.20.1 · 22 июля 2026 г.

Full Changelog

5.0.1+1.20.1

New Features

  • Added an automatic fallback rendering pipeline for background textures. CTA can now render external GUI textures directly using raw texture identifiers, even if they aren't stitched into Minecraft's block atlas or if the autogenerated resource pack is disabled.
  • Added seamless color integration with Legendary Tooltips. Custom top border colors defined in CTA now automatically synchronize with Legendary Tooltips' item title separator and 3D item model box.
  • Updated localization files for all supported languages.

Dependencies & Technical Updates

  • Updated S-Lib dependency to 1.0.5
5.0.0+1.21.1Релиз1.21.1 · 18 июля 2026 г.

Full Changelog

5.0.0+1.21.1

This release introduces native dynamic translation support and a major structural refactoring of the API.

BREAKING: API CHANGES

  • If you're a developer, please read the entire changelog in GitHub.

New Features

  • Added native Translation Key support! You can now use the <translate:your.translation.key> block directly inside your custom text.
  • Tooltips using translation keys will instantly update if the player changes their language in the Minecraft settings menu.
  • Added full support for Animated Tooltip Backgrounds! You can now place .png.mcmeta files alongside your custom backgrounds in the backgrounds folder, and they will be displayed as native animated textures.
  • Added a new configuration file external_backgrounds.json5. This allows users to cleanly add external textures (or scan entire folders) from other mods or resource packs directly into the GUI dropdown for custom background selection.

Fixes & Optimizations

  • Optimized resource pack generation: Custom textures and fonts are no longer aggressively rewritten to disk on every startup if they already exist, significantly reducing I/O operations
  • Cleaned up internal background rendering code
5.0.0+1.21.1Релиз1.21.1 · 18 июля 2026 г.

Full Changelog

5.0.0+1.21.1

This release introduces native dynamic translation support and a major structural refactoring of the API.

BREAKING: API CHANGES

  • If you're a developer, please read the entire changelog in GitHub.

New Features

  • Added native Translation Key support! You can now use the <translate:your.translation.key> block directly inside your custom text.
  • Tooltips using translation keys will instantly update if the player changes their language in the Minecraft settings menu.
  • Added full support for Animated Tooltip Backgrounds! You can now place .png.mcmeta files alongside your custom backgrounds in the backgrounds folder, and they will be displayed as native animated textures.
  • Added a new configuration file external_backgrounds.json5. This allows users to cleanly add external textures (or scan entire folders) from other mods or resource packs directly into the GUI dropdown for custom background selection.

Fixes & Optimizations

  • Optimized resource pack generation: Custom textures and fonts are no longer aggressively rewritten to disk on every startup if they already exist, significantly reducing I/O operations
  • Cleaned up internal background rendering code

Комментарии

Загружаем…