autotranslator

AutoTranslator – умный перевод модов Minecraft на базе ИИ https://img.shields.io/badge/License-MIT-green https://img.shields.io/badge/NeoForge-1.21.1-blue https://img.shields.io/badge/Translation%2520Data-CC%2520BY--NC--SA%25204.0-lightgrey

Перевод с помощью ИИ в один клик – попрощайтесь с непереведёнными модами! AutoTranslator – это клиентский мод для NeoForge 1.21.1, который использует любую настроенную вами модель ИИ (локальную или облачную) для пакетного перевода всех языковых файлов установленных модов на упрощённый китайский и автоматически упаковывает их в ресурспак для мгновенного применения.

✨ Ключевые возможности 🤖 Автоматизация на базе ИИ Больше не нужно вручную искать пакеты переводов. Просто настройте конечную точку API вашего ИИ, нажмите «Начать перевод», и все отсутствующие китайские записи будут сгенерированы автоматически. Наслаждайтесь полностью локализованным опытом за считанные минуты.

📚 Встроенная база терминов Перед отправкой запросов к ИИ мод обращается к локальному словарю SQLite (на основе проекта CFPA) для поиска известных терминов Minecraft. Это обеспечивает единообразие переводов и резко сокращает количество вызовов API, экономя затраты на токены.

🔗 Совместимость с i18n-ресурспаками Уникальная интеграция с существующими i18n-ресурспаками (например, Minecraft-Mod-Language-Modpack). Мод может читать переводы из внешнего китайского ресурспака и отправлять ИИ только оставшиеся отсутствующие записи. Это ещё больше снижает затраты и повышает общее качество.

⚙️ Полная прозрачность и контроль Игровой GUI для удобной настройки: URL API, ключ, имя модели, локальный/удалённый режим и т. д.

Подробный отладочный лог в config/autotranslator/debug.log – отслеживает каждый запрос, попадание в словарь и прогресс.

Фильтрация по белому/чёрному списку для перевода только определённых модов.

Ручная остановка в любой момент без повреждения созданного пака.

Атомарная замена ресурспака – временный файл атомарно перемещается в итоговый пак, предотвращая неполное чтение.

📦 Быстрый старт

1. Установка Поместите .jar мода в папку mods и запустите игру.

2. Откройте настройки В главном меню перейдите в Mods, найдите AutoTranslator в списке и нажмите кнопку Configure (значок шестерёнки).

3. Введите данные API API URL: например, https://api.deepseek.com/v1/chat/completions (облако) или http://localhost:1234/v1/chat/completions (локальный LM Studio).

API Key: для облачных сервисов введите ваш ключ. Для локальных моделей подойдёт любая строка (например, lm-studio).

Model Name: точный идентификатор модели, например deepseek-chat, qwen2.5-7b-instruct.

Local Mode: включите при использовании локального API (задачи выполняются последовательно, чтобы избежать перегрузки).

4. (Необязательно) Расширенная настройка Отредактируйте config/autotranslator/config.json для скрытых настроек (сохраняются между сохранениями, хотя их нет в GUI):

timeout_seconds: тайм-аут запроса в секундах (по умолчанию 300; рекомендуется 600 для медленных локальных моделей).

batch_size: количество записей на один вызов ИИ (по умолчанию 30; уменьшите до 10 при возникновении тайм-аутов).

requests_per_second: максимум вызовов API в секунду (по умолчанию 5; можно увеличить для локальных моделей).

filter_mode / filter_list: фильтрация модов (белый/чёрный список).

system_prompt: пользовательские инструкции для перевода ИИ.

i18n_resourcepack_name: имя файла внешнего i18n-ресурспака; установите "none" для отключения (см. раздел о совместимости с i18n ниже).

5. Начните перевод Убедитесь, что ресурспак AutoTranslation.zip отключён на экране «Ресурспаки» перед началом.

Вернувшись на экран настроек, нажмите «Начать перевод».

Прогресс отображается внизу. После завершения нажмите F3+T, чтобы перезагрузить ресурспаки.

🌐 Совместимость с i18n-ресурспаками (подробно) Если у вас есть поддерживаемый сообществом i18n-пак, например Minecraft-Mod-Language-Modpack-Converted-1.21.1.zip, поместите его в папку resourcepacks и обновите config.json:

json

"i18n_resourcepack_name": "Minecraft-Mod-Language-Modpack-Converted-1.21.1.zip"

При переводе мод извлечёт все китайские строки из этого пака и перезапишет ими свой вывод. На ИИ будут отправлены только те ключи, которых всё ещё не хватает. Это позволяет сэкономить более 70% вызовов API.

Приоритет: i18n-пак > предыдущий кэш AutoTranslator > перевод ИИ. Включение: после изменения конфига нажмите «Reload File» в GUI или перезапустите игру.

⚠️ Важные замечания Конфликт ресурспаков: всегда отключайте существующий AutoTranslation.zip в меню ресурспаков перед запуском нового перевода.

Проблемы с сетью: если в некоторых регионах не удаётся скачать словарь или получить доступ к GitHub, добавьте -Djava.net.useSystemProxies=true в JVM-аргументы лаунчера и включите системный прокси.

Расход токенов: при использовании облачных API учитывайте тарификацию токенов. Использование встроенного словаря и i18n-пака резко снижает затраты.

Настройка локальной модели: задайте большее время ожидания (например, 600 секунд) и меньший размер пакета (например, 10), чтобы избежать таймаутов запросов.

Безопасность: этот мод работает только на клиенте, не изменяет основные файлы игры и лишь добавляет ресурспак.

📂 Структура файлов text

config/autotranslator/ ├── config.json # Пользовательская конфигурация ├── debug.log # Подробный лог перевода └── dict/ └── Dict-Sqlite.db # Автоматически загружаемая база терминов Minecraft resourcepacks/ └── AutoTranslation.zip # Сгенерированный китайский ресурспак

🤝 Открытый исходный код и атрибуция Встроенная база переводов этого мода взята из CFPATools/i18n-dict, оригинальные данные поддерживаются CFPAOrg/Minecraft-Mod-Language-Package под лицензией Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).

Код мода распространяется под лицензией MIT.

📝 Отладка и логи Все действия по переводу записываются в config/autotranslator/debug.log с временными метками ([HH:mm:ss]). Лог ведётся на китайском для удобства разработчика.

Следить в реальном времени:

bash

tail -f config/autotranslator/debug.log

💡 FAQ В: Почему некоторые записи не переводятся? О: Обычно это таймаут API или некорректный ответ. Увеличьте timeout_seconds, уменьшите batch_size и проверьте название модели.

В: Как переводить только определённые моды? О: Установите filter_mode в whitelist и добавьте ID модов в filter_list (через запятую) в config.json.

В: Как обновить встроенный словарь? О: Словарь обновляется автоматически каждые 7 дней. Либо удалите config/autotranslator/dict/Dict-Sqlite.db и перезапустите игру.

В: Можно ли делиться сгенерированным ресурспаком? О: Конечно! AutoTranslation.zip — это стандартный ресурспак, им можно свободно делиться.

https://cdn.modrinth.com/data/cached_images/201d572314f68fa6a6011f19a22bb8872c4ef91e.jpeghttps://cdn.modrinth.com/data/cached_images/68b0c03b013c378b181377b37236ac4cb5f49935.jpeg