NTooltip - Tooltip Style Manager v1.0

---

✦ What is NTooltip?

NTooltip is a Paper-exclusive plugin that fully manages Minecraft 1.21.2's native tooltip_style component — the system that controls how tooltip boxes look in-game.

⚠ NTooltip does not include tooltip textures. You must provide your own PNG files. NTooltip handles everything else: placing them in the correct namespace, generating all required configs, rebuilding the resource pack and applying the right style to every item — fully automatically.

If you use ItemsAdder, this plugin was built for you.

---

✦ How It Works

Global Tooltip

Drop your PNG files into plugins/NTooltip/textures/global/ and run /ntooltip generate.

NTooltip installs your texture directly under Minecraft's own namespace. Every tooltip in the game changes instantly:

• ✔ Inventory item tooltips
• ✔ Chat hover text
• ✔ Recipe book
• ✔ Enchantment table
• ✔ Every GUI — without exception

No other plugin does this. This is the only automated way to change every tooltip in the game server-side — without any client mod.

Item Overrides

Create folders inside plugins/NTooltip/textures/overrides/ — one folder per style.


Run /ntooltip generate. NTooltip creates all ItemsAdder configs, places the textures in the correct location and triggers /iazip automatically.

Assign styles to items in overrides.yml:

---

✦ Features

Texture Management

• ✔ Global tooltip — changes every tooltip in the game via Minecraft's own namespace
• ✔ Per-item override installation via custom namespace
• ✔ Automatic file normalization — any filename becomes background.png / frame.png
• ✔ Animated tooltip support via .mcmeta files
• ✔ Source folder auto-cleanup after installation
• ✔ Internal state tracking — plugin always knows what is installed and where

Config Automation

• ✔ Automatic ItemsAdder tooltip_styles config generation
• ✔ Automatic tooltips.yml updates
• ✔ When default-style changes, old global style migrates to override automatically
• ✔ /iazip triggered automatically after every generate

Override System

• ✔ Material-based overrides (e.g. DIAMOND_SWORD → gold style)
• ✔ Category-based overrides (e.g. all food items → one style)
• ✔ Custom item overrides via ItemsAdder PDC detection
• ✔ Priority order: custom_item > material > category > global

Commands

• /ntooltip generate — Build resource pack files and trigger pack rebuild
• /ntooltip reload — Reload configs and re-apply to all online players instantly
• /ntooltip list — List all loaded styles, categories and materials
• /ntooltip list categories — List only categories
• /ntooltip list materials — List only material overrides
• /ntooltip list tooltips — List only tooltip styles
• /ntooltip apply — Scan and apply tooltips to your own inventory
• /ntooltip info — Show tooltip decision for the item in your hand
• /ntooltip clear — Remove tooltip styles from your inventory
• /ntooltip clearall — Remove tooltip styles from all online players
• /ntooltip version — Show version and statistics
• /ntooltip debug — Toggle debug mode without editing config

Language Support

• ✔ English
• ✔ Turkish
• ✔ German
• ✔ French
• ✔ Spanish
• ✔ Portuguese

---

✦ Compatibility & Dependencies

Required

• ✔ Paper 1.21.2+
• ✔ Java 21+
• ✔ ItemsAdder — Hard dependency. Plugin will not function without it.

Coming Soon

• Oraxen — Full integration planned
• Nexo — Full integration planned
• Standalone Mode — No custom item plugin required (future version)

Not Supported

• ✗ Spigot — Not supported (requires Paper-exclusive tooltip API)
• ✗ Minecraft below 1.21.2 — tooltip_style component does not exist

---

✦ Quick Setup

1. Drop NTooltip.jar into your plugins/ folder and restart your server
2. Place your tooltip PNG files into plugins/NTooltip/textures/global/
3. Set default-style in config.yml
4. Configure overrides.yml for per-item styles (optional)
5. Run /ntooltip generate — done

Your tooltip textures must be your own PNG files.
NTooltip manages placement and configuration — it does not create textures.

---

✦ Known Limitations

• ⚠ Items picked from the creative menu and recipe book left panel previews always display the global tooltip style — item-specific overrides are not applied in these locations. This is a Minecraft client-side limitation.

---

✦ Support