/steama4-localizer

Primary LanguagePython

🎮 Steam Achievement Localizer

Ці скрипти призначені для локалізації досягнень Steam. Вони дозволяють налаштувати відображення назв та описів досягнень для особистого використання.

⚠️ Важлива інформація

  • Локальний ефект: Переклади застосовуються виключно локально на вашому пристрої. Інші користувачі Steam бачитимуть оригінальні дані досягнень.
  • Обмежене відображення: В окремих інтерфейсах Steam перекладені досягнення можуть не відображатися належним чином.

🚀 Інструкція з використання

Дотримуйтесь наведених кроків для успішної локалізації:

  1. Встановлення Python:

    • Переконайтеся, що Python встановлено на вашій системі.
    • Під час встановлення додайте Python до системної змінної PATH. Це критично для коректного виконання скриптів.

  2. Визначення ідентифікатора гри:

    • Відкрийте сторінку гри в магазині Steam.
    • Ідентифікатор гри (App ID) — це числовий сегмент у URL-адресі. Приклад: https://store.steampowered.com/app/460790/Bayonetta/ – App ID 460790.

  3. Копіювання файлу схеми досягнень:

    • Перейдіть до директорії
      • Windows <Папка встановлення Steam>\appcache\stats\
      • Linux <Папка бібліотеки Steam>\appcache\stats\ (або відповідної).
    • Знайдіть файл UserGameStatsSchema_<App ID>.bin (наприклад, UserGameStatsSchema_460790.bin).
    • Скопіюйте цей файл до вашої робочої директорії (наприклад, туди, де знаходяться скрипти).

  4. Створення резервної копії:

    • Обов'язково створіть резервну копію скопійованого файлу UserGameStatsSchema_<App ID>.bin. Перейменуйте його (наприклад, на UserGameStatsSchema_<App ID>_backup.bin) або збережіть у безпечному місці.

  5. Конфігурація скриптів:

    • Відкрийте файли extract_achievements.py та create_achievements.py у текстовому редакторі.
    • Відредагуйте їхні параметри відповідно до ваших вимог, зокрема вкажіть App ID гри.

  6. Видобування та переклад тексту:

    • Запустіть скрипт extract_achievements.py.
    • У робочій директорії буде створено файл .txt (наприклад, ачівки.txt).
    • Відкрийте цей .txt файл і здійсніть переклад тексту досягнень. Зберігайте вихідний формат файлу.

  7. Генерація локалізованого файлу:

    • Після завершення перекладу запустіть скрипт create_achievements.py.
    • Буде згенеровано новий модифікований файл UserGameStatsSchema_<App ID>.bin.

  8. Заміна та перезапуск Steam:

    • Замініть оригінальний файл UserGameStatsSchema_<App ID>.bin у директорії стіма (відповідно до вашої ОС) на щойно створений модифікований файл.
    • Перезапустіть клієнт Steam для застосування змін.

❓ Проблеми та підтримка

Якщо будуть проблемами, будь ласка, звертайтеся до розділу Issues на цьому репо. Опишіть вашу проблему, і я спробую вам допомогти.