🇺🇸 English | 🇹🇷 Türkçe | 🇷🇺 Русский | 🇩🇪 Deutsch | 🇨🇳 中文

🌍 NPC & Items Translator for Hypixel Skyblock & More

Language barriers should never hold you back from enjoying your favorite Minecraft servers. NPC & Items Translator is a fully customizable, intelligent client-side Fabric mod that seamlessly translates NPC dialogues, item descriptions, and GUI tooltips into your preferred language with AI-powered accuracy and realistic voice narration (TTS)!

Built especially with heavy RPG/MMO game modes like Hypixel SkyBlock in mind, it flawlessly handles complex color codes, dynamic lore (such as live Bazaar prices), interactive chat actions, and full multi-language UI localization.

✨ Core Features

💬 Interactive Chat Translation

Tired of copying text to your browser? A clean [Translate] button appears automatically next to chat messages.
Click it to instantly translate dialogue into your language!

• Auto-Translate Option: Automatically translate all incoming chat messages without clicking.
• Only Translate NPCs: Only translate NPC dialogue while leaving regular player chat untouched.
• Safe & Reversible: Click the language tag (e.g. [TR], [EN]) anytime to revert the text back to its original version. All interactive click events ("Click to open Auction House", etc.) are completely preserved!

🗣️ Built-in Text-to-Speech (TTS) Voice Narration

Hear NPC dialogue spoken out loud in your language!

• Natural Voice Output: Automatically narrates translated NPC dialogue or chat messages using high-quality Google TTS.
• Full Customization: Adjust Speech Speed (0.25x - 2.00x) and Voice Pitch / Tone (0.60x - 1.40x) directly in the settings menu.
• Smart Queueing: High-speed dialogue queue ensures smooth playback without stutter or lag.

📦 On-Demand Item Tooltip Translation

Hover over any item and press customizable hotkeys to translate item lore with your preferred engine:

• G — Translate via Google Translate (Free, Instant)
• X — Translate via Gemini AI (Smart, High quality)
• C — Translate via Groq AI (Ultra-fast LLM)
• [Configurable] — Translate via Mistral AI (Assign key in Controls)
• [Configurable] — Translate via OpenRouter AI (Assign key in Controls)
• V — Revert translation back to original

Note: Pressing the same translation key twice acts as a toggle to revert.

🎨 Flawless Color Code Preservation

Unlike basic translators that break Minecraft formatting, this mod extracts § color codes, translates the raw meaning, and accurately reapplies the original colors.
Your Epic items stay purple, and your Legendary items remain orange!

🛡️ Smart Error Handling & Automatic Model Fallback

• If an API key is missing or invalid, an in-game warning will appear directly in the tooltip or chat.
• Auto-Fallback on Rate Limit: If an AI model hits rate limits (429), the mod silently and automatically retries using the next available model from the same provider!

🌐 17 Supported Languages (UI & Translation)

The mod includes complete UI localization and translation support for 17 major languages:

⚙️ Translation Engines

You have full control over the translation backend through the configuration menu (/translate or via ModMenu, or by pressing Z).

🔧 Configuration & Commands

• In-game GUI: /translate command, Z keybind, or ESC → Mods → NPC & Items Translator
• Dynamic Language: Translate to your Minecraft Client Language automatically, or choose a specific Target Language.
• Keybinds: Options → Controls → Key Binds → NPC & Items Translator
• Dictionary Reset: /translate DeleteDict or via the in-game Hub menu.

📦 Compatibility & Requirements

• Loader: Fabric
• Supported Minecraft Versions: 1.21.11, 26.1, 26.2
• Dependencies:
  • Fabric API
  • YetAnotherConfigLib (YACL)
  • ModMenu
• Side: Client-side ONLY — 100% safe to use on multiplayer servers including Hypixel!

📄 License

MIT License