Skip to content

Documentation: Configuration Overview #1

@slprime

Description

@slprime
a b
Image Image

This mod is required for mods with their own tooltip renderer to work correctly. It covers all mods found in the GTNH modpack. Integration with other mods is worth adding there

Resourcepack

path: assets\chromatictooltips\tooltip.json

Tooltip Style:

{
    "style": {
        "margin": 2,
        "padding": 4,

        "offsetMain": 6,
        "offsetCross": -18,

        "decorators": [{
            "type": "background",
            "color": "0xF0100010",
            "corner": false
        },{
            "type": "border",
            "color": ["0x505000ff", "0x5028007F"],
            "margin": 1
        }],

        "font": {
            "paragraph": 6
        },

        "sectionSpacing": 4
    }
}

You can use the style key for a single tooltip, or styles for a list of tooltips in different contexts.

Offset*, Margin, Padding

    "offset": {
        "main": 6,
        "cross": - 18
    },
    "offsetMain": 6,
    "offsetCross":  -18,

    "margin": {
        "left": 4,
        "right": 3,
        "top": 2,
        "bottom": 1
    },
    "margin": [2, 3, 1, 4],
    "marginLeft": 4,
    "marginRight": 3,
    "marginTop": 2,
    "marginBottom": 1,

padding same as margin

Image

Blue - margin
Green - padding
Indingo - offsetCross
Orange - offsetMain

sectionSpacing

Image

Font

{
  "fontShadow": true,
  "fontParagrath": "<int>",
  "fontColors": {
    "gold": ["0xFFFFD700", "0xFFB8860B"]
  }
}

alias

{
    "font": {
        "shadow": true,
        "paragrath": "<int>",
        "colors": {
            "gold": ["0xFFFFD700", "0xFFB8860B"]
        }
    }
}

paragrath

indent height for an empty line

shadow

on off
Image Image

colors

you can rewrite default minecraft font colors
black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white

a b
Image Image

Main Sections

"header": {},
"hr": {},
"body": {},
"footer": {},
"navigation": {}
Image

navigation section shown after footer if content don't fit in screen

Each section contains the following parameters:

{
  "margin": "<TooltipSpacing>",
  "padding": "<TooltipSpacing>",

  "font": "<TooltipFontContext>",
  "decorators": [ "<TooltipDecorator>" ],
  "transform": "<TooltipTransform>",

  "alignInline": "left|center|right",
  "alignBlock": "top|center|bottom",
  "minWidth": "<int>",
  "minHeight": "<int>",

  "spacing": "<int>",
  "sectionSpacing": "<int>"
}

Default Sections

{
    "sections": {
        "title": {},
        "keyboard-modifier": {},
        "stats:icons": {},
        "stacksize": {},
        "hotkeys": {},
        "itemInfo": {},
        "enchantments": {},
        "stats": {},
        "oreDictionary": {},
        "contextInfo": {},
        "modInfo": {}
    }
}

They have the same parameters as the main sections, as well as some of their own

{
  "order": "<int>",
   "place": "header" | "body" | "footer",
   "mode": ["none", "ctrl", "shift", "alt"]
}

Decorator

You can use decorator key for single, or decorators for list

border

{
    "type": "border",
    "color": "0xAARRGGBB" | ["left-top-color", "right-top-color", "right-bottom-color", "left-bottom-color"],
    "thickness": 1,
    "corner": true
}
default thickness 2 corner false
Image Image Image

background

{
    "type": "background",
    "color": "0xAARRGGBB" | ["left-top-color", "right-top-color", "right-bottom-color", "left-bottom-color"],
    "thickness": 1,
    "corner": true
}

gradient-horizontal and gradient-vertical

Draws a rectangle with a gradient from one color to another. The number of colors is unlimited. If you set single color, it converted to
[TRANSPARENT, color60Int, colorInt, color60Int, TRANSPARENT]

{
    "type": "gradient-horizontal" | "gradient-vertical",
    "color": "0xAARRGGBB" | ["0xAARRGGBB", "0xAARRGGBB", ...],
    "thickness": 1,
    "corner": true
}
a b
Image Image

item

{
    "type": "item"
}
icon icon with border & background
Image Image

Example

"header": {
    "paddingLeft": 29,
    "minHeight": 25,
    "alignBlock": "center",
    "sectionSpacing": 2,
    "decorators": [
        {
            "_name": "background",
            "type": "background",
            "color": "$param:iconColor",
            "corner": true,
            "margin": 1,
            "width": 23,
            "height": 23
        },
        {
            "_name": "border",
            "type": "border",
            "color": "$param:iconBorderColor",
            "corner": false,
            "thickness": 1,
            "width": 25,
            "height": 25
        },
        {
            "_name": "stack icon",
            "type": "item",
            "margin": 1,
            "width": 23,
            "height": 23
        }
    ]
},

Texture

(read readme file for details)

Screen.Recording.2025-12-31.172343.mp4

Transform

{
  "duration": 600,
  "function": "easeInOut",
  "originInline": "center",
  "originBlock": "center",
  "keyframes": [
    { "progress": 0, "scale": 0.9 },
    { "progress": 100, "scale": 1.0 }
  ]
}

Image

Filters/Contexts

You can create tooltip for different contexts. By default used default context if don't exists target context. If need show tooltip for some itemStack use context "item" and add "filter" for it. without "filter" this tooltip apply for every items

{
    "styles": [{
        "context": "default"
    }, {
        "context": "item",
        "filter": "..."
    }]
}

Filter rules:

  • parts:
  • modname:itemid - identify: matches any part of the target, so minecraft:lava matches minecraft:lava_bucket
  • $orename - ore dictionary: matches any part of the target, so $ingot matches ingotIron, ingotGold, etc.
  • tag.color=red - tag
  • rarity:common - rarity
  • 0 or 0-12 - damage
  • modifiers:
  • ! - logical not. exclude items that match the following expression (!minecraft:portal)
  • r/.../ - standard java regex (r/^m\w{6}ft$/ = minecraft)
  • , - logical or in token (minecraft:potion 16384-16462,!16386)
  • | - logical or multi-item search (wrench|hammer)
  • example: minecraft:potion 16384-16462,!16386 | $oreiron | tag.color=red
    Examples: https://github.com/GTNewHorizons/GT-New-Horizons-Modpack/blob/master/config/NEI/collapsibleitems.cfg

Settings

Controls

Image ## General Configuration Image

maxWidth - force tooltip max width
scaleFactor - use custom scale for tooltips
tooltipBlacklistLines - you can hide some lines in tooltips
tooltipShowUpDelay - delay before showing tooltip
transformEnabled - force disabled transformation it tooltip resourcepack

Enricher Configuration

Image

Stack Amount Configuration

Image Image

Examples:

GT_NewHorizons2.9.x2025-12-3116-41-01-ezgif.com-crop-video.mp4
Image

ResourcePack: experemental-tooltips.zip

Image

ResourcePack: chromatic-tooltips-simple.zip

Image

ResourcePack: chromatic-tooltips-icon.zip

Image

ResourcePack: black-tooltips-icon.zip

Image

ResourcePack: black-tooltips-simple.zip

Image

ResourcePack: blue-tooltips-icon.zip

Image

ResourcePack: tooltip-blue-simple.zip

Image

ResourcePack: gregtech-tooltips-icon.zip

Image

ResourcePack: gregtech-tooltips-simple.zip

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentation

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions