hypixel skyblock npc and items translate

[🇺🇸 English](https://github.com/knutolof06/hypixel-skyblock-npc-and-items-translate/blob/main/README.md) | [🇹🇷 Türkçe](https://github.com/knutolof06/hypixel-skyblock-npc-and-items-translate/blob/main/README_tr.md) | [🇷🇺 Русский](https://github.com/knutolof06/hypixel-skyblock-npc-and-items-translate/blob/main/README_ru.md) | [🇩🇪 Deutsch](https://github.com/knutolof06/hypixel-skyblock-npc-and-items-translate/blob/main/README_de.md) | [🇨🇳 中文](https://github.com/knutolof06/hypixel-skyblock-npc-and-items-translate/blob/main/README_zh.md)

# 🌍 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 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. ``, ``) 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) - `` — Translate via Mistral AI (Assign key in Controls) - `` — 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:

| Language | Code | Native Name | | :--- | :--- | :--- | | 🇬🇧 English | `en_us` | English | | 🇹🇷 Turkish | `tr_tr` | Türkçe | | 🇨🇳 Chinese (Simplified) | `zh_cn` | 简体中文 | | 🇪🇸 Spanish | `es_es` | Español | | 🇮🇳 Hindi | `hi_in` | हिन्दी | | 🇸🇦 Arabic | `ar_sa` | العربية | | 🇫🇷 French | `fr_fr` | Français | | 🇷🇺 Russian | `ru_ru` | Русский | | 🇧🇷 Portuguese (Brazil) | `pt_br` | Português (Brasil) | | 🇮🇩 Indonesian | `id_id` | Bahasa Indonesia | | 🇩🇪 German | `de_de` | Deutsch | | 🇯🇵 Japanese | `ja_jp` | 日本語 | | 🇰🇷 Korean | `ko_kr` | 한국어 | | 🇻🇳 Vietnamese | `vi_vn` | Tiếng Việt | | 🇮🇹 Italian | `it_it` | Italiano | | 🇵🇱 Polish | `pl_pl` | Polski | | 🇺🇦 Ukrainian | `uk_ua` | Українська |

## ⚙️ Translation Engines

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

| Engine | Description | |---|---| | 🤖 Gemini AI | Google's latest Gemini models (e.g. Gemini 2. 5 Flash, Flash-Lite). Excellent contextual understanding and formatting retention. Get a free API key at (https://aistudio.google.com). | | ⚡ Groq AI | Ultra-fast LLMs (Llama 3. 3 70B, Qwen3) to contextually understand Minecraft and MMO terminology. Get a free API key at [co