Auto Russian Translator

# Auto Russian Translator (Авторусификатор)

**A client-side Forge mod that makes your whole modpack Russian — automatically.** Put the jar for your Minecraft version into `mods` and play: untranslated text of your mods gets Russian translations in the background, without restarting the game.

### What it does

- **Uses Russian text that already exists.** The mod collects translations from your resource packs, from the mods' own `ru_ru` files, and from the official game translation on Mojang servers. It also takes community translation packs on Modrinth and the language files of other versions of your mods on Modrinth. From mod jars, only the two language files are read — the jar itself is never downloaded.
- **Translates what is still missing.** Missing text goes to Google Translate. If Google is temporarily unavailable, an optional local LibreTranslate server on your PC takes over, and those strings are re-translated by Google later.
- **Shared translation memory.** All translations are stored once per PC and reused by every modpack. A new mod whose text is already known gets translated instantly, offline.
- **Applies translations live**, switches the game to Russian once on first launch, and repairs broken russifier files the game would otherwise skip.
- **Never overwrites real translations**: the mod's own Russian text, your resource packs and the server's pack always win.

**Requirements:** Minecraft Forge 1.19.2 – 1.21.11 and 26.1 – 26.3 — download the file for your game version. Client only: not needed on servers and does not change anything over the network.

**Network and privacy:**

- **Google Translate:** only the untranslated English strings of your mods.
- **Mojang servers:** the official Russian translation of the game is downloaded from them.
- **Modrinth API:** receives your game version and the SHA-1 checksums of jars in `mods`, so Modrinth can tell which mods you have.
- **No personal data is sent.**
- **Turning it off:** set `onlineSources` and `machineTranslation` in `config/autorus/config.json`.

---

## По-русски

**Авторусификатор** — клиентский мод для Forge, который сам делает модовую сборку русской. Найдёт строки модов без перевода и дополнит их — в фоне, без перезапуска игры.

### Откуда берётся перевод

1. **Готовые русификаторы** из папки `resourcepacks` (в том числе вложенные архивы, которые игра сама пропускает) и из `config/autorus/import`.
2. **Официальный перевод игры** с серверов Mojang — для всех версий, начиная с 1.19.
3. **Переводы с Modrinth:**
   - до 50 самых скачиваемых русификаторов для вашей версии игры;
   - русские языковые файлы из других версий ваших модов и из 1000 популярных модов.
   Из jar скачиваются только оглавление и файлы `en_us.json`/`ru_ru.json`, сам jar не качается. На сборке из 171 мода другие версии тех же модов закрыли 1930 из 4852 непереведённых строк.
4. **Машинный перевод Google** — для того, чего нет нигде. Если Google временно недоступен, переводит LibreTranslate на вашем ПК (по желанию, ставится отдельно). Потом эти строки тихо переводятся Google заново.

Всё это копится в **общей памяти переводов** — одной на ПК для всех сборок и версий игры. Если английская строка уже где-то переведена, новый мод получает перевод сразу и без интернета, в том числе строки с другими числами и в другом регистре.

### Что ещё умеет

- Применяет перевод сразу, без перезапуска; при первом запуске один раз переключает игру на русский.
- Чинит русификаторы с ошибками (лишняя запятая и т. п.), которые игра пропустила бы целиком.
- Не трогает чат, таблички и ники; не добавляет блоков, предметов и сетевых каналов.
- Готовые переводы никогда не перезаписываются: русский текст из самих модов, ваших ресурс-паков и пака сервера всегда важнее.

### Установка

Скачайте файл своей версии Minecraft (1.19.2 – 1.21.11, 26.1 – 26.3) и положите в `.minecraft\mods`. Нужен Forge своей ветки. Мод только клиентский: на сервер его ставить не нужно, в списке серверов нет красного крестика. Старый Universal Translator уберите — вместе они переводят дважды.

### Команды

Свои правки перевода — в `config/autorus/overrides.json` (`{"ключ": "текст"}`), они важнее всего.

### Настройки

Файл `config/autorus/config.json`:

### Сеть и приватность

- **Google:** только английские строки модов, которые нужно перевести.
- **Mojang:** с серверов скачивается официальный перевод игры.
- **Modrinth:** уходят версия игры (для поиска) и контрольные суммы SHA-1 jar из папки `mods` (чтобы узнать, что это за моды).
- **Личные данные** никуда не отправляются.

Первый проход по модам Modrinth — около 150–250 МБ и 40–60 минут в фоне. Дальше раз в неделю проверяются только изменения.

### LibreTranslate (по желанию)

Запасной переводчик на время, когда Google недоступен. Установите [LibreTranslate](https://github.com/LibreTranslate/LibreTranslate) (`pip install libretranslate`) и запустите `libretranslate --port 5071 --load-only en,ru`. Мод сам будет им пользоваться, пока Google на паузе. Без LibreTranslate мод тоже работает: перевод просто подождёт, пока Google снова станет доступен.