FTB Quest Translator - перевод квестов FTB Quests на русский

FTB Quest Translator - клиентский аддон для FTB Quests, который встраивает кнопку перевода прямо в окно квеста. Нажали - и название задания, подзаголовок и описание уже на русском. Без копипаста в браузер, без правки lang-файлов, без ожидания, пока автор сборки соизволит сделать локализацию.

Проблема, которую он решает, знакома каждому, кто играл в крупные квестовые сборки модов. FTB Quests хранит текст заданий внутри самой сборки, и в 90% случаев это английский. Русскоязычному игроку остаётся либо читать со словарём, либо лезть в файлы. Аддон убирает этот этап: перевод идёт на лету, только на вашем клиенте, а оригинальные файлы квеста остаются нетронутыми. По сути это переводчик в браузере, только встроенный в интерфейс Майнкрафта.

Зачем это нужно и как работает

Открываете квестбук, кликаете по заданию. В панели появляется кнопка перевода. Один клик - текст меняется на ваш язык, второй клик - возврат к оригиналу. Всё, никаких промежуточных окон.

Работает это через бесплатные переводческие API. Основных провайдеров два: DeepL и Google Translate, плюс в сборке фигурирует MyMemory как резервный вариант. DeepL автор рекомендует отдельно - он заметно лучше держит контекст и не ломает форматирование, что для квестов критично: там часто списки, жирный текст, ссылки на предметы.

Провайдер	Качество на русском	Ключ API	Когда выбирать
DeepL	Лучшее, контекст и форматирование сохраняются	Нужен свой, есть бесплатный тариф	Основной вариант для больших квестбуков
Google Translate	Нормальное, иногда корявое на терминах	Не нужен	Быстрая проверка, разовые переводы
MyMemory	Простое, для коротких фраз	Не нужен	Если первые два недоступны

Бесплатный ключ DeepL даёт порядка 500 тысяч символов в месяц. Для одной средней сборки этого хватает с запасом, но если вы переводите квестбук на несколько тысяч заданий, лимит лучше держать в голове - иначе посреди главы перевод просто отвалится.

Возможности, которые реально влияют на игру

Тут не просто одна кнопка, хотя она - главная. Пробегусь по тому, что заходит на практике.

• Автоопределение языка. Мод смотрит на настройки языка Minecraft и подставляет нужный. Ничего указывать руками не надо, auto стоит по умолчанию.
• Индикатор поддержки языка. В меню выбора языка Майнкрафта появляется зелёная метка [T] - сразу видно, поддерживается ли ваш язык и будет ли толк от перевода.
• Кэш в памяти. Повторные открытия того же квеста не тратят ни трафик, ни лимит API. Перевод мгновенный.
• Глоссарий. Файл config/tfq_glossary.json хранит слова, которые переводить нельзя. Redstone, Create, Mekanism, AE2 - всё это останется как есть, а не превратится в "Редстоун" и "Создавать". Для квестовых сборок вещь обязательная.
• Диагностика соединения. Кнопка перевода начинает анимироваться, если сервер перевода недоступен или ключ DeepL неверный. Мелочь, но экономит нервы: не надо гадать, почему текст не меняется.
• Озвучка текста. Иконка динамика рядом с кнопкой читает задание вслух через Google TTS. Читает либо оригинал, либо перевод - в зависимости от того, что сейчас на экране.
• Пакетный перевод. Две кнопки в боковой панели FTB Quests запускают перевод всего квестбука в фоне.

Пакетный перевод в версии 1.5.0

Это самая полезная часть апдейта. Раньше приходилось кликать каждое задание, теперь есть отдельный интерфейс массового перевода: выбираете язык и конкретные главы, жмёте старт и занимаетесь своими делами. Есть пауза, возобновление с того же места и повтор упавших запросов.

Прогресс сохраняется отдельно для каждого мира, сервера и сборки. Закрыли игру - открыли через неделю и продолжили с той же главы. При сбоях API очередь ставится на автоматическую паузу, а не молотит впустую. Запросы идут с задержкой около 1.5 секунды - как раз чтобы бесплатные провайдеры не выдали бан по частоте.

Настройка: всё в игре, без файлов

Конфиги руками править не надо. Открываете квестбук, жмёте шестерёнку в правом верхнем углу главной панели - интерфейс на FTB Library, выглядит как родной. Там:

• выбор провайдера и ключ DeepL
• переопределение целевого языка
• настройка анимаций и проверки соединения
• очистка кэша
• управление глоссарием

Целевой язык

Используются стандартные коды ISO 639-1: ru для русского, en для английского, de для немецкого и так далее. Значение auto - дефолт, и в 95% случаев трогать его не нужно. Руками код ставят, когда хочется переводить не на язык клиента, а на какой-то другой. Полный список кодов есть в документации ISO, но учитывайте: не каждый код поддерживается и Minecraft, и выбранным провайдером.

Требования и совместимость

Просто мод не заработает - это именно аддон, а не самостоятельный проект.

Параметр	Значение
Загрузчики	Fabric, Forge, NeoForge
Версии Minecraft	1.20.1, 1.20.4, 1.21.1
Обязательные зависимости	FTB Quests, FTB Library
Сторона	Только клиент

Последнее - ключевое. Мод чисто клиентский: на сервер его ставить не нужно, игроков он ни к чему не обязывает, конфликтов с античитами не создаёт. Играете на чужом сервере с квестовой сборкой - просто кидаете jar в папку mods и всё. Остальные игроки видят оригинальный английский текст, вы - русский.

Важные нюансы из практики

Перевод не сохраняется в файлы квестов. Это отображение, а не локализация сборки. Если вы админ и хотите, чтобы квесты на русском видели все игроки - нужен другой подход, с экспортом в lang-файлы. Как раз этим занимается FTB Quest Localizer, он выгружает текст квестов наружу. FTB Quest Translator - про личное удобство, а не про перевод сборки для всех.

Пакетный перевод на бесплатном Google иногда ловит 429. Не паникуйте: очередь встанет на паузу, а после снятия лимита вы продолжите с того же места. На DeepL такого почти не бывает, но там упирается в месячный лимит символов.

Глоссарий заполняйте сразу. Открыли новую сборку - первым делом впишите в tfq_glossary.json названия крупных модов из неё. Потом переводить весь квестбук, а не переделывать после. Переводить уже готовые главы заново придётся с очисткой кэша.

Кэш живёт в памяти. После перезапуска игры переводы загружаются заново - это нормально, но если у вас жёсткий лимит DeepL, лучше не чистить кэш без причины и не перезапускать клиент посреди большой главы.

Шейдеры и оптимизаторы не конфликтуют. Sodium, Embeddium, Iris - всё стандартно, аддон работает только с интерфейсом FTB Quests и на рендер мира не лезет.

Кому это зайдёт

Тем, кто играет в большие квестовые сборки на английском и устал от переводчика в втором окне. Особенно если сборка свежая и русской локализации к ней нет и не предвидится. На демо проект показывают на сборке Star Technology - как раз типичный пример: квестов много, текста много, языка кроме английского нет.

Если же вы проходите ванильный Майнкрафт или сборку без FTB Quests, аддон бесполезен - ему нечего переводить. И да, для маленького квестбука на 20 заданий проще один раз прочитать глазами, чем настраивать API-ключи. Инструмент раскрывается на объёме.

Скачать FTB Quest Translator стоит тем, кто хочет читать квесты сборки на русском, не трогая при этом ни одного файла модпака. По популярности проект давно перевалил за 826 тысяч загрузок - для узкого клиентского аддона это хороший показатель, значит проблема с английскими квестами действительно массовая.