LunaTranslator не переводит текст сам по себе — это оболочка, которая извлекает строки из запущенной игры (чаще всего визуальной новеллы) через HOOK или OCR и отправляет их в выбранный вами сервис машинного перевода, поэтому первое, что нужно проверить при «неработающем переводе», — какой именно метод извлечения текста активен и подключён ли хотя бы один движок перевода в настройках.
Программа распространяется бесплатно и с открытым исходным кодом, основная платформа — Windows. Ниже разберём установку, выбор режима работы, подключение переводчиков и типичные ошибки, с которыми сталкиваются пользователи при первом запуске.
Установка и первый запуск
Загружайте программу только с официального репозитория проекта на GitHub — сторонние сборки могут содержать устаревшие версии или вредоносные вложения. На странице релизов выберите архив под вашу разрядность системы: для большинства современных ПК это 64-битная версия. Распакуйте архив в отдельную папку, путь к которой не содержит кириллицы и спецсимволов — это снижает риск проблем с распознаванием файлов и вложенными компонентами.
Запуск выполняется через исполняемый файл LunaTranslator.exe. Установка в систему не требуется: программа портабельная, все настройки хранятся в её собственной папке. При первом старте интерфейс может открыться на английском или китайском языке — переключение на русский выполняется в разделе настроек интерфейса, если соответствующий перевод включён в вашу версию сборки.
⚠️ Внимание: антивирусы иногда реагируют на компоненты инъекции (HOOK) как на подозрительные — это известная особенность подобных инструментов. Добавляйте папку в исключения только если скачали программу с официального репозитория, а не с перезаливов.
Два режима извлечения текста: HOOK и OCR
Ключевой выбор, от которого зависит качество результата, — способ получения текста из игры. HOOK-режим перехватывает строки напрямую из памяти процесса: текст точный, без ошибок распознавания, но требует, чтобы игра поддерживалась встроенной базой хуков или чтобы вы нашли рабочий код вручную. OCR-режим распознаёт текст с картинки на экране: работает практически с любой игрой, но возможны ошибки распознавания, особенно на стилизованных шрифтах.
- 🎮 HOOK — лучший вариант для визуальных новелл на популярных движках (KiriKiri, Ren'Py и подобных).
- 📷 OCR — универсальный запасной вариант, когда хук не находит текст.
- 📋 Буфер обмена — перевод скопированного вручную текста, подходит для проверки отдельных фраз.
Для HOOK-режима последовательность такая: запустите игру, в LunaTranslator нажмите кнопку выбора процесса, укажите процесс игры и дождитесь появления строк текста в окне программы. Если текст не появляется или выводится «мусор» из повторяющихся символов, возможная причина — отсутствие подходящего хука; тогда стоит переключиться на OCR.
Пошаговая настройка HOOK-режима
Порядок действий важен: сначала запускается игра и доходит до момента, где на экране появляется текст, и только потом выполняется подключение. Если присоединиться к процессу в главном меню игры, хук может «зацепиться» не за тот поток вывода текста.
☑️ Настройка HOOK-перевода
Если игра выводит несколько вариантов строк (например, с дублированием символов или именами персонажей), выберите в списке перехваченных потоков тот, где текст отображается чисто. Встроенные фильтры позволяют убрать повторы символов и лишние управляющие последовательности — соответствующие опции находятся в разделе обработки текста.
Настройка OCR-режима
Когда хук недоступен, включите OCR и задайте область экрана, где появляется текст. Программа поддерживает несколько OCR-движков; доступность конкретных модулей зависит от версии сборки, часть из них требует загрузки дополнительных языковых пакетов. Для японского текста убедитесь, что выбран именно японский язык распознавания, иначе результат будет бессмысленным набором символов.
Качество распознавания сильно зависит от условий: чёткий шрифт на однородном фоне распознаётся заметно лучше, чем текст поверх насыщенного фона. Если OCR «путается», попробуйте увеличить масштаб окна игры, сузить область захвата строго под строку диалога и отключить полупрозрачность текстового окна в настройках самой игры, если такая опция есть.
Подключение сервисов перевода
LunaTranslator поддерживает множество источников перевода: онлайн-сервисы (как бесплатные, так и требующие API-ключа), локальные офлайн-движки и модели машинного перевода. Точный перечень зависит от версии программы, поэтому сверяйтесь с разделом настроек переводчиков в вашей сборке. Для сервисов, требующих ключ, его нужно получить на сайте соответствующего провайдера и вставить в поле настроек.
| Тип переводчика | Требования | Плюсы | Ограничения |
|---|---|---|---|
| Онлайн-сервисы без ключа | Интернет | Быстрая настройка | Возможны лимиты запросов |
| API с ключом | Интернет, регистрация, ключ | Стабильность и качество | Может быть платным |
| Офлайн-движки | Загрузка модели, ресурсы ПК | Работа без сети, приватность | Качество ниже облачных |
| Нейросетевые API | Ключ, интернет | Контекстный перевод | Стоимость и задержки |
Разумная практика — включить сразу два источника перевода: основной и резервный. Программа умеет показывать результаты нескольких движков одновременно, что помогает понять смысл фразы, когда один переводчик выдаёт явную ошибку.
Настройка окна перевода и отображения
Переведённый текст выводится в отдельном полупрозрачном окне, которое размещается поверх игры. Вам доступны настройки шрифта, размера, цвета и прозрачности фона — подберите параметры так, чтобы окно не перекрывало важные элементы интерфейса игры. Режим «поверх всех окон» включается отдельной опцией; без него окно перевода может пропадать при переключении фокуса.
Для полноэкранных игр иногда требуется перевести игру в оконный или безрамочный оконный режим, иначе оверлей не отображается. Это ограничение относится к способу отрисовки конкретной игры, а не к самой программе.
Дополнительные функции
В программе есть встроенный словарь, озвучка текста (TTS), история переведённых строк и поиск по ним, а также функция добавления слов в пользовательский словарь для изучения языка. Набор функций зависит от версии сборки.
Типичные проблемы и их решение
Текст не появляется в окне программы — наиболее частая жалоба. Проверьте по порядку: запущена ли игра до подключения, выбран ли правильный процесс (у некоторых игр их несколько), не блокирует ли антивирус инъекцию. Для OCR-режима убедитесь, что область захвата реально перекрывает строку текста и загружен нужный языковой пакет.
⚠️ Внимание: не запускайте LunaTranslator от имени администратора без необходимости, но учтите обратное: если сама игра запущена с повышенными правами, программе может потребоваться тот же уровень прав для подключения к процессу. Держите уровни прав одинаковыми.
Перевод выводится иероглифами или пустыми строками — обычно дело не в извлечении, а в движке перевода: сервис недоступен, исчерпан лимит запросов или неверно указан API-ключ. Переключитесь на другой источник перевода и проверьте, появился ли результат. Если текст перехватывается с дублированием символов (каждая буква повторяется), включите встроенный фильтр повторов в настройках обработки текста.
⚠️ Внимание: онлайн-игры с античит-системами могут конфликтовать с HOOK-инъекцией. Используйте программу только с одиночными играми, чтобы не рисковать блокировкой аккаунта.
Рекомендации по стабильной работе
- 🔄 Регулярно обновляйте программу — база хуков и список переводчиков пополняются.
- 💾 Сохраняйте конфигурацию под конкретную игру, чтобы не настраивать всё заново.
- 🧩 Для неподдерживаемых игр сначала пробуйте автопоиск хука, и только потом OCR.
- 🌐 Держите запасной офлайн-движок на случай проблем с сетью.
Главное правило диагностики: проблема всегда локализуется в одном из трёх звеньев — извлечение текста, движок перевода или отображение. Проверяйте их по одному, а не всё сразу.
Часто задаваемые вопросы
Бесплатна ли программа LunaTranslator?
Да, проект распространяется бесплатно с открытым исходным кодом. Платными могут быть только сторонние API перевода, если вы решите использовать их ключи.
Работает ли LunaTranslator с играми не на японском языке?
Да, программа не привязана к одному языку: она извлекает текст и отправляет его в переводчик, а направление перевода задаётся настройками выбранного движка.
Почему HOOK не находит текст в моей игре?
Возможные причины: игра использует нестандартный движок, текст отрисовывается как изображение или подходящий хук ещё не добавлен в базу. Попробуйте автопоиск хука по фразе с экрана или перейдите на OCR-режим.
Можно ли пользоваться программой без интернета?
Да, если настроить офлайн-движок перевода и локальный OCR. Онлайн-сервисы в этом случае работать не будут.
Безопасно ли добавлять программу в исключения антивируса?
Ложные срабатывания на модули перехвата текста — известная особенность подобных инструментов. Добавляйте исключение только для копии, загруженной с официального репозитория проекта.