/KuroTranslate-Tools

A fork of KuroTools for working with .tbl and .dat files, designed to create translations of Falcom games.

Primary LanguagePythonMIT LicenseMIT

KuroTranslate-Tools GitHub repo size GitHub last commit

Banner

Форк KuroTools, предназначенный для работы с файлами .tbl и .dat с целью создания переводов игр от Nihon Falcom.
Основано на nnguyen259/KuroTools

Этот набор инструментов предоставляет удобные средства для извлечения, редактирования и внедрения текста в игровые ресурсы, значительно упрощая процесс локализации.


✨ Особенности

  • 🖥️ Графический интерфейс: Интуитивно понятный лаунчер для запуска основных функций.
  • ⌨️ Режим терминала: Возможность запуска скриптов напрямую из командной строки (см. папку Start).
  • Работа с .dat (скрипты):
    • Дизассемблер: Преобразование бинарных .dat файлов в читаемый Python-код (.py).
    • Экспорт текста: Автоматическое извлечение потенциально переводимых строк из .py файлов в стандартный формат .xliff.
    • Импорт перевода: Внедрение переведенного текста из .xliff обратно в .py файлы.
    • Ассемблер: Сборка модифицированных .py файлов обратно в рабочие .dat файлы.
  • 📑 Работа с .tbl (таблицы):
    • Парсер: Основан на наработках Trevor_, позволяет извлекать данные из .tbl файлов (JSON/XLIFF).
  • ✏️ Встроенный XLIFF Редактор:
    • Удобное редактирование извлеченного текста.
    • Функция пагинации для работы с большими файлами.
    • Интеграция с автопереводчиком (DeepL/Google Translate) для ускорения процесса.

🖼️ Скриншоты

Лаунчер: Launcher Screenshot

Редактор XLIFF: Editor Screenshot

🚀 Начало работы

  1. Клонируйте репозиторий:

    git clone https://github.com/Stamir36/KuroTranslate-Tools.git
    cd KuroTranslate-Tools
  2. Установите зависимости: (Создайте файл requirements.txt со следующим содержимым):

    colorama
    astunparse
    lxml
    customtkinter
    pygments
    deep_translator

    Убедитесь, что у вас установлен Python 3.x и pip. Затем выполните:

    pip install -r requirements.txt
  3. Запустите лаунчер: Дважды кликните по файлу KuroTranslate.bat (для Windows) или запустите соответствующий скрипт лаунчера через Python.

🛠️ Использование (Терминал)

Основные скрипты для работы из командной строки находятся в папке Start (или в корне на прямую).

  • Декомпиляция .dat в .py (пакетно):
    python dat2py_batch.py
    # Скрипт запросит путь к папке с .dat файлами
  • Экспорт строк из .py в .xliff:
    python py_to_xliff.py
  • Импорт перевода из .xliff в .py:
    python xliff_to_py.py
  • Компиляция .py в .dat (пакетно):
    python py2dat_batch.py

🤝 Участие и поддержка

  • Об ошибках и предложениях сообщайте через Issues.
  • Пул-реквесты приветствуются!