Multi-LangTTS-MC

Minecraft 版本： 1.21.10 1.21.11

平台： fabric

标签： mobs utility

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

Fully customizable via Minecraft Controls menu

Supported Locales (Markdown Table)

TTS Language Coverage

? Contributors

⚠️ 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