jestelf / BG3-rulocalizer

Этот репозиторий содержит набор Python-скриптов и/или исполняемый файл `bg3localith.exe`, предназначенный для автоперевода (и ручного редактирования перевода) модов Baldur's Gate 3. Работает совместно с утилитой BG3-Modders-Multitool, обеспечивающей распаковку модов.

bg3localith – Локализатор Baldur's Gate 3 Модов

Краткое описание:
bg3localith — это консольное/GUI-приложение на Python (или его скомпилированная версия bg3localith.exe без исходного кода), предназначенное для локализации модов Baldur's Gate 3 на русский язык. Работает в связке с BG3-Modders-Multitool, позволяющим распаковать моды в папку UnpackedMods.

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

1. Получить/Распаковать моды
   Скачайте BG3-Modders-Multitool и с помощью bg3-modders-multitools.exe распакуйте ваши моды Baldur's Gate 3 в папку UnpackedMods.

2. Указать директорию с UnpackedMods
   Запустите bg3localith (если у вас собранный исполняемый файл, то это будет bg3localith.exe). При первом старте программа попросит указать путь к папке, содержащей UnpackedMods.

3. Выбрать моды/файлы для перевода

   • Программа просканирует папку UnpackedMods, найдёт все .xml файлы (обычно english.xml и russian.xml) и отобразит их.
   • Можно выбрать конкретный мод или файл english.xml.

4. Процесс перевода

   • Автоперевод (Google Translate): Одной кнопкой перевести не готовые строки.
   • Вручную: Редактировать ячейки таблицы «Оригинал»/«Перевод».
   • Импорт пар: Если у вас есть заранее подготовленный TXT со строками вида Hello|Привет, можно импортировать его и автоматически заполнить переводы.

5. Сохранение

   • Программа создаст (или обновит) russian.xml (и при необходимости директорию Russian) внутри UnpackedMods для выбранного мода.
   • Переведённые строки сохранятся автоматически.

Работа с bg3localith.exe

• bg3localith.exe — скомпилированный вариант, в котором нет видимой структуры Python-файлов.
• При запуске:
  1. Открывается графический интерфейс (GUI).
  2. Вы указываете путь к UnpackedMods.
  3. Автоматически читаются доступные моды.
  4. Вы можете переводить их аналогично описанным выше шагам.

Дополнительные возможности

• Прогресс-бар в приложении показывает ход перевода, загрузки модов или импорта пар.
• Левенштейново сопоставление (опция) — позволяет подтягивать переводы для строк, которые похожи на уже переведённые (например, опечатки в оригинале).

Пример структуры директорий:

BG3Localization/
├── bg3localith.exe       # Готовый исполняемый файл
├── bg3-modders-multitools.exe
├── UnpackedMods/
│   ├── SomeMod/
│   │   ├── Localization/
│   │   │   ├── English/
│   │   │   │   └── english.xml
│   │   │   └── Russian/
│   │   │       └── russian.xml
│   ├── AnotherMod/
│   │   └── Localization/
│   │       └── ...
└── ...

Установка и сборка из исходников

1. Откройте терминал или командную строку и выполните:

   git clone https://github.com/jestelf/BG3-rulocalizer.git
   cd BG3-rulocalizer
   pip install -r requirements.txt
   

2. Если необходимо собрать в exe: Пример использования PyInstaller:

   pyinstaller --onefile main_translator.py

   Или, чтобы включить нужные ресурсы/иконки, можно модифицировать команду:

   pyinstaller --onefile --icon=icon.ico main_translator.py

После этого в папке dist будет готовый исполняемый файл (например, main_translator.exe).

Лицензия

Все права на продукт bg3localith (исходный код, бинарные сборки) защищены и остаются за автором LICENSE.

• Разрешается использование, модификация, форк в личных/некоммерческих целях.
• Коммерческое использование возможно только после согласования с автором.

Обращайтесь при любых вопросах.