Patchlator

Patchlator

Клиентский мод для Fabric, который на лету переводит диалоги Wynncraft на ваш язык — прямо внутри кастомного HUD диалогов, сохраняя исходную разметку с точностью до пикселя.

• Minecraft 1.21.11 и 26.1.x (отдельный jar для каждой версии) · Fabric Loader ≥ 0.18.1 · Fabric API
• Работает с Google Translate (ключ не нужен) или DeepL; целевой язык по умолчанию совпадает с языком игры
• Переводит тело диалога и варианты ответов; вручную составленные записи в локальной таблице имеют приоритет над машинным переводом
• Опциональное логирование каждой исходной строки (с именем NPC) для составления этой таблицы
• Клавиша переключения, клавиша удержания для показа оригинала, экран настроек в игре
• Перехватывает финальный вывод оверлея, поэтому остаётся совместимым с модами, которые переписывают actionbar (например, Wynntils)

Как использовать

1. Поместите jar в .minecraft/mods вместе с Fabric API.

2. Зайдите на Wynncraft. Диалог переводится автоматически, как только анимация печатной машинки завершится.

   Клавиша (переназначаемая)	Действие
   F8	Открыть экран настроек
   F7	Включить/выключить перевод
   G (удерживать)	Показать оригинальный текст

3. Нажмите F8 — или используйте кнопку конфигурации ModMenu — чтобы открыть экран настроек:

   Настройка	Описание
   Translation	Главный переключатель вкл/выкл (то же, что и клавиша переключения)
   Translator	Google Translate / DeepL
   Google API Key	Необязательно. Пусто = неофициальный бесплатный эндпоинт, задано = официальный Cloud Translation v2
   DeepL API Key	Требуется для DeepL. Ключи, оканчивающиеся на :fx, используют бесплатный хост
   Source language	auto = определить автоматически
   Target language	auto = следовать языку игры; метка подсказывает код для вашего языка (например, fr, ja, zh-CN)

   Настройки сохраняются в config/patchlator.json.

4. Чтобы собрать предложения для таблицы переводов, запустите игру с -Dpatchlator.log=true — оригинальный диалог (плюс переводы) будет добавляться в .minecraft/patchlator.log. Имя игрока нормализуется до ``, чтобы записи можно было переиспользовать:

   time=… npc="Rusty Bartender" text="Would you like a Nemract Whiskey?" choice0="Yes." choice1="No, thank you."
   time=… translated npc="Rusty Bartender" text="Yes." result="Oui."

5. Чтобы вручную составить переводы, добавьте записи в config/patchlator/translations.json — они имеют приоритет над машинным переводом (перезагружается при сохранении экрана настроек):

   {
    "Would you like a Nemract Whiskey?": "Tu veux un whiskey de Nemract ?",
    "Greetings, <playername>!": "Salutations, <playername> !"
   }

Сборка

Требуется JDK 25 для Gradle JVM (исходники нацелены на Java 21 / 25 в зависимости от версии Minecraft).

./gradlew build -PmcVer=1.21.11   # → build/libs/patchlator-<v>+1.21.11.jar
./gradlew build -PmcVer=26.1.2    # → build/libs/patchlator-<v>+26.1.2.jar

Единая общая кодовая база, написанная под маппинги Mojang, поддерживает обе версии: для 1.21.11 плагин fabric-loom-remap ремапит jar на промежуточные имена; 26.1+ не обфусцирован, поэтому обычный плагин fabric-loom собирает его напрямую (один jar не может работать по обе стороны этой границы). Настройки для каждой версии хранятся в `versions/.properties, а немногочисленные различающиеся API изолированы в src/compat-remap/src/compat-modern(по одному классуCompat` в каждом). Поддержка будущей версии — это добавление файла свойств и, если API переместились, варианта compat.

Шрифты

Переведённый текст отрисовывается встроенными шрифтами (заменяемыми через -Dpatchlator.replacementFont):

• Pretendard — латиница, хангыль, кириллица, греческий
• Noto Sans SC (Medium, подмножество до диапазонов CJK) — кана, ханьские иероглифы, пунктуация CJK Вместе они покрывают все языки, включённые в файлы lang/ мода.

Лицензия

MIT. Встроенные шрифты лицензированы под SIL Open Font License 1.1.