Wand RU Patcher (WRP)

Русификатор приложения Wand для пользователей из СНГ.

Установка в один клик: находит Wand, добавляет русский язык и включает его. Перевод работает локально; онлайн-добор переводов включается отдельно.

---

Warning

.exe собирается из этого репозитория: Fork → Actions → Build (Шаг 1) или локально. Не скачивайте .exe из описаний YouTube, зеркал и Discord-вложений - там встречаются вирусы под именем проекта.

🇷🇺 Что делает

• 🔎 Автопоиск Wand - сам находит установленную копию (или указывайте папку вручную).
• 🈴 Русификация интерфейса - добавляет Русский в выбор языка и применяет встроенные переводы интерфейса.
• 🎮 Перевод читов - названия читов (Unlimited Health → Бесконечное здоровье) переводятся на лету, в онлайн-режиме - и описания/заметки читов. Настраивается при установке - см. ниже.
• 🗺️ Перевод игровых карт - интерактивные карты Wand (RDR2, Cyberpunk 2077 и др.) переводятся прямо в приложении: интерфейс, фильтры, диалоги и описания точек. Работает офлайн (встроенный словарь + шаблоны фильтров), онлайн-добор описаний - опционально.
• ↩️ Откат - сохраняет состояние ярлыков и восстанавливает их при удалении перевода.
• ⚙️ Настройки - закрепление версии Wand (патчить старую, пока WRP не поддержал новую), авто-перезапуск, показ/экспорт лога, режим перевода читов, кэш.
• 🔔 Уведомление об обновлениях - при выходе новой версии WRP в шапке появляется баннер; клик открывает страницу релиза на GitHub. Авто-обновления нет - вы сами решаете, что ставить.

Совместимость с Wand и Wand-Enhancer

В этой ветке доступен экспериментальный режим для нового загрузчика модов. Одна кнопка устанавливает перевод и сохраняет привычный ярлык Wand. Через него автоматически запускается внутренний помощник; он работает в фоне только вместе с Wand. Окно установщика можно закрыть.

При обычной установке WRP не изменяет файлы Wand или установленного Wand-Enhancer. Если ранее был установлен файловый патч WRP, установщик сначала восстанавливает оригинал из бэкапа и проверяет его целостность. При обнаружении бэкапов Enhancer откат старого патча останавливается, чтобы сохранить его изменения. Удаление перевода возвращает сохранённый ярлык. Старый способ установки через изменение файлов больше не используется; для старых версий Wand требуется совместимость с текущим способом запуска.

Совместимость с Wand-Enhancer поддерживает режим Static. Режим Supervised не поддерживается. WRP проверяет оригинальный Wand и контролирует ключевые изменённые файлы. Если файлы Enhancer изменились, повторите установку перевода.

🎮 Что будем русифицировать: выбор при установке

Кнопка «Русифицировать» открывает окно «Что будем русифицировать?» - отметьте нужное:

• Локальный перевод (из словарей) (по умолчанию, полностью офлайн) - имена читов встроенным словарём + морфологическими шаблонами (род, падежи, склейка составных имён). Без интернета. На реальных трейнерах 62 игр: ~51% имён с верной грамматикой (в геймерских жанрах выше — гонки 85%, экшн 68%, космос 65%, выживание 59%, шутеры 55%). Остаток - жаргон отдельных игр.

  💯 Плюс точные словари для отдельных игр (WAND_RU/renderer/games/) - у этих игр переведены все имена читов вручную, офлайн. Сейчас покрыто 48 игр (Cyberpunk 2077, Crusader Kings III, Kingdom Come: Deliverance II, Nioh 3, Death Stranding 2, Atomic Heart, Anno 1800, Sekiro и др.), список растёт по запросам - открывайте issue или жмите ♥ в самом установщике.

• Перевод читов через интернет - допереводит всё непокрытое словарём + описания и заметки читов, кэширует. Бесплатно, без ключей: Google Translate, при сбое - MyMemory; при недоступности обоих - офлайн-фолбэк (останется на английском, переведётся в следующий раз). Кэш виден/чистится в настройках.
• Локальный перевод карт (по умолчанию, офлайн) - интерфейс, фильтры и диалоги интерактивных карт Wand переводятся мгновенно встроенным словарём + шаблонами фильтров.
• Перевод карт через интернет (опционально) - описания точек интереса, что не покрыл офлайн-словарь (Google → MyMemory, throttle + бэкофф). По умолчанию выключено - офлайн и так покрывает почти весь UI.
• Запустить Wand после установки - установщик сам закроет и снова откроет Wand.

Всё переключается в настройках. Онлайн-перевод работает внутри самого Wand - окно установщика держать открытым не нужно, нужен лишь запущенный Wand и интернет. После установки прямо из окна «Готово» можно запустить Wand или вернуться в меню (откат/переустановка), не перезапуская установщик.

👾 Это безопасно?

Проект полностью открыт - код можно проверить. Перевод работает локально. В текущем режиме WRP использует сохранённый ярлык. При миграции старого патча или восстановлении повреждённой подписи установщик может изменять файлы Wand, предварительно проверяя и сохраняя данные восстановления.

Онлайн-перевод читов и карт опционален: при включении непереведённый текст отправляется в Google Translate или MyMemory. По умолчанию онлайн-добор выключен. Сам установщик также проверяет наличие новой версии через GitHub Releases; при отсутствии сети эта проверка пропускается.

🚀 Как пользоваться

Шаг 1. Соберите WandRuInstaller.exe

GitHub соберёт .exe в облаке, вы скачаете результат. Ставить ничего не нужно, занимает ~5 минут.

A. Через GitHub Actions (рекомендуется):

1. Войдите в GitHub и нажмите Fork вверху этой страницы - у вас появится своя копия репозитория.
2. В своём форке откройте вкладку Actions и нажмите зелёную кнопку I understand my workflows, go ahead and enable them (GitHub спрашивает это один раз).
3. В списке слева выберите Build executable → справа нажмите Run workflow.
4. В поле variant выберите, что собрать, и подтвердите Run workflow:
   • classic (по умолчанию) - работает «из коробки», ничего ставить не надо (~130 МБ);
   • small - компактный (~2.4 МБ), нужен .NET 9 Desktop Runtime;
   • both - обе сборки сразу.
5. Через ~3-5 минут у запуска появится зелёная галочка. Откройте его и в блоке Artifacts внизу скачайте WandRuInstaller-classic (или -small).
6. Распакуйте zip - внутри WandRuInstaller.exe.

Хотите пересобрать после выхода новой версии WRP - в своём форке нажмите Sync fork, затем снова Run workflow.

B. Собрать локально (если есть .NET 9 SDK) - см. «Сборка из исходников».

Шаг 2. Русифицируйте

1. Запустите WandRuInstaller.exe.
2. Установщик найдёт Wand → нажмите «Русифицировать» → в окне «Что будем русифицировать?» отметьте компоненты (читы, карты, онлайн-добор) и подтвердите.
3. Дождитесь «Готово» → «Запустить Wand» прямо из установщика.
4. В Wand: Настройки → Язык → Русский.

Если используете Wand-Enhancer, выберите в нём режим Static. WRP и Enhancer можно применять в любом порядке. После изменения настроек или повторного применения Enhancer заново нажмите «Русифицировать» в WRP, если установщик попросит обновить перевод. Режим Supervised не поддерживается.

Если Wand запущен - закройте его перед установкой (или включите в настройках «Перезапустить Wand после установки», тогда установщик закроет и снова откроет его сам).

Откат

Закройте Wand, запустите установщик и нажмите «Откатить» - WRP восстановит сохранённые ярлыки. Если ярлык изменён и указывает на другую программу, WRP сохранит его и сообщит о конфликте. Если раньше использовался файловый патч WRP, его откат восстанавливает файлы из сохранённой резервной копии. Wand-Enhancer откатывается отдельно в самом Enhancer.

🛠️ Сборка из исходников

Требования:

• Windows 10/11
• .NET 9 SDK

Сборка:

cd WAND_RU
build.bat               :: обычная сборка
build.bat -Test         :: сборка + тесты, если локальный проект Installer.Tests доступен
build.bat -Publish      :: самодостаточный .exe (~130-150 МБ, .NET внутри - ничего ставить не надо)
build.bat -PublishSmall :: компактный .exe (~2.4 МБ, нужен .NET 9 Desktop Runtime на машине)

• -Publish → WAND_RU\publish\WandRuInstaller.exe (один файл, работает у всех «из коробки»).
• -PublishSmall → WAND_RU\publish-small\WandRuInstaller.exe (~2.4 МБ, но на машине должен стоять .NET 9 Desktop Runtime).

Тесты проекта хранятся локально и не входят в GitHub-репозиторий: на обычном клоне -Test недоступен.

Почему -Publish такой большой: он вшивает весь .NET-рантайм в exe. -PublishSmall рантайм не вшивает — отсюда ~2.4 МБ, но требует установленный .NET 9 Desktop Runtime. WPF нельзя обрезать (trimming), поэтому «золотой середины» между этими двумя нет.

❓ Q&A

• Нужен ли Node.js / что-то ещё? Нет. Установщик самодостаточный, всё делает нативно.
• Почему Windows Defender / SmartScreen ругается на мою сборку? .exe не подписан сертификатом. Нажмите «Подробнее» → «Выполнить в любом случае».
• Отправляет ли программа куда-то данные? Установщик проверяет новую версию через GitHub Releases. При включённом онлайн-переводе текст читов или карт отправляется в выбранный сервис перевода (Google/MyMemory).
• Нужно ли держать установщик открытым для онлайн-перевода? Нет. Помощник запускается вместе с Wand через сохранённый ярлык; для онлайн-добора также нужен интернет.
• Обновил Wand - русский пропал? Закройте Wand и снова нажмите «Русифицировать» в WRP. Совместимость с каждой будущей версией Wand не гарантирована: если приложение изменилось несовместимо, может потребоваться обновление WRP.
• Как обновить сам WRP? При выходе новой версии в шапке установщика появится баннер «Доступна v…» - клик откроет страницу релиза со списком изменений. Чтобы получить новый .exe: в своём форке нажмите Sync fork, затем Actions → Build executable → Run workflow и замените старый .exe собранным. Автоматически ничего не ставится и не качается.
• Почему в релизах нет готового .exe? Чтобы вы запускали только то, что собрали сами из открытого кода. Сборка в облаке GitHub - 5 минут и ноль установленных программ (см. Шаг 1).
• В моей игре читы переведены не все / коряво? Откройте issue с названием игры - добавим её в точные словари (все имена вручную, 100%).

🖼️ Скриншоты

🧩 Как это устроено

• Движок - нативный C# (.NET 9): запуск Wand через сохранённый ярлык и применение перевода из ru-overrides.json во время работы приложения. Для старых установок сохранён механизм отката.
• Перевод читов - renderer-скрипт (cheat-hook.js) запускается в процессе Wand: перехватывает ответы трейнера, переводит имена читов офлайн-словарём, а в онлайн-режиме допереводит остаток (Google → MyMemory) с локальным кэшем. Словарь и движок - JS, генерируются из одного источника. Приоритет перевода: точный per-game словарь (renderer/games/<gameId>.json) → офлайн-движок → онлайн-MT.
• UI - WPF, MVVM.

🔖 Чтобы не потерять проект

Вы собираете .exe сами - значит за каждой новой версией (новые игры, карты, исправления) вы будете возвращаться сюда, в оригинальный репозиторий: Sync fork → Run workflow. Свой форк в списке репозиториев потеряется среди прочих, поэтому:

• ⭐ Star - кладёт проект в ваш список избранного. Это ваша закладка: один клик из любого места GitHub - и вы снова здесь, за свежей сборкой.
• 🔔 Watch → Custom → Releases - GitHub сам пришлёт письмо, когда выйдет новая версия. Ничего проверять руками не нужно.

Список игр с точными словарями растёт по вашим заявкам: не переведена игра, коряво звучит чит, сломалась карта - откройте issue. Это напрямую превращается в следующий релиз.

🙏 Благодарности

Идея обхода ограничения и часть кода (asar-инструменты AsarSharp, UI-стиль) взяты из проекта Wand-Enhancer (© kitbyte, Apache-2.0). Респект ребятам за благое дело!

📜 Лицензия

См. файл LICENSE. Вендоренные компоненты из Wand-Enhancer - под Apache-2.0.

---

Дисклеймер: проект - сторонний инструмент для образовательных целей и локальной русификации интерфейса. Не распространяет проприетарный код и не обходит серверные проверки. Все изменения выполняются локально.

Сделано с любовью by LockBB1 ❤️ Поставьте ⭐, если WRP помог вам!