Хук (hook) в Luna Translator — это механизм перехвата текста, который игра выводит на экран: программа подключается к процессу игры и извлекает строки до их отрисовки, после чего отправляет их на перевод. Если после запуска игры в окне переводчика не появляется ни одной строки, почти всегда проблема кроется именно в этапе хука: не выбран процесс, не сработал автоматический поиск текста или игра использует нестандартный способ вывода строк.
Ниже разберём, как устроен механизм перехвата в Luna Translator, какие режимы подключения существуют, как вручную подобрать hook-код и что проверять, когда текст не извлекается или дублируется. Материал ориентирован на Windows-версию программы; точные названия пунктов меню могут немного отличаться между версиями, поэтому при расхождениях сверяйтесь с документацией проекта.
Как устроен механизм хука
Принцип работы основан на перехвате вызовов функций, которые движок игры использует для вывода текста. Luna Translator внедряется в процесс игры и отслеживает обращения к текстовым функциям, передавая найденные строки в окно перевода. Это тот же подход, что и у классического Textractor, — более того, программа поддерживает совместимые hook-коды.
Важно понимать: хук работает только тогда, когда игра выводит текст через перехватываемые функции. Если текст отрисован заранее как картинка или выводится нестандартным способом, автоматический перехват может ничего не найти. В таких случаях остаются альтернативные методы — OCR-распознавание экрана или поиск готового hook-кода для конкретной игры.
Режимы подключения к игре
В программе предусмотрено несколько способов получения текста, и выбор правильного — половина успеха:
- 🪝 Автоматический хук — программа сама сканирует процесс и предлагает найденные текстовые потоки на выбор.
- 🔍 Поиск текста вручную — вы вводите известную строку из игры, и Luna Translator ищет её в памяти процесса, предлагая подходящие хуки.
- 📝 Готовый hook-код — вставка кода, найденного для конкретной игры (формат совместим с Textractor).
- 👁️ OCR-режим — распознавание текста с выделенной области экрана, когда хук невозможен.
- 📋 Перехват буфера обмена — вспомогательный метод для игр, копирующих текст в clipboard.
Для большинства визуальных новелл достаточно автоматического режима: после выбора процесса нужно проиграть несколько реплик в игре, чтобы появились варианты текстовых потоков. Затем выбирается тот поток, где строки отображаются чисто — без мусорных символов и дублей.
Пошаговая настройка хука
Последовательность действий при первом подключении выглядит так. Сначала запустите игру и дойдите до момента, где на экране есть текст диалога. Затем в Luna Translator выберите процесс игры из списка — обычно это делается через кнопку выбора процесса в главном окне. После подключения переключитесь в игру и промотайте несколько реплик.
Программа начнёт собирать перехваченные строки. В списке потоков появятся варианты — их может быть от одного до нескольких десятков. Выберите поток, где текст совпадает с тем, что на экране, без повторов символов и лишних управляющих последовательностей. Выбранный хук сохраняется для данной игры, и при следующих запусках подключение произойдёт автоматически.
☑️ Проверка перед настройкой хука
⚠️ Внимание: некоторые игры поставляются с лаунчером, и процесс лаунчера отличается от процесса самой игры. Если хук «не цепляется», проверьте, что выбран именно исполняемый файл игры, а не оболочка запуска.
Ручной поиск текста и hook-коды
Когда автоматика не справляется, помогает ручной поиск. Скопируйте или запомните точную строку из игры и воспользуйтесь функцией поиска текста в памяти процесса. Программа покажет найденные совпадения и предложит создать хук на их основе. Метод требует терпения: иногда подходящий вариант находится не с первой попытки.
Отдельный сценарий — готовые hook-коды. Для многих популярных игр сообщество публикует коды, совместимые с Textractor, которые работают и в Luna Translator. Код вставляется в соответствующее поле настроек хука для выбранной игры. Типичный формат выглядит примерно так:
/HS-4@0:gamedata.exeКонкретный код уникален для каждой игры и версии движка — универсального «рабочего для всех» кода не существует. Ищите коды в тематических сообществах, указывая точное название игры и, по возможности, её версию.
Типичные проблемы и их решения
Даже при правильном подключении встречаются характерные сбои. Сводка по самым частым ситуациям:
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| Нет ни одного потока текста | Выбран не тот процесс или текст выводится как изображение | Процесс игры, переход на OCR |
| Строки дублируются по 2-3 раза | Игра выводит текст посимвольно или через несколько функций | Другой поток из списка, фильтры дублей |
| Мусорные символы в строках | Перехвачены управляющие коды движка | Выбор чистого потока, правила очистки текста |
| Хук слетает после обновления игры | Изменились адреса функций в новой версии | Повторный поиск текста, новый hook-код |
| Перехватывается только часть реплик | Разные типы текста выводятся разными функциями | Подключение нескольких потоков одновременно |
Отдельно стоит сказать о посимвольном выводе: некоторые движки рисуют текст по букве с эффектом «печатной машинки», и хук ловит каждую итерацию. В таких случаях ищите поток, где строка появляется целиком после завершения вывода, либо настройте задержку/агрегацию текста, если ваша версия программы это поддерживает.
Когда хук невозможен: OCR как запасной вариант
Есть категория игр, где перехват принципиально не работает: текст отрендерен в текстуры, зашит в видеоролики или выводится через защищённые механизмы. Для них OCR-режим — единственный вариант. Вы выделяете область экрана с текстом, и программа распознаёт строки при их изменении.
Качество OCR зависит от шрифта, разрешения и контрастности. Стилизованные шрифты с засечками и полупрозрачным фоном распознаются хуже, чем чистый текст на однородной подложке. Если распознавание «плывёт», попробуйте увеличить масштаб текста в настройках игры или сузить область захвата до одной строки диалога.
⚠️ Внимание: OCR-режим потребляет заметно больше ресурсов, чем хук, и работает с задержкой. Используйте его только когда перехват действительно недоступен, а не как способ «не разбираться с настройкой».
Почему антивирус может блокировать Luna Translator
Техника перехвата текста (инъекция в процесс) технически похожа на поведение вредоносного ПО, поэтому некоторые антивирусы реагируют на программу. Это ложное срабатывание, характерное для всех текст-хукеров. Если доверяете источнику загрузки — добавьте папку программы в исключения. Скачивайте только с официального репозитория проекта.
Совместимость и ограничения
Лучше всего хук работает с играми на популярных движках визуальных новелл — для них часто уже существуют готовые коды и наработки сообщества. Сложнее обстоит дело с играми на Unity и Unreal Engine: там текст может выводиться через внутренние механизмы движка, и стандартный перехват не срабатывает. Для таких проектов чаще применяют OCR или специализированные плагины.
Также учитывайте разрядность: 32-битные и 64-битные процессы могут требовать разных подходов к подключению. Если игра не подключается вообще, проверьте в документации программы, поддерживается ли данный тип процесса вашей версией Luna Translator.
Часто задаваемые вопросы
Почему Luna Translator не видит процесс игры в списке?
Возможные причины: игра запущена от имени администратора, а переводчик — нет (права должны совпадать), либо процесс появляется с задержкой. Попробуйте запустить обе программы с одинаковыми правами и обновить список процессов.
Подходят ли hook-коды от Textractor?
Да, Luna Translator поддерживает формат кодов Textractor, поэтому базы кодов от сообщества Textractor применимы. Вставляйте код в настройки хука конкретной игры.
Текст переводится, но с обрывами фраз — что делать?
Скорее всего, выбран поток с посимвольным выводом. Просмотрите другие потоки в списке и выберите тот, где строка появляется целиком. Если такого нет, поищите готовый hook-код для вашей игры.
Нужно ли настраивать хук заново при каждом запуске?
Нет, выбранный хук сохраняется для игры. Повторная настройка потребуется только после обновления игры или смены её исполняемого файла.
Хук не работает ни в одном режиме — игра не поддерживается?
Не обязательно. Проверьте разрядность процесса, права запуска и попробуйте ручной поиск текста. Если и текст в памяти не находится, вероятно, он выводится как изображение — тогда остаётся OCR-режим.