NTooltip - Tooltip Style Manager v1.1.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 generate textures. You bring 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.

Works with ItemsAdder and Standalone mode — no custom item plugin required.

---

✦ How It Works

Layer 1 — 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.

Layer 2 — Item Overrides

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


Run /ntooltip generate. NTooltip creates all required configs, places the textures in the correct location and triggers pack rebuild automatically.

Assign styles to items in overrides.yml:


Standalone Mode

No ItemsAdder or any custom item plugin? No problem.

NTooltip detects your setup automatically. In standalone mode, it generates a complete resource pack ZIP that you upload to any host and add to server.properties. Everything works — global tooltip, per-item overrides, animated textures — no third-party plugin required.

---

✦ 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
• ✔ Pack rebuild 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

License System

• ✔ BuiltByBit integration — verifies your purchase automatically on startup
• ✔ IP-bound license — one purchase, one server
• ✔ Additional IP slots available as an extra purchase
• ✔ IP transfer support — contact Discord: sRoXieS (free of charge)

Version Checker

• ✔ Automatically checks for new versions via GitHub on startup
• ✔ Clickable [ Update Now ] button in-game — opens BuiltByBit directly
• ✔ Console warnings when running an outdated version
• ✔ 7-day grace period — plugin continues working after update release
• ✔ Plugin disables itself after grace period to ensure compatibility

Standalone Mode

• ✔ No custom item plugin required — works out of the box
• ✔ Generates a complete resource pack ZIP automatically
• ✔ Global tooltip + per-item overrides fully supported
• ✔ Upload to any host, add to server.properties — done

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+

Supported

• ✔ ItemsAdder — Full integration
• ✔ Standalone — No custom item plugin required

Coming Soon

• Nexo — Full integration planned
• Oraxen — Full integration planned

Not Supported

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

---

✦ Quick Setup

With ItemsAdder

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

Standalone Mode

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. Run /ntooltip generate — ZIP is created in plugins/NTooltip/output/
5. Upload the ZIP to a host (e.g. mc-packs.net) and add to server.properties
6. Restart your server — 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.
• ⚠ Standalone Mode: Setting global-tooltip.enabled to false will stop item overrides from applying, but cannot automatically remove the global texture from your hosted resource pack. To fully disable: remove the pack from server.properties or upload an empty pack to your host.

---

✦ Support