# Multi LangTTS MC<\/p>\n
> **Multi-language Text-to-Speech Mod for Minecraft**<\/p>\n
—<\/p>\n
## \ud83d\udccb Overview<\/p>\n
**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\u2014all without impacting game performance.<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
### \ud83d\udd0a Text-to-Speech Engine
\n– **Dual Provider Support**:
\n – **Google Translate TTS** (Free, 100+ languages)
\n – **ElevenLabs API** (Premium, expressive voices, 29+ languages)
\n– **Non-Blocking Architecture**: All synthesis, network requests, and audio decoding run on dedicated background threads.
\n– **Audio Caching**: Reduces redundant API calls and latency for repeated phrases.
\n– **MP3 Validation**: Strict byte-signature detection filters malformed or error responses.
\n– **Rate Limiting**: Configurable minimum interval between synthesis requests prevents queue saturation.<\/p>\n
### \ud83d\udcac Chat Processing
\n– **Real-Time Synthesis**: Automatically converts player messages, server broadcasts, and system notifications into spoken audio.
\n– **Smart Spam Filtering**: Configurable cooldown thresholds prevent repetitive messages from triggering excessive playback.
\n– **Text Sanitization**: Strips Minecraft formatting codes (`\u00a7`, `&`), handles bidirectional markers, and applies RTL formatting for Arabic scripts.
\n– **Player Name Handling**: Optional speaker labels with language-aware formatting (e.g., “\u064a\u0642\u0648\u0644” for Arabic, “says” for English).<\/p>\n
### \ud83d\uddc2\ufe0f Chat Logging System
\n– **Daily Rotated Logs**: Plaintext logs stored in `logs\/multilangtts-mc\/chat-YYYY-MM-DD.txt`.
\n– **In-Game Viewer**: Scrollable interface with per-message replay via TTS.
\n– **Export Functionality**: Export session logs to custom file paths.
\n– **Async I\/O**: Non-blocking file writes prevent gameplay stutter.<\/p>\n
### \u2699\ufe0f Configuration & UI
\n– **ModMenu Integration**: Full settings interface accessible via ModMenu or keybind.
\n– **Cloth Config Backend**: Live configuration reloading without restarting the game.
\n– **Provider-Specific Settings**:
\n – Google: Language code selection
\n – ElevenLabs: API key, Voice ID, Model ID, Stability, Similarity Boost, Style Exaggeration, Speed
\n– **Test Suite**: Custom phrase input with one-click playback verification.<\/p>\n
### \u2328\ufe0f Keybindings
\n| Action | Default Key | Category |
\n|——–|————-|———-|
\n| Toggle TTS | `B` | Multi LangTTS MC |
\n| Open Chat Log Viewer | `V` | Multi LangTTS MC |<\/p>\n
*Fully customizable via Minecraft Controls menu*<\/p>\n
—<\/p>\n
### Supported Locales (Markdown Table)<\/p>\n
| Locale Code | Language | Region |
\n|————-|———-|——–|
\n| `af_za` | Afrikaans | South Africa |
\n| `ar_sa` | Arabic | Saudi Arabia |
\n| `bg_bg` | Bulgarian | Bulgaria |
\n| `cs_cz` | Czech | Czech Republic |
\n| `cy_gb` | Welsh | United Kingdom |
\n| `da_dk` | Danish | Denmark |
\n| `de_de` | German | Germany |
\n| `de_at` | German | Austria |
\n| `de_ch` | German | Switzerland |
\n| `el_gr` | Greek | Greece |
\n| `en_us` | English | United States |
\n| `en_gb` | English | United Kingdom |
\n| `es_es` | Spanish | Spain |
\n| `es_mx` | Spanish | Mexico |
\n| `es_ar` | Spanish | Argentina |
\n| `es_cl` | Spanish | Chile |
\n| `es_ec` | Spanish | Ecuador |
\n| `es_uy` | Spanish | Uruguay |
\n| `es_ve` | Spanish | Venezuela |
\n| `et_ee` | Estonian | Estonia |
\n| `eu_es` | Basque | Spain |
\n| `fa_ir` | Persian | Iran |
\n| `fi_fi` | Finnish | Finland |
\n| `fil_ph` | Filipino | Philippines |
\n| `fr_fr` | French | France |
\n| `fr_ca` | French | Canada |
\n| `ga_ie` | Irish | Ireland |
\n| `gl_es` | Galician | Spain |
\n| `hi_in` | Hindi | India |
\n| `hr_hr` | Croatian | Croatia |
\n| `hu_hu` | Hungarian | Hungary |
\n| `id_id` | Indonesian | Indonesia |
\n| `is_is` | Icelandic | Iceland |
\n| `it_it` | Italian | Italy |
\n| `ja_jp` | Japanese | Japan |
\n| `ko_kr` | Korean | South Korea |
\n| `lb_lu` | Luxembourgish | Luxembourg |
\n| `lt_lt` | Lithuanian | Lithuania |
\n| `lv_lv` | Latvian | Latvia |
\n| `mk_mk` | Macedonian | North Macedonia |
\n| `mt_mt` | Maltese | Malta |
\n| `nl_nl` | Dutch | Netherlands |
\n| `nl_be` | Dutch | Belgium |
\n| `no_no` | Norwegian | Norway |
\n| `pl_pl` | Polish | Poland |
\n| `pt_pt` | Portuguese | Portugal |
\n| `pt_br` | Portuguese | Brazil |
\n| `ro_ro` | Romanian | Romania |
\n| `ru_ru` | Russian | Russia |
\n| `sk_sk` | Slovak | Slovakia |
\n| `sl_si` | Slovenian | Slovenia |
\n| `sv_se` | Swedish | Sweden |
\n| `sw_ke` | Swahili | Kenya |
\n| `th_th` | Thai | Thailand |
\n| `tr_tr` | Turkish | Turkey |
\n| `uk_ua` | Ukrainian | Ukraine |
\n| `vi_vn` | Vietnamese | Vietnam |
\n| `zh_cn` | Chinese (Simplified) | China |
\n| `zh_tw` | Chinese (Traditional) | Taiwan |<\/p>\n
### TTS Language Coverage
\n| Provider | Languages | Notes |
\n|———-|———–|——-|
\n| **Google Translate TTS** | 100+ | Configurable via language code; default: `ar` |
\n| **ElevenLabs** | 29+ | Via `eleven_multilingual_v2` model; requires API key |<\/p>\n
—<\/p>\n
—<\/p>\n
## \ud83d\udc65 Contributors<\/p>\n
| Contributor | Role |
\n|————-|——|
\n| **mgv** | Lead Development, Architecture, Core Systems |
\n| **DFD3** | Co-Development, Testing, Integration |<\/p>\n
—<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Important Notes<\/p>\n
– **ElevenLabs API Key**: Required for premium voice synthesis. Obtain it from https:\/\/elevenlabs.io
\n The API key is stored locally in the Minecraft config files on the user\u2019s device
\n It is only used to access Text-to-Speech (TTS) services and is not shared externally by the mod
\n **Recommended setup:**
\n https:\/\/elevenlabs.io\/app\/developers\/api-keys > Create Key > set **Access** to **Text to Speech**
\n Avoid using full-access API keys for better security
\n– **Google TTS Rate Limits**: Public endpoint usage is subject to undocumented throttling.
\n– **Arabic Text Handling**: Automatic RTL embedding via Unicode bidi markers; stripped in logs for readability.
\n– **Audio Playback**: Blocking on worker thread only\u2014never impacts main game loop.<\/p>\n
—<\/p>\n
>* \ud83c\udf10 **Repository**: https:\/\/github.com\/mgv-hub\/Multi-LangTTS-MC
\n>* \ud83d\udc1b **Issues**: https:\/\/github.com\/mgv-hub\/Multi-LangTTS-MC\/issues
\n>* \ud83d\udce6 **Releases**: https:\/\/github.com\/mgv-hub\/Multi-LangTTS-MC\/releases<\/p>\n","protected":false},"excerpt":{"rendered":"
Adds real-time multilingual Text-to-Speech (TTS) to Minecraft chat using Google Translate and ElevenLabs, with async processing and zero performance impact.<\/p>\n","protected":false},"featured_media":107459,"template":"","meta":{"_minecraft_slug":"multi-langtts-mc","_minecraft_project_id":"enb9ZytB","_minecraft_author":"mgv","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":21,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"multi-langtts-mc.zip","_minecraft_size_bytes":10934904,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:21:51.871453Z","_minecraft_date_created":"2026-05-12T06:00:20.568154Z","_minecraft_date_modified":"2026-05-12T15:11:48.528870Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/multi-langtts-mc","_minecraft_icon_attachment_id":107459,"_minecraft_imported_at":"2026-06-06T05:03:33+00:00","_minecraft_import_hash":"623b1bfe52e81ebb1cf47cb9723c813d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,137,92],"mod_loader":[99],"minecraft_version":[40,41],"class_list":["post-107458","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-mobs","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-10","minecraft_version-1-21-11"],"yoast_head":"\n