Утилита для редактирования сохранений Borderlands 4! Python-инструмент для дешифровки/шифровки сохранений Borderlands 4. Включает экспериментальное редактирование предметов. Внимание: Автор не несёт ответственности за повреждённые сохранения! Всегда делайте резервную копию перед редактированием. Читаемые сохранения (1.sav, 2.sav и т.д.) содержат инвентарь, характеристики и т.д. Косметика и настройки игры в profile.sav.

Основные функции:

• Decrypt Save File — Дешифровка файла сохранения (преобразует .sav в редактируемый YAML)
• Edit YAML — Редактирование YAML (изменяйте значения в текстовом редакторе, учитывая отступы YAML)
• Encrypt Save File — Шифровка файла сохранения (преобразует отредактированный YAML обратно в .sav)
• Decode Item Serials (Experimental) — Декодирование серийных номеров предметов (добавляет секцию _DECODED_ITEMS в YAML для редактирования)
• Edit Item Stats — Редактирование характеристик предметов (в секции _DECODED_ITEMS: primary_stat — основной урон/мощность, secondary_stat — вторичные характеристики, rarity — редкость, manufacturer — производитель, item_class — класс предмета, level — уровень)
• Encode Item Serials (Experimental) — Кодирование серийных номеров предметов (применяет изменения из _DECODED_ITEMS, удаляет секцию и шифрует сохранение)

Поддерживаемые типы предметов (экспериментально):

• Weapons (@Ugr) — Оружие (высокая уверенность: декодирование урона, редкости, производителя)
• Equipment (@Uge) — Снаряжение (высокая/средняя уверенность: декодирование характеристик и свойств)
• Equipment Alt (@Ugd) — Альтернативное снаряжение (высокая/средняя уверенность)
• Special Items (@Ugw, @Ugu, @Ugf, @Ug!) — Специальные предметы (низкая уверенность: общее декодирование)

Как использовать (базовое редактирование без предметов):

1. Дешифруйте сохранение: python blcrypt.py decrypt -in 1.sav -out save.yaml -id YOUR_STEAM_ID (замените YOUR_STEAM_ID на ваш Steam ID)
2. Отредактируйте save.yaml в текстовом редакторе (будьте осторожны с отступами YAML)
3. Зашифруйте обратно: python blcrypt.py encrypt -in save.yaml -out 1.sav -id YOUR_STEAM_ID
4. Замените оригинальный файл сохранения на новый 1.sav

Расширенное редактирование с предметами (экспериментально):

1. Дешифруйте с декодированием: python blcrypt.py decrypt -in 1.sav -out save.yaml -id YOUR_STEAM_ID --decode-serials (добавит секцию _DECODED_ITEMS)
2. Отредактируйте характеристики в _DECODED_ITEMS (например, primary_stat для урона, rarity для редкости)
3. Зашифруйте с кодированием: python blcrypt.py encrypt -in save.yaml -out 1_modified.sav -id YOUR_STEAM_ID --encode-serials (секция _DECODED_ITEMS удалится автоматически)
4. Замените оригинальный файл сохранения

Подробная справка:

• python blcrypt.py decrypt --help — Справка по дешифровке
• python blcrypt.py encrypt --help — Справка по шифровке

Установка:

1. Скачайте Python 3.7+ и установите
2. Распакуйте архив с утилитой
3. Установите зависимости: pip install -r requirements.txt (требует pycryptodome для криптографии)
4. Рекомендуется: Используйте виртуальное окружение (venv) для Python, чтобы избежать конфликтов

Требования:

• Python 3.7+ (установленный)
• pycryptodome (устанавливается через pip)
• Borderlands 4 (PC-версия, Steam)

Совместимость:

Утилита протестирована на PC-версии Borderlands 4 (Steam). Работает с numbered saves (1.sav и т.д.) для инвентаря/характеристик и profile.sav для косметики/настроек. Предметы с "high" confidence наиболее надёжны для редактирования. Для обмена сохранениями используйте Steam ID оригинального владельца для дешифровки, затем шифруйте с вашим ID.

Важные замечания:

• Steam ID: 17-значное число, начинающееся с 7656119... Найдите в папке сохранений: C:\Users\{username}\Documents\My Games\Borderlands 4\Saved\SaveGames (имя папки — это ID)
• Steam ID должен совпадать с владельцем оригинального сохранения (для обмена укажите ID другого человека)
• Редактируйте numbered saves для предметов/инвентаря, profile.sav для косметики
• При редактировании предметов держите значения в разумных пределах (начните с небольших изменений)
• Секция _DECODED_ITEMS удаляется автоматически при шифровке

Устранение неисправностей:

• PKCS7 padding error: Неправильный Steam ID
• zlib decompression error: Неправильный Steam ID или повреждённый файл
• File size not multiple of 16: Файл повреждён или не является валидным сохранением BL4

Внимание: Всегда делайте резервную копию сохранений перед использованием! Папка сохранений: C:\Users\[Ваше_имя]\Documents\My Games\Borderlands 4\Saved\SaveGames. Используйте утилиту на свой страх и риск. Если хотите помочь с маппингом ID предметов — экспериментируйте и оставьте комментарий или issue на GitHub для обновления README.