SW:EaW Localization Suite

Комплекс утиліт для локалізації ігор на рушії Alamo (Star Wars: Empire at War). Автоматизує процес від екстракції бінарних даних до ШІ-перекладу та ручної коректури.

Утиліти

EaWLocalizationTool.GUI — WPF-редактор DAT-файлів для ручного перекладу та перевірки, призначений для моддерів, яким потрібен повний контроль над локалізацією. Завантаження оригінального DAT + джерела перекладу (TSV або інший DAT); фільтрація за статусом (Всі / Без перекладу / Перекладено / Змінено / Проблемні / Технічні); автоматична валідація \n, %s/%d, [тегів] та <тегів>; розумне визначення технічних рядків (заглушки, роздільники crawl-тексту, фрази DO NOT DISPLAY, маркер TEXT_END_OF_DATA); контекстне меню (копіювати оригінал, вставити оригінал як переклад, очистити переклад, копіювати ключ); безпечний запис зі збереженням CRC32 та ключів — побайтова копія оригіналу; автозбереження резервної копії з налаштовуваним інтервалом; логування помилок та подій для діагностики крашів; темна/світла тема з масштабуванням шрифту; експорт у TSV для роботи в Excel/Google Sheets.

EaWLocalizationTool (консоль) — екстракція XML/DAT/TXT у TSV, зіставлення з перекладом, пакування назад зі збереженням CRC32.

StarWarsLocalizer — ШІ-перекладач на базі Gemini API (3.1 Flash Lite / 2.5 Flash) з дворівневою перевіркою галюцинацій і контролем технічних токенів.

EaWTextureConverter — WPF-інструмент для пакетної конвертації DDS-текстур між PNG і DDS без зовнішніх exe, сумісний з будь-яким модом EaW/FoC. Рекурсивне сканування папки моду або ручне додавання файлів; конвертація DDS → PNG зі збереженням альфа-каналу (Magick.NET, DXT1/DXT3/DXT5) і PNG → DDS власним бінарним writer (uncompressed BGRA 32bpp, формат сумісний з DirectX 9/рушієм Alamo); автоматичне визначення кореня моду по структурі Data\Art без хардкоду назв; підтримка обох структур EaW (Data\Art\Textures і Data\patch2\DATA\ART\TEXTURES) зі збереженням повної відносної структури папок у виводі; сортування по колонках, вибір/зняття всіх файлів, двомовний інтерфейс, темна і світла тема.

MEGExtractor — інструмент для роботи з .meg архівами гри.

Вимоги

Windows 10/11 x64, .NET 10 Desktop Runtime

Завантаження

Актуальні релізи доступні на GitHub Releases.

Безпека та прозорість

Вихідний код усіх утиліт та скрипт інсталятора Inno Setup повністю відкриті. Основні інструменти портативні й працюють без спеціальних прав: скрипт SetupFonts.bat автоматично визначає версію ОС — на сучасних Windows (10 версії 1809+ та 11) дозволяє встановлення шрифтів локально без прав адміністратора, а для старіших систем або глобального встановлення безпечно запитує підвищення прав через UAC.

Інсталятор використовує HKEY_CURRENT_USER виключно для роботи деінсталятора та відстеження версії (запобігання дублюванню); SetupFonts.bat вносить зміни до гілки Fonts (у HKEY_CURRENT_USER або HKEY_LOCAL_MACHINE залежно від вибору) для офіційної реєстрації шрифтів, необхідної рушію гри. API-ключі Gemini вводяться користувачем вручну й не зберігаються в репозиторії.

Деінсталятор повністю видаляє всі файли локалізації та власні записи в реєстрі, а перед автоматичним видаленням встановлених шрифтів із системи — інтерактивно запитує підтвердження.

Файли перевірені модерацією Nexus Mods та VirusTotal. Відсутність цифрового підпису є нормою для некомерційних фанатських проєктів.

Пов’язаний проєкт

Розроблено для Star Wars: Empire at War — Українська локалізація.

Подяки

  • Gemini API — основний лінгвістичний рушій
  • CsvHelper — обробка TSV таблиць
  • Magick.NET — декодування DDS
  • ImageSharp — обробка PNG
  • BCnEncoder.NET — BCn кодування
  • Inno Setup — інсталятор
  • Exo 2 — база для українських шрифтів гри