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
