🌍 NPC Translator for Hypixel Skyblock & More

Language barrier should never be a problem while enjoying your favorite servers. NPC Translator is a fully customizable, intelligent client-side Fabric mod that seamlessly translates NPC chat messages, item descriptions, and GUI tooltips into your preferred language!

Built especially with heavy game modes like Hypixel SkyBlock in mind, it perfectly handles complex color codes, dynamic lore (like live Bazaar prices), and interactive chat messages.

✨ Core Features

• 💬 Interactive Chat Translation:
  • Tired of copying texts to your browser? A small [Translate] button will automatically appear next to NPC chat messages.
  • Click it to instantly translate the text!
  • Fully Reversible & Safe: Click the [TR] / [EN] tag anytime to instantly revert the text back to its original state. This means ALL original interactive chat click events (like "Click here to open Auction House") are completely preserved!
• 📦 On-Demand Item Tooltip Translation:
  • Hover over any item and press the customizable hotkey (default: X) to toggle localization.
  • Works flawlessly natively and in custom mod inventories (like NEU Search, SkyblockAddons, etc.).
• 🎨 Flawless Color Code Preservation:
  • Unlike basic translators that break Minecraft formatting, this mod extracts the § color codes, translates the raw meaning, and accurately puts the original colors backward. Your Epic items will stay purple, and your Legendary items will remain orange!
• 🧠 Intelligent Caching & Anti-Spam:
  • Translations are securely cached based on the item's exact fingerprint.
  • If an item's lore changes (e.g., dynamic "Time Left" or live Bazaar prices), the mod instantly detects it as a new item and reverts it to original English to prevent you from being misled. No hidden, outdated prices!
  • Need a fresh translation? Use the "Force Re-Translate" keybind to clear the cache for that specific item.

⚙️ Engine Options (Free vs. AI)

You have full control over the translation backend through the configuration menu (/translatenpc or via ModMenu):

1. 🤖 Groq API (High-Quality AI): Uses ultra-fast LLMs (like Llama-3) to contextually understand Minecraft terms. Requires a free API key from Groq. Provides the absolute best color retention and contextual accuracy.
2. 🌐 Google Translate (100% Free): Don't want to use an API key? Switch the engine to Google Translate! Enjoy unlimited, fast, and completely free translations.

🔧 Configuration & Settings

• In-game GUI: Access via /translatenpc.
• Dynamic Language: Set it to translate dynamically to your Minecraft Client Language, or choose a specific Target Language regardless of your client's settings.
• Keybinds: Map your own keys in Controls > Key Binds > NPC Translator.

📦 Compatibility & Requirements

• Fabric API & Cloth Config API are required.
• Version: Minecraft 1.21.11 (Fabric)
• Client-side ONLY! You can use it safely on any multiplayer server.