Multi-LangTTS-MC

Multi LangTTS MC

Multi-language Text-to-Speech Mod for Minecraft

📋 Overview

Multi LangTTS MC is a client-side modification that delivers real-time, multi-language Text-to-Speech (TTS) synthesis for in-game chat. Designed for accessibility, immersion, and multilingual server environments, the mod intercepts chat messages, processes them asynchronously, and converts them into high-quality speech using configurable external providers—all without impacting game performance.

✨ Core Features

🔊 Text-to-Speech Engine

• Dual Provider Support:
• Google Translate TTS (Free, 100+ languages)
• ElevenLabs API (Premium, expressive voices, 29+ languages)
• Non-Blocking Architecture: All synthesis, network requests, and audio decoding run on dedicated background threads.
• Audio Caching: Reduces redundant API calls and latency for repeated phrases.
• MP3 Validation: Strict byte-signature detection filters malformed or error responses.
• Rate Limiting: Configurable minimum interval between synthesis requests prevents queue saturation.

💬 Chat Processing

• Real-Time Synthesis: Automatically converts player messages, server broadcasts, and system notifications into spoken audio.
• Smart Spam Filtering: Configurable cooldown thresholds prevent repetitive messages from triggering excessive playback.
• Text Sanitization: Strips Minecraft formatting codes (§, &), handles bidirectional markers, and applies RTL formatting for Arabic scripts.
• Player Name Handling: Optional speaker labels with language-aware formatting (e.g., “يقول” for Arabic, “says” for English).

🗂️ Chat Logging System

• Daily Rotated Logs: Plaintext logs stored in logs/multilangtts-mc/chat-YYYY-MM-DD.txt.
• In-Game Viewer: Scrollable interface with per-message replay via TTS.
• Export Functionality: Export session logs to custom file paths.
• Async I/O: Non-blocking file writes prevent gameplay stutter.

⚙️ Configuration & UI

• ModMenu Integration: Full settings interface accessible via ModMenu or keybind.
• Cloth Config Backend: Live configuration reloading without restarting the game.
• Provider-Specific Settings:
• Google: Language code selection
• ElevenLabs: API key, Voice ID, Model ID, Stability, Similarity Boost, Style Exaggeration, Speed
• Test Suite: Custom phrase input with one-click playback verification.

⌨️ Keybindings

| Action | Default Key | Category |
|——–|————-|———-|
| Toggle TTS | B | Multi LangTTS MC |
| Open Chat Log Viewer | V | Multi LangTTS MC |

Fully customizable via Minecraft Controls menu

Supported Locales (Markdown Table)

| Locale Code | Language | Region |
|————-|———-|——–|
| af_za | Afrikaans | South Africa |
| ar_sa | Arabic | Saudi Arabia |
| bg_bg | Bulgarian | Bulgaria |
| cs_cz | Czech | Czech Republic |
| cy_gb | Welsh | United Kingdom |
| da_dk | Danish | Denmark |
| de_de | German | Germany |
| de_at | German | Austria |
| de_ch | German | Switzerland |
| el_gr | Greek | Greece |
| en_us | English | United States |
| en_gb | English | United Kingdom |
| es_es | Spanish | Spain |
| es_mx | Spanish | Mexico |
| es_ar | Spanish | Argentina |
| es_cl | Spanish | Chile |
| es_ec | Spanish | Ecuador |
| es_uy | Spanish | Uruguay |
| es_ve | Spanish | Venezuela |
| et_ee | Estonian | Estonia |
| eu_es | Basque | Spain |
| fa_ir | Persian | Iran |
| fi_fi | Finnish | Finland |
| fil_ph | Filipino | Philippines |
| fr_fr | French | France |
| fr_ca | French | Canada |
| ga_ie | Irish | Ireland |
| gl_es | Galician | Spain |
| hi_in | Hindi | India |
| hr_hr | Croatian | Croatia |
| hu_hu | Hungarian | Hungary |
| id_id | Indonesian | Indonesia |
| is_is | Icelandic | Iceland |
| it_it | Italian | Italy |
| ja_jp | Japanese | Japan |
| ko_kr | Korean | South Korea |
| lb_lu | Luxembourgish | Luxembourg |
| lt_lt | Lithuanian | Lithuania |
| lv_lv | Latvian | Latvia |
| mk_mk | Macedonian | North Macedonia |
| mt_mt | Maltese | Malta |
| nl_nl | Dutch | Netherlands |
| nl_be | Dutch | Belgium |
| no_no | Norwegian | Norway |
| pl_pl | Polish | Poland |
| pt_pt | Portuguese | Portugal |
| pt_br | Portuguese | Brazil |
| ro_ro | Romanian | Romania |
| ru_ru | Russian | Russia |
| sk_sk | Slovak | Slovakia |
| sl_si | Slovenian | Slovenia |
| sv_se | Swedish | Sweden |
| sw_ke | Swahili | Kenya |
| th_th | Thai | Thailand |
| tr_tr | Turkish | Turkey |
| uk_ua | Ukrainian | Ukraine |
| vi_vn | Vietnamese | Vietnam |
| zh_cn | Chinese (Simplified) | China |
| zh_tw | Chinese (Traditional) | Taiwan |

TTS Language Coverage

| Provider | Languages | Notes |
|———-|———–|——-|
| Google Translate TTS | 100+ | Configurable via language code; default: ar |
| ElevenLabs | 29+ | Via eleven_multilingual_v2 model; requires API key |

👥 Contributors

| Contributor | Role |
|————-|——|
| mgv | Lead Development, Architecture, Core Systems |
| DFD3 | Co-Development, Testing, Integration |

⚠️ Important Notes

• ElevenLabs API Key: Required for premium voice synthesis. Obtain it from https://elevenlabs.io The API key is stored locally in the Minecraft config files on the user’s device It is only used to access Text-to-Speech (TTS) services and is not shared externally by the mod Recommended setup: https://elevenlabs.io/app/developers/api-keys > Create Key > set Access to Text to Speech Avoid using full-access API keys for better security
• Google TTS Rate Limits: Public endpoint usage is subject to undocumented throttling.
• Arabic Text Handling: Automatic RTL embedding via Unicode bidi markers; stripped in logs for readability.
• Audio Playback: Blocking on worker thread only—never impacts main game loop.

* 🌐 Repository: https://github.com/mgv-hub/Multi-LangTTS-MC

* 🐛 Issues: https://github.com/mgv-hub/Multi-LangTTS-MC/issues

* 📦 Releases: https://github.com/mgv-hub/Multi-LangTTS-MC/releases