DataTip

JSON-driven custom item tooltips for Minecraft. Define tooltips in resource packs at assets/<modid>/datatip/datatip.json.

Quick Start

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

Put this in a resource pack at assets/minecraft/datatip/datatip.json, then hover a diamond in-game. That's it.

Content Types

Type	Description	Example
`text`	Text content	`{"type": "text", "text": "Hello", "color": "white"}`
`item`	Item icon	`{"type": "item", "item": "minecraft:diamond", "size": 32}`
`block`	3D block	`{"type": "block", "block": "minecraft:stone", "size": 48}`
`entity`	3D entity	`{"type": "entity", "entity": "minecraft:wolf", "size": 48}`
`progress`	Progress bar	`{"type": "progress", "progress": 0.75, "width": 100}`
`carousel`	Carousel container	`{"type": "carousel", "intervalSeconds": 3, "frames": [...]}`
`typewriter`	Typewriter effect	`{"type": "typewriter", "lines": ["Typing..."]}`
`atlas`	Texture rendering	`{"type": "atlas", "item": "minecraft:apple", "size": 32}`
`image`	Image	`{"type": "image", "texture": "mymod:gui/icon.png"}`
`chart`	Chart	`{"type": "chart", "chartType": "bar", "entries": [...]}`
`vbox`	Vertical layout	`{"type": "vbox", "gap": 4, "children": [...]}`
`hbox`	Horizontal layout	`{"type": "hbox", "gap": 8, "children": [...]}`
`divider`	Divider line	`{"type": "divider", "color": "#555555"}`
`spacer`	Spacing	`{"type": "spacer", "height": 8}`

Content Type Details

text

Text content with rich styling options.

{
  "type": "text",
  "text": "Hello World",
  "color": "#55FFFF",
  "bold": true,
  "align": "center"
}

item

Render item icon in tooltip.

{
  "type": "item",
  "item": "minecraft:diamond",
  "size": 32,
  "offsetY": 4
}

block

Render 3D block model with auto-rotation.

{
  "type": "block",
  "block": "minecraft:chest",
  "size": 48,
  "autoRotate": true
}

entity

Render 3D entity model with auto-rotation.

{
  "type": "entity",
  "entity": "minecraft:wolf",
  "size": 48,
  "autoRotate": true,
  "offsetY": 8
}

progress

Progress bar with multiple styles.

{
  "type": "progress",
  "progress": 0.75,
  "width": 100,
  "height": 8,
  "style": "gradient",
  "showLabel": true,
  "label": "75%",
  "labelAlign": "right"
}

carousel

Auto-switching multi-frame display.

{
  "type": "carousel",
  "intervalSeconds": 3,
  "frames": [
    {"type": "text", "text": "Frame 1"},
    {"type": "text", "text": "Frame 2"}
  ]
}

typewriter

Animated text reveal effect.

{
  "type": "typewriter",
  "lines": ["Hello", "World"],
  "charsPerSecond": 10,
  "pauseSeconds": 1,
  "loop": false
}

Multi-language typewriter:

{
  "type": "typewriter",
  "lines": {
    "zh_cn": ["你好", "世界"],
    "en_us": ["Hello", "World"]
  },
  "bold": true,
  "color": "gold"
}

atlas

Render texture from atlas (item/block ID auto-converts).

{
  "type": "atlas",
  "item": "minecraft:apple",
  "size": 32
}

image

Render custom texture image.

{
  "type": "image",
  "texture": "mymod:textures/gui/icon.png",
  "width": 32,
  "height": 32
}

chart

Bar, pie, or line chart with variable support.

{
  "type": "chart",
  "chartType": "bar",
  "width": 100,
  "height": 60,
  "entries": [
    {"label": "X", "value": "{player_x}", "color": "#FF5555"},
    {"label": "Y", "value": "{player_y}", "color": "#55FF55"}
  ]
}

vbox / hbox

Vertical/horizontal layout containers.

{
  "type": "vbox",
  "gap": 4,
  "children": [...]
}

divider

Divider line with multiple styles.

{
  "type": "divider",
  "color": "#555555",
  "style": "dashed"
}

spacer

Empty spacing between content.

{
  "type": "spacer",
  "height": 8
}

Text Properties

Property	Type	Default	Description
`text`	String/Object	-	Text content (supports multi-language object)
`color`	String	"white"	Color (named or hex, supports expressions)
`font`	String	-	Custom font (e.g. `minecraft:alt`, `minecraft:uniform`)
`align`	String	"left"	Alignment: `left`, `center`, `right`
`bold`	boolean	false	Bold text
`italic`	boolean	false	Italic text
`underlined`	boolean	false	Underlined text
`strikethrough`	boolean	false	Strikethrough text
`shift`	boolean	false	Only show when holding Shift
`maxWidth`	int	0	Maximum width (0=no wrap)

Progress Bar Properties

Property	Type	Default	Description
`progress`	float	0.0	Progress value (0.0-1.0)
`width`	int	100	Width
`height`	int	8	Height
`colorFg`	String	"#55FF55"	Foreground color
`colorBg`	String	"#333333"	Background color
`style`	String	"gradient"	Style: `flat`, `gradient`, `segmented`, `animated`
`showLabel`	boolean	false	Show label
`label`	String	-	Custom label text
`labelAlign`	String	"left"	Label alignment: `left`, `center`, `right`

Divider Properties

Property	Type	Default	Description
`color`	String	"#555555"	Color
`style`	String	"solid"	Style: `solid`, `dashed`, `dotted`
`width`	int	0	Width (0=fill)
`widthMode`	String	"fill"	Mode: `fill`, `fixed`, `centered`

Carousel Properties

Property	Type	Default	Description
`frames`	Array	-	Content frames array
`intervalSeconds`	int	3	Frame switch interval (seconds)

Typewriter Properties

Property	Type	Default	Description
`lines`	Array/Object	-	Text lines array (supports multi-language object)
`charsPerSecond`	int	2	Characters per second
`pauseSeconds`	int	1	Pause between lines (seconds)
`loop`	boolean	false	Loop animation
`color`	String	"white"	Text color
`font`	String	-	Custom font
`bold`	boolean	false	Bold text
`italic`	boolean	false	Italic text
`underlined`	boolean	false	Underlined text
`strikethrough`	boolean	false	Strikethrough text
`align`	String	"left"	Alignment: `left`, `center`, `right`
`shadow`	boolean	true	Text shadow
`lineHeight`	int	12	Line height in pixels
`shift`	boolean	false	Only show when holding Shift

Chart Properties

Property	Type	Default	Description
`chartType`	String	"bar"	Chart type: `bar`, `pie`, `line`
`width`	int	100	Width
`height`	int	60	Height
`title`	String	-	Title
`entries`	Array	-	Data entries array
`titleColor`	String	"#FFFFFF"	Title color
`labelColor`	String	"#AAAAAA"	Label color
`valueColor`	String	"#FFFFFF"	Value color
`zeroLineColor`	String	"#888888"	Zero line color (for positive/negative)

Entity/Item/Block/Atlas/Image Common Properties

Property	Type	Default	Description
`offsetX`	int	0	X-axis offset (positive=right, negative=left)
`offsetY`	int	0	Y-axis offset (positive=down, negative=up)

Variables

Variable	Description
`{durability}`	Current durability
`{max_durability}`	Maximum durability
`{damage}`	Damage value
`{durability_percent}`	Durability percentage
`{durability_bar}`	Durability bar (visual)
`{count}`	Item count
`{item_name}`	Item name
`{item_id}`	Item ID
`{enchantment_count}`	Enchantment count
`{is_enchanted}`	Is enchanted
`{rarity}`	Rarity
`{max_stack_size}`	Max stack size
`{is_stackable}`	Is stackable
`{is_damageable}`	Is damageable
`{player_health}`	Player health
`{player_max_health}`	Player max health
`{player_hunger}`	Player hunger
`{player_experience}`	Player experience level
`{player_x}`	Player X coordinate
`{player_y}`	Player Y coordinate
`{player_z}`	Player Z coordinate
`{game_time}`	Game time
`{is_day}`	Is daytime
`{is_raining}`	Is raining
`{is_thundering}`	Is thundering
`{health_bar}`	Health bar (visual)
`{nbt:path}`	Component value (see NBT Variable section below)

NBT Variable

Read item component data using {nbt:path} syntax.

NeoForge 1.21.1 (Component System):

{
  "type": "text",
  "text": "Name: {nbt:custom_name}",
  "color": "white"
}

Supported paths:

custom_name - Custom item name
item_name - Item name
lore - Item lore
damage - Damage value
max_damage - Max damage
enchantments - Enchantments

Forge 1.20.1 (NBT System):

{
  "type": "text",
  "text": "Name: {nbt:display.Name}",
  "color": "white"
}

Supported paths:

display.Name - Custom item name
display.Lore - Item lore
Damage - Damage value
Enchantments - Enchantments

Conditions

Condition	Description	Example
`dimension`	Dimension	`"dimension": "minecraft:the_nether"`
`biome`	Biome	`"biome": "minecraft:desert"`
`holding`	Held item	`"holding": "minecraft:diamond_sword"`
`sneaking`	Is sneaking	`"sneaking": true`
`creative`	Creative mode	`"creative": true`
`survival`	Survival mode	`"survival": true`
`health`	Health	`"health": "50%"` or `"health": 10`
`hunger`	Hunger	`"hunger": 15`
`experience`	Experience level	`"experience": 30`
`time`	Time	`"time": "day"` or `"time": 6000`
`weather`	Weather	`"weather": "rain"`
`light`	Light level	`"light": "dark"` or `"light": 8`
`altitude`	Altitude	`"altitude": ">=64"`
`enchanted`	Is enchanted	`"enchanted": true`
`damage`	Damage value	`"damage": 100`
`count`	Item count	`"count": 16`
`nbt`	Component exists	`"nbt": "custom_name"`
`item_tag`	Item tag	`"item_tag": "minecraft:swords"`

NBT Condition

Check if item has specific component/NBT data.

NeoForge 1.21.1:

{
  "conditions": {
    "nbt": "custom_name"
  }
}

Forge 1.20.1:

{
  "conditions": {
    "nbt": "display.Name"
  }
}

Item Tag Condition

Check if item belongs to a specific tag.

{
  "conditions": {
    "item_tag": "minecraft:swords"
  }
}

Expressions

Supports expressions in text and color:

{
  "type": "text",
  "text": "Status: {durability > 100 ? 'Good' : 'Needs repair'}",
  "color": "{durability > 100 ? 'green' : 'red'}"
}

Supported operators:

Comparison: >, <, ==, !=, >=, <=
Logic: &&, ||, !
Arithmetic: +, -, *, /
Ternary: condition ? true_value : false_value

Multi-language

{
  "type": "text",
  "text": {
    "zh_cn": "你好世界",
    "en_us": "Hello World"
  },
  "color": "aqua"
}

Special Properties

Property	Description
`align`	Alignment: `left`, `center`, `right` (works on all content types)
`shift`	Only show when holding Shift
`prepend`	Show after item name (before original content)
`conditions`	Conditions configuration

Colors

Named Colors

Color	Hex
black	#000000
dark_blue	#0000AA
dark_green	#00AA00
dark_aqua	#00AAAA
dark_red	#AA0000
dark_purple	#AA00AA
gold	#FFAA00
gray/grey	#AAAAAA
dark_gray/dark_grey	#555555
blue	#5555FF
green	#55FF55
aqua	#55FFFF
red	#FF5555
light_purple	#FF55FF
yellow	#FFFF55
white	#FFFFFF

Hex Colors

Any 6-digit hex with # prefix: "#FF6600", "#AABBCC", "#00FF00"

Configuration

File: config/datatip-common.toml

Option	Type	Default	Description
`enabled`	boolean	true	Enable/disable DataTip
`defaultColor`	int	0xFFAAAAAA	Default text color
`defaultLineHeight`	int	12	Default line height
`maxWidth`	int	200	Maximum tooltip width

Legacy Format Support

Old format is automatically converted to new format. The converted JSON is saved to .minecraft/datatip_converted/ directory.

Supported old format:

{
  "minecraft:diamond": ["Line 1", "Line 2"],
  "minecraft:diamond_sword": {
    "text": {"zh_cn": ["Sharp"], "en_us": ["Sharp"]},
    "color": "gold",
    "shift": true
  }
}

Converted output:

.minecraft/datatip_converted/
  └── confluence/
      └── datatip/
          └── datatip.json

Complete Example

{
  "minecraft:diamond": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Diamond", "color": "#55FFFF", "align": "center"},
      {"type": "divider", "color": "#555555", "widthMode": "centered", "width": 80},
      {"type": "text", "text": "A precious gem", "color": "gray", "align": "center"},
      {"type": "spacer", "height": 4},
      {"type": "text", "text": "Left aligned", "color": "white", "align": "left"},
      {"type": "text", "text": "Centered", "color": "gold", "align": "center"},
      {"type": "text", "text": "Right aligned", "color": "aqua", "align": "right"}
    ]
  },

  "minecraft:diamond_sword": {
    "type": "hbox",
    "gap": 8,
    "children": [
      {"type": "item", "item": "minecraft:diamond_sword", "size": 32},
      {"type": "vbox", "gap": 2, "children": [
        {"type": "text", "text": "Diamond Sword", "color": "aqua", "align": "center"},
        {"type": "text", "text": "Durability: {durability}/{max_durability}", "color": "gray"},
        {"type": "text", "text": "Percent: {durability_percent}%", "color": "gold"}
      ]}
    ]
  },

  "minecraft:diamond_pickaxe": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Diamond Pickaxe", "color": "aqua", "align": "center"},
      {"type": "progress", "progress": 0.75, "width": 100, "height": 6, "colorFg": "#55FF55", "showLabel": true, "label": "75%", "labelAlign": "right"},
      {"type": "progress", "progress": 0.5, "width": 100, "height": 8, "style": "segmented"},
      {"type": "progress", "progress": 0.9, "width": 100, "height": 6, "colorFg": "#FFD700", "animated": true, "animSpeed": 3}
    ]
  },

  "minecraft:golden_apple": {
    "type": "carousel",
    "intervalSeconds": 10,
    "frames": [
      {"type": "vbox", "gap": 2, "children": [
        {"type": "text", "text": "Golden Apple", "color": "gold", "align": "center"},
        {"type": "text", "text": "Restores health", "color": "red"}
      ]},
      {"type": "vbox", "gap": 2, "children": [
        {"type": "text", "text": "Golden Apple", "color": "gold", "align": "center"},
        {"type": "text", "text": "Restores health", "color": "red"}
      ]},
      {"type": "vbox", "gap": 2, "children": [
        {"type": "text", "text": "Golden Apple", "color": "gold", "align": "center"},
        {"type": "text", "text": "Restores health", "color": "red"}
      ]}
    ]
  },

  "minecraft:nether_star": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Nether Star", "color": "light_purple", "align": "center"},
      {"type": "typewriter", "lines": ["Boss drop", "Used for beacon", "Rare item"], "charsPerSecond": 10, "pauseSeconds": 1, "color": "gray"}
    ]
  },

  "minecraft:stone": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Stone", "color": "gray"},
      {"type": "divider", "color": "#555555", "style": "solid"},
      {"type": "text", "text": "Above solid line", "color": "white"},
      {"type": "divider", "color": "#555555", "style": "dashed"},
      {"type": "text", "text": "Above dashed line", "color": "white"},
      {"type": "divider", "color": "#555555", "style": "dotted"},
      {"type": "text", "text": "Above dotted line", "color": "white"}
    ]
  },

  "minecraft:bow": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Durability: {durability}/{max_durability}", "color": "gray"},
      {"type": "text", "text": "Percent: {durability_percent}%", "color": "gold"},
      {"type": "text", "text": "Durability bar: {durability_bar}", "color": "green"},
      {"type": "text", "text": "Health bar: {health_bar}", "color": "red"}
    ]
  },

  "minecraft:iron_ingot": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Iron Ingot", "color": "white", "align": "center"},
      {"type": "divider", "color": "#555555", "widthMode": "centered", "width": 60},
      {"type": "text", "text": "Health: {player_health}/{player_max_health}", "color": "red"},
      {"type": "text", "text": "Hunger: {player_hunger}", "color": "gold"},
      {"type": "text", "text": "Experience: {player_experience}", "color": "green"}
    ]
  },

  "minecraft:clock": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Time: {game_time}", "color": "gold"},
      {"type": "text", "text": "Daytime: {is_day}", "color": "yellow"},
      {"type": "text", "text": "Raining: {is_raining}", "color": "aqua"},
      {"type": "text", "text": "Thundering: {is_thundering}", "color": "red"}
    ]
  },

  "#minecraft:swords": {
    "type": "text",
    "text": "All swords", "color": "yellow"
  },

  "minecraft:diamond_block": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Diamond Block", "color": "aqua", "align": "center"},
      {"type": "text", "text": "Only in Nether", "color": "dark_red"}
    ],
    "conditions": {
      "dimension": "minecraft:the_nether"
    }
  },

  "minecraft:emerald_block": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Emerald Block", "color": "green"},
      {"type": "text", "text": "Hold Shift to see this", "color": "gray", "shift": true}
    ]
  },

  "minecraft:gold_block": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Gold Block", "color": "gold"},
      {"type": "text", "text": "Hold Shift for full tooltip", "color": "gray"},
      {"type": "text", "text": "All content will be folded", "color": "yellow"}
    ],
    "shift": true
  },

  "minecraft:iron_block": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Iron Block", "color": "white"},
      {"type": "text", "text": "This shows after item name", "color": "gray"}
    ],
    "prepend": true
  },

  "minecraft:enchanted_golden_apple": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Enchanted Golden Apple", "color": "gold", "bold": true, "align": "center"},
      {"type": "divider", "color": "#FFD700", "widthMode": "centered", "width": 80},
      {"type": "hbox", "gap": 8, "children": [
        {"type": "item", "item": "minecraft:enchanted_golden_apple", "size": 32},
        {"type": "vbox", "gap": 2, "children": [
          {"type": "text", "text": "Rare food", "color": "light_purple"},
          {"type": "progress", "progress": 1.0, "width": 80, "height": 6, "colorFg": "#FFD700", "showLabel": true, "label": "Full", "labelAlign": "left"}
        ]}
      ]},
      {"type": "text", "text": "Durability bar: {durability_bar}", "color": "gray"},
      {"type": "text", "text": "Health bar: {health_bar}", "color": "red"}
    ]
  },

  "minecraft:wolf_spawn_egg": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Wolf Spawn Egg", "color": "white", "align": "center"},
      {"type": "entity", "entity": "minecraft:wolf", "size": 48, "rotationSpeed": 1.0, "autoRotate": true},
      {"type": "text", "text": "Can be tamed", "color": "gray"}
    ]
  },

  "minecraft:crafting_table": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Crafting Table", "color": "white", "align": "center"},
      {"type": "block", "block": "minecraft:crafting_table", "size": 48, "rotationSpeed": 0.5, "autoRotate": true},
      {"type": "text", "text": "Used for crafting", "color": "gray"}
    ]
  },

  "minecraft:apple": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Apple", "color": "red", "align": "center"},
      {"type": "atlas", "item": "minecraft:apple", "size": 32},
      {"type": "text", "text": "Restores hunger", "color": "gray"}
    ]
  },

  "minecraft:red_concrete": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Red Concrete", "color": "red", "align": "center"},
      {"type": "atlas", "block": "minecraft:red_concrete", "size": 32},
      {"type": "text", "text": "Decorative block", "color": "gray"}
    ]
  },

  "minecraft:iron_sword": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Iron Sword", "color": "white", "align": "center"},
      {"type": "text", "text": "Status: {durability > 100 ? 'Good' : 'Needs repair'}", "color": "{durability > 100 ? 'green' : 'red'}"},
      {"type": "text", "text": "Durability: {durability}/{max_durability} ({durability_percent}%)", "color": "gray"}
    ]
  },

  "minecraft:ender_pearl": {
    "type": "text",
    "text": {
      "zh_cn": "末影珍珠 - 可用于传送",
      "en_us": "Ender Pearl - Can be used for teleportation"
    },
    "color": "#00AAAA"
  },

  "minecraft:coal": {
    "type": "vbox",
    "gap": 0,
    "children": [
      {"type": "text", "text": "Coal", "color": "gray"},
      {"type": "spacer", "height": 8},
      {"type": "text", "text": "8px spacer above", "color": "white"}
    ]
  },

  "minecraft:emerald": {
    "type": "vbox",
    "gap": 2,
    "children": [
      {"type": "text", "text": "Bold text", "color": "green", "bold": true},
      {"type": "text", "text": "Italic text", "color": "green", "italic": true},
      {"type": "text", "text": "Underlined text", "color": "green", "underlined": true},
      {"type": "text", "text": "Strikethrough text", "color": "green", "strikethrough": true}
    ]
  },

  "minecraft:compass": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Compass", "color": "#FF5555", "bold": true},
      {"type": "text", "text": "Position: {player_x}, {player_y}, {player_z}", "color": "white"},
      {"type": "chart", "chartType": "bar", "width": 100, "height": 60,
       "entries": [
         {"label": "X", "value": "{player_x}", "color": "#FF5555"},
         {"label": "Y", "value": "{player_y}", "color": "#55FF55"},
         {"label": "Z", "value": "{player_z}", "color": "#5555FF"}
       ]
      }
    ]
  },

  "minecraft:redstone": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Redstone", "color": "#FF0000", "bold": true},
      {"type": "chart", "chartType": "pie", "width": 80,
       "entries": [
         {"label": "Redstone Dust", "value": 60, "color": "#FF0000"},
         {"label": "Redstone Torch", "value": 25, "color": "#FF5555"},
         {"label": "Redstone Repeater", "value": 15, "color": "#FFAAAA"}
       ]
      }
    ]
  },

  "minecraft:wheat_seeds": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Wheat Seeds", "color": "#55AA55", "bold": true},
      {"type": "chart", "chartType": "line", "width": 100, "height": 60,
       "entries": [
         {"label": "1", "value": 10, "color": "#55AA55"},
         {"label": "2", "value": 25, "color": "#55AA55"},
         {"label": "3", "value": 45, "color": "#55AA55"},
         {"label": "4", "value": 40, "color": "#55AA55"},
         {"label": "5", "value": 60, "color": "#55AA55"}
       ]
      }
    ]
  },

  "minecraft:painting": {
    "type": "vbox",
    "gap": 4,
    "children": [
      {"type": "text", "text": "Painting", "color": "#AAAAAA", "bold": true},
      {"type": "entity", "entity": "minecraft:painting", "size": 48, "autoRotate": false, "offsetY": 8},
      {"type": "text", "text": "Decorative item", "color": "gray"}
    ]
  }
}

For Mod Developers

Register Custom Variables

VariableResolver.registerVariable("my_var", stack -> "custom_value");

Register Custom Conditions

ConditionChecker.registerCondition("my_condition", (value, stack, player, level) -> {
    return player.getAbsorptionAmount() > 0;
});

Then use in JSON:

{
  "conditions": {
    "my_condition": true
  }
}

Event Hooks

// Pre-render event (modify or cancel)
TipEventManager.onPreRender(event -> {
    event.setItemStack(customStack);
    // or event.cancel() to cancel rendering
});

// Post-render event (add extra info)
TipEventManager.onPostRender(event -> {
    event.addExtraLine("Extra info from other mod");
});

// Variable resolve event (inject custom variables)
TipEventManager.onResolveVariable(event -> {
    if (event.getVariableName().equals("custom_var")) {
        event.setValue("custom_value");
    }
});

Hot Reload

Press F3+T or use /reload command to reload tooltips without restarting.

License

GNU LGPL 3.0

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
gradle/wrapper		gradle/wrapper
src/main		src/main
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
README_zh.md		README_zh.md
build.gradle		build.gradle
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle

Folders and files

Latest commit

History

Repository files navigation

DataTip

Quick Start

Content Types

Content Type Details

text

item

block

entity

progress

carousel

typewriter

atlas

image

chart

vbox / hbox

divider

spacer

Text Properties

Progress Bar Properties

Divider Properties

Carousel Properties

Typewriter Properties

Chart Properties

Entity/Item/Block/Atlas/Image Common Properties

Variables

NBT Variable

Conditions

NBT Condition

Item Tag Condition

Expressions

Multi-language

Special Properties

Colors

Named Colors

Hex Colors

Configuration

Legacy Format Support

Complete Example

For Mod Developers

Register Custom Variables

Register Custom Conditions

Event Hooks

Hot Reload

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages