?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Multi-LangTTS-MC

Multi-LangTTS-MC

Adds real-time multilingual Text-to-Speech (TTS) to Minecraft chat using Google Translate and ElevenLabs, with async processing and zero performance impact.

57
1
57
1

Compatibility

Minecraft: Java Edition

1.21.10–1.21.11

Platforms

Supported environments

Client-side

Links

Report issues View source

Tags

Creators

Details

Licensed GPL-3.0-only
Published last month

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.