Luna Translator не переводит игру после простой установки — программа требует привязки к процессу игры и выбора способа извлечения текста: через хук текстовых функций или через OCR-распознавание экрана. Именно на этом этапе у большинства пользователей возникают вопросы: игра запущена, окно переводчика открыто, а текст не появляется. Причина почти всегда в неверно выбранном процессе или в том, что движок игры не поддерживается стандартными хуками.
Ниже разберём настройку Luna Translator по шагам: от первого запуска и выбора игры до подключения переводчиков и тонкой конфигурации OCR. Инструкция ориентирована на актуальные версии программы, но пункты меню могут немного отличаться в зависимости от релиза — в этом случае ориентируйтесь на логику разделов, а не на точные названия кнопок.
Что такое Luna Translator и как он работает
Luna Translator — это бесплатная программа с открытым исходным кодом для Windows, предназначенная для перевода японских (и не только) игр в реальном времени. Основная аудитория — игроки в визуальные новеллы, но инструмент работает и с другими жанрами, если текст в них можно извлечь или распознать.
Программа получает текст двумя принципиально разными способами. Первый — текстовый хук: Luna Translator перехватывает вызовы функций вывода текста внутри процесса игры и получает строку до её отрисовки на экране. Второй — OCR: программа делает снимок выбранной области окна и распознаёт символы как на изображении. Хук точнее и быстрее, но работает не со всеми движками; OCR универсальнее, но зависит от качества шрифта и контрастности.
Полученный текст отправляется в один или несколько модулей перевода — онлайн-сервисы, локальные нейросетевые модели или словари. Результат выводится в отдельном полупрозрачном окне поверх игры.
Установка и первый запуск
Загружайте программу только из официального репозитория проекта на GitHub — там публикуются свежие релизы в виде архива. Установка как таковая не требуется: достаточно распаковать архив в отдельную папку и запустить исполняемый файл. Путь к папке лучше задавать латиницей, без кириллицы и пробелов — это снижает риск конфликтов с отдельными модулями.
- 📦 Распакуйте архив в папку вида
D:\Tools\LunaTranslator - 🚀 Запустите исполняемый файл программы от имени обычного пользователя
- 🌐 При первом запуске выберите язык интерфейса — русский среди вариантов присутствует
- 🎮 Запустите игру до того, как будете выбирать процесс в переводчике
Некоторые антивирусы реагируют на программы, внедряющиеся в чужие процессы, — это ожидаемое поведение для инструментов класса texthooker. Если защитник Windows или сторонний антивирус блокирует запуск, добавьте папку программы в исключения, предварительно убедившись, что архив скачан из официального источника.
⚠️ Внимание: не скачивайте Luna Translator с перезаливов и «сборок» на сторонних сайтах. Программа внедряется в процессы игр, поэтому модифицированная версия — реальный риск для системы. Используйте только официальный репозиторий проекта.
Выбор процесса игры и настройка хука текста
После запуска игры нажмите кнопку выбора процесса в главном окне Luna Translator — откроется список запущенных приложений. Найдите процесс игры (ориентируйтесь на имя исполняемого файла, а не на заголовок окна) и подтвердите выбор. Программа попытается подобрать подходящие хуки автоматически.
Дальше начните диалог в игре. Если движок поддерживается, в окне выбора текстовых потоков появятся строки — часто их несколько, потому что перехватываются разные функции вывода: основной текст, имя персонажа, системные сообщения. Отметьте тот поток, где отображается именно текст диалогов без дублирования и лишних символов.
☑️ Проверка корректного хука
Если автоматический подбор не дал результата, в программе предусмотрен поиск хуков по коду — так называемые H-коды, которые сообщество находит для конкретных движков и игр. Проверить наличие готового кода для вашей игры можно в базах и обсуждениях, посвящённых texthooker-инструментам. Вводится код в соответствующем поле настроек хука.
Настройка OCR, когда хук недоступен
Для игр на движках, которые не поддаются хуку (часть Unity- и браузерных проектов, эмуляторы), остаётся режим OCR. В настройках выберите модуль распознавания — в программе доступны как встроенные локальные движки, так и варианты, требующие загрузки языковых данных. Для японского текста убедитесь, что выбран именно японский язык распознавания.
Затем задайте область захвата: рамку следует растянуть точно по текстовому полю игры, не захватывая фоновую графику и интерфейс. Чем плотнее рамка прилегает к строкам текста, тем выше точность распознавания и меньше ложных срабатываний от анимации фона.
- 🎯 Область захвата — только текстовое окно, без портретов и кнопок
- 🔍 Для вертикального текста проверьте соответствующую опцию ориентации, если она есть в выбранном OCR-модуле
- ⏱️ Настройте интервал опроса области: слишком частый — лишняя нагрузка, слишком редкий — пропуск реплик
- 🎨 При плохом распознавании попробуйте увеличить масштаб окна игры — крупный шрифт распознаётся заметно лучше
Учтите ограничение метода: художественные шрифты, текст поверх пёстрой иллюстрации и полупрозрачные буквы распознаются с ошибками независимо от настроек. В таких сценах стоит ожидать пропусков и неточностей — это свойство технологии, а не неисправность программы.
Подключение модулей перевода
Luna Translator поддерживает несколько источников перевода одновременно и умеет показывать результаты параллельно — это удобно для сверки машинных вариантов. В разделе настроек переводчиков включите нужные модули: среди них есть онлайн-сервисы, работающие без ключей, сервисы, требующие API-ключа, и локальные офлайн-решения.
| Тип модуля | Требования | Сильные стороны | Ограничения |
|---|---|---|---|
| Онлайн без ключа | Только интернет | Быстрый старт, ничего настраивать не нужно | Лимиты запросов, возможны сбои |
| Онлайн с API-ключом | Регистрация в сервисе, ключ | Стабильность и качество перевода | Часто платно при интенсивном использовании |
| Локальные модели | Загрузка модели, ресурсы ПК | Офлайн-работа, приватность | Требовательны к железу, качество ниже топовых онлайн-сервисов |
| Словари (например, для подстрочника) | Файлы словарей | Разбор слов и чтений | Не дают связного перевода предложения |
Практичная схема для начала: включить два онлайн-переводчика параллельно и сравнивать их вывод. Если один сервис недоступен или вернул ошибку, второй продолжит работать. Для длительных сессий имеет смысл получить API-ключ одного из качественных сервисов — процедура регистрации описана на сайте соответствующего переводчика, а ключ вставляется в поле настроек модуля.
⚠️ Внимание: бесплатные онлайн-модули без ключа могут массово отваливаться при превышении лимитов — это выглядит как «перевод перестал работать». Прежде чем переустанавливать программу, проверьте, появляется ли оригинальный текст в окне: если да, проблема именно в модуле перевода, а не в хуке.
Настройка окна вывода и отображения
Окно перевода в Luna Translator перетаскивается мышью и настраивается по внешнему виду: размер и тип шрифта, цвет текста и фона, прозрачность, режим «поверх всех окон». Для игр в полноэксклюзивном полноэкранном режиме оверлей может не отображаться — переключите игру в оконный или безрамочный оконный режим, это решает проблему в большинстве подобных случаев.
Полезные опции, которые стоит проверить в настройках окна:
- 🖼️ Режим «поверх всех окон» и клик-through (прозрачность для мыши), чтобы окно не мешало играть
- 🔤 Размер шрифта и межстрочный интервал под ваше разрешение экрана
- 📜 Автопрокрутка истории и лимит хранимых строк
- 🈶 Отображение оригинала рядом с переводом — помогает замечать ошибки OCR
Зачем нужна функция копирования в буфер и история текста
Luna Translator умеет складывать извлечённые строки в историю и копировать их в буфер обмена. Это используют для связки со всплывающими словарями и программами изучения японского: наводите на слово в оригинале и видите чтение и значение. Если изучение языка не входит в планы, эти модули можно просто не включать.
Типичные проблемы и их диагностика
Диагностику всегда ведите по цепочке: сначала проверьте, появляется ли оригинальный текст, потом — работает ли перевод, затем — отображается ли окно. Нарушение на любом звене даёт симптом «переводчик не работает», но причины совершенно разные.
Текст не появляется вообще. Проверьте, тот ли процесс выбран (у некоторых игр несколько исполняемых файлов — лаунчер и сама игра). Попробуйте другие текстовые потоки в списке. Если ни один поток не даёт чистого текста — вероятно, движок не поддерживается, переходите на OCR.
Текст есть, но с мусором. Лишние символы, повторы букв («») или дубли строк означают, что выбран неоптимальный хук. Переберите другие потоки или поищите готовый H-код для конкретной игры — для популярных движков они, как правило, существуют.
Оригинал есть, перевода нет. Дело в модуле перевода: проверьте интернет-соединение, валидность API-ключа и включён ли сам модуль галочкой. Переключитесь временно на другой переводчик, чтобы локализовать сбой.
Производительность и удобство длительной игры
Для комфортных длинных сессий сохраните конфигурацию игры: Luna Translator запоминает настройки для каждого привязанного процесса, поэтому повторная настройка при следующем запуске обычно не требуется. Проверьте, что игра определилась как сохранённая, — тогда хук и переводчики подключатся автоматически.
Если OCR-режим заметно нагружает систему, увеличьте интервал опроса области и уменьшите зону захвата. Локальные нейросетевые переводчики на слабом железе могут выдавать перевод с задержкой в несколько секунд — в этом случае комбинация «локальный для приватности + онлайн для скорости» не обязательна, выберите один подходящий вариант.
Частые вопросы
Работает ли Luna Translator с играми не на японском языке?
Да, механика извлечения текста не привязана к конкретному языку. Хук работает на уровне функций вывода текста, а для OCR нужно выбрать соответствующий язык распознавания, если модуль его поддерживает. Аналогично и переводчики — выберите нужную языковую пару в настройках модуля.
Игра в полноэкранном режиме — окно перевода не видно. Что делать?
Переключите игру в оконный или безрамочный оконный режим в её собственных настройках. Эксклюзивный полноэкранный режим часто блокирует сторонние оверлеи, и это ограничение относится не только к Luna Translator.
Антивирус блокирует программу. Это опасно?
Инструменты, внедряющиеся в чужие процессы, закономерно вызывают срабатывания эвристики. Если архив скачан из официального репозитория проекта, добавьте папку в исключения защитника. Сборки со сторонних сайтов запускать не стоит — проверить их содержимое вы не можете.
Текст хукается, но каждая строка повторяется дважды. Как исправить?
Это признак неподходящего текстового потока: перехвачены две функции вывода одновременно. Откройте список потоков и выберите другой вариант, где строка появляется один раз. Если чистого потока нет, поищите H-код для конкретной игры.
Можно ли пользоваться программой полностью офлайн?
Да, если использовать локальные модули: офлайн-OCR и локальную модель перевода. Потребуется заранее загрузить необходимые данные и убедиться, что железо справляется с нагрузкой. Качество перевода локальных моделей обычно уступает крупным онлайн-сервисам.