Multi-LangTTS-MC

Multi LangTTS MC

Многоязычный мод Text-to-Speech для Minecraft

📋 Обзор

Multi LangTTS MC — это клиентский мод, который обеспечивает синтез речи (TTS) в реальном времени на нескольких языках для внутриигрового чата. Созданный для доступности, погружения и многоязычных серверных окружений, мод перехватывает сообщения чата, обрабатывает их асинхронно и преобразует в высококачественную речь с помощью настраиваемых внешних провайдеров — и всё это без влияния на производительность игры.

✨ Основные возможности

🔊 Движок Text-to-Speech

• Поддержка двух провайдеров:

  • Google Translate TTS (бесплатно, 100+ языков)
  • ElevenLabs API (премиум, выразительные голоса, 29+ языков)
• Неблокирующая архитектура: весь синтез, сетевые запросы и декодирование аудио выполняются в выделенных фоновых потоках.
• Кэширование аудио: снижает количество повторных API-запросов и задержку для повторяющихся фраз.
• Проверка MP3: строгая проверка байтовой сигнатуры отфильтровывает повреждённые или ошибочные ответы.
• Ограничение частоты: настраиваемый минимальный интервал между запросами синтеза предотвращает переполнение очереди.

💬 Обработка чата

• Синтез в реальном времени: автоматически преобразует сообщения игроков, серверные объявления и системные уведомления в озвученное аудио.
• Умная фильтрация спама: настраиваемые пороги кулдауна предотвращают чрезмерное воспроизведение повторяющихся сообщений.
• Очистка текста: удаляет коды форматирования Minecraft (§, &), обрабатывает двунаправленные маркеры и применяет RTL-форматирование для арабской письменности.
• Обработка имён игроков: опциональные метки говорящего с учётом языка (например, «يقول» для арабского, «says» для английского).

🗂️ Система логирования чата

• Ежедневные ротируемые логи: текстовые логи хранятся в logs/multilangtts-mc/chat-YYYY-MM-DD.txt.
• Внутриигровой просмотрщик: прокручиваемый интерфейс с повторным воспроизведением каждого сообщения через TTS.
• Функция экспорта: экспорт логов сессии по указанным путям.
• Асинхронный ввод-вывод: неблокирующая запись файлов предотвращает подтормаживание геймплея.

⚙️ Конфигурация и интерфейс

• Интеграция с ModMenu: полный интерфейс настроек, доступный через ModMenu или горячую клавишу.
• Бэкенд Cloth Config: перезагрузка конфигурации на лету без перезапуска игры.

• Настройки для каждого провайдера:

  • Google: выбор языкового кода
  • ElevenLabs: API-ключ, Voice ID, Model ID, Stability, Similarity Boost, Style Exaggeration, Speed
• Тестовый набор: ввод произвольной фразы с проверкой воспроизведения в один клик.

⌨️ Горячие клавиши

Действие	Клавиша по умолчанию	Категория
Переключить TTS	B	Multi LangTTS MC
Открыть просмотрщик логов чата	V	Multi LangTTS MC

Полностью настраивается через меню управления Minecraft

Поддерживаемые локали (таблица Markdown)

Код локали	Язык	Регион
af_za	Африкаанс	ЮАР
ar_sa	Арабский	Саудовская Аравия
bg_bg	Болгарский	Болгария
cs_cz	Чешский	Чехия
cy_gb	Валлийский	Великобритания
da_dk	Датский	Дания
de_de	Немецкий	Германия
de_at	Немецкий	Австрия
de_ch	Немецкий	Швейцария
el_gr	Греческий	Греция
en_us	Английский	США
en_gb	Английский	Великобритания
es_es	Испанский	Испания
es_mx	Испанский	Мексика
es_ar	Испанский	Аргентина
es_cl	Испанский	Чили
es_ec	Испанский	Эквадор
es_uy	Испанский	Уругвай
es_ve	Испанский	Венесуэла
et_ee	Эстонский	Эстония
eu_es	Баскский	Испания
fa_ir	Персидский	Иран
fi_fi	Финский	Финляндия
fil_ph	Филиппинский	Филиппины
fr_fr	Французский	Франция
fr_ca	Французский	Канада
ga_ie	Ирландский	Ирландия
gl_es	Галисийский	Испания
hi_in	Хинди	Индия
hr_hr	Хорватский	Хорватия
hu_hu	Венгерский	Венгрия
id_id	Индонезийский	Индонезия
is_is	Исландский	Исландия
it_it	Итальянский	Италия
ja_jp	Японский	Япония
ko_kr	Корейский	Южная Корея
lb_lu	Люксембургский	Люксембург
lt_lt	Литовский	Литва
lv_lv	Латышский	Латвия
mk_mk	Македонский	Северная Македония
mt_mt	Мальтийский	Мальта
nl_nl	Нидерландский	Нидерланды
nl_be	Нидерландский	Бельгия
no_no	Норвежский	Норвегия
pl_pl	Польский	Польша
pt_pt	Португальский	Португалия
pt_br	Португальский	Бразилия
ro_ro	Румынский	Румыния
ru_ru	Русский	Россия
sk_sk	Словацкий	Словакия
sl_si	Словенский	Словения
sv_se	Шведский	Швеция
sw_ke	Суахили	Кения
th_th	Тайский	Таиланд
tr_tr	Турецкий	Турция
uk_ua	Украинский	Украина
vi_vn	Вьетнамский	Вьетнам
zh_cn	Китайский (упрощённый)	Китай
zh_tw	Китайский (традиционный)	Тайвань

Покрытие языков TTS

Провайдер	Языки	Примечания
Google Translate TTS	100+	Настраивается через языковой код; по умолчанию: ar
ElevenLabs	29+	Через модель eleven_multilingual_v2; требуется API-ключ

---

---

👥 Участники

Участник	Роль
mgv	Ведущая разработка, архитектура, ключевые системы
DFD3	Соразработка, тестирование, интеграция

---

---

⚠️ Важные примечания

• API-ключ ElevenLabs: необходим для премиум-синтеза голоса. Получить можно на https://elevenlabs.io API-ключ хранится локально в конфигурационных файлах Minecraft на устройстве пользователя Он используется только для доступа к сервисам Text-to-Speech (TTS) и не передаётся модом наружу Рекомендуемая настройка: https://elevenlabs.io/app/developers/api-keys > Create Key > установите Access в Text to Speech Избегайте использования API-ключей с полным доступом для лучшей безопасности
• Ограничения частоты Google TTS: публичный эндпоинт подвержен недокументированному троттлингу.
• Обработка арабского текста: автоматическое RTL-встраивание через Unicode bidi-маркеры; удаляется в логах для читаемости.
• Воспроизведение аудио: блокировка только в рабочем потоке — никогда не влияет на основной игровой цикл.

---

• 🌐 Репозиторий: https://github.com/mgv-hub/Multi-LangTTS-MC
• 🐛 Проблемы: https://github.com/mgv-hub/Multi-LangTTS-MC/issues
• 📦 Релизы: https://github.com/mgv-hub/Multi-LangTTS-MC/releases