DataTip

About

Add custom tooltips to any item with a JSON file in your resource pack. Multi-language, rich styling, conditional display — no Java required.

{ "minecraft:diamond": { "type": "text", "text": "A shiny diamond", "color": "#55FFFF" } }

Features

• 14 Content Types — text, items, 3D blocks/entities, progress bars, charts, carousels, typewriter effect, textures, images, layouts
• Rich Text — hex/named colors, bold, italic, underline, strikethrough, custom fonts
• Multi-Language — per-language text with per-language styles, no fallback
• Custom Fonts — font property for text and typewriter (e.g. minecraft:alt, minecraft:uniform)
• Live Variables (27+) — {durability}, {player_health}, {player_x/y/z}, {game_time}, {nbt:path}, and more
• Expressions — {durability > 100 ? 'Good' : 'Needs repair'}
• Color Expressions — "color": "{durability > 100 ? 'green' : 'red'}"
• Flexible Matching — exact ID, tags (#minecraft:swords), wildcards (minecraft:*_sword)
• Conditions (17 types) — filter by dimension, biome, weather, time, health, hunger, nbt, item_tag, etc.
• Shift Toggle — hide details behind a "Hold Shift" prompt
• Prepend Display — show content after item name (before original tooltip)
• Hot Reload — /reload or F3+T applies changes instantly
• Charts — bar, pie, line charts with variable support
• 3D Rendering — rotating block models, entity models, painting display
• X/Y Offset — fine-tune position with offsetX and offsetY
• Event System — pre/post render hooks, variable resolve events

Quick Start

1. Create assets/<namespace>/datatip/datatip.json in your resource pack
2. Define entries with item ID as key
3. /reload — done

Configuration

config/datatip-common.toml:

• enabled — global on/off toggle
• defaultColor — default text color (ARGB format)
• defaultLineHeight — default line height in pixels
• maxWidth — maximum tooltip width

Key bind in Controls → DataTip (default: Left Shift)

For Mod Developers

Datagen Support

// Text with styles and fonts TipContentBuilder.text("Hello", "gold", true, false, false, false) TipContentBuilder.text("Hello", "gold", "minecraft:alt") // Multi-language with styles TipContentBuilder.langText(langMap, "gold", true, false, false, false) // All content types TipContentBuilder.item("minecraft:diamond") TipContentBuilder.entity("minecraft:wolf", 48, 0, 8) TipContentBuilder.block("minecraft:stone", 48) TipContentBuilder.atlas("minecraft:apple", 32) TipContentBuilder.image("mymod:icon.png", 32, 32) TipContentBuilder.progress(0.75f, 100, "75%") TipContentBuilder.chart("bar", 100, 60, "Title", chartEntry("A", 50, "#FF0000")) TipContentBuilder.typewriter(0xFF55FF, "Line 1", "Line 2") TipContentBuilder.divider("gray", "dashed") TipContentBuilder.aligned(content, HorizontalAlign.CENTER)

Java API

// Register custom content type TipContentRegistry.registerParser("my_type", new MyContentParser()); // Register custom variable VariableResolver.registerVariable("my_var", stack -> "custom_value"); // Register custom condition ConditionChecker.registerCondition("my_condition", (value, stack, player, level) -> { return player.getAbsorptionAmount() > 0; }); // Event hooks TipEventManager.onPreRender(event -> { /* ... */ }); TipEventManager.onResolveVariable(event -> { /* ... */ }); TipEventManager.onAppendLines(event -> { /* ... */ });