Hollywood Editor

Обновленный инструмент для безопасного редактирования файлов сохранений игры Hollywood Animal.

Премечание

Данный проект является преемником проекта HollyJson, первоначально разработанного BioNoob (Yakor). После передачи исходного кода и прекращения активной разработки оригинальным автором, проект был взят мной на поддержку и дальнейшее развитие.

Возможности и функциональность

• Редактирование файлов сохранений: Позволяет пользователям открывать и изменять файлы сохранений в формате JSON.
• Управление персонажами: Предоставляет функциональность для просмотра, фильтрации и редактирования атрибутов персонажей, включая:
  • Основная информация: Имя, возраст, портрет.
  • Атрибуты: Настроение, отношение, лимит.
  • Детали контракта: Изменение условий контракта, зарплаты, даты подписания и т.д.
  • Навыки и черты: Добавление или удаление навыков и черт.
  • Принадлежность к студии: Изменение студии, к которой привязан персонаж.
• Проверка данных: Реализована проверка вводимых данных для обеспечения целостности таких полей, как возраст, числа с плавающей точкой и строки.
• Поддержка локализации: Читает данные локализации из JSON-файлов для отображения переведённых названий и описаний.
• Управление ресурсами: Извлекает файлы ресурсов (изображения, локализация) из сжатых архивов при запуске.

Технологический стек

• C#: Основной язык программирования.
• WPF: Windows Presentation Foundation для пользовательского интерфейса.
• Newtonsoft.Json: Библиотека для сериализации и десериализации JSON.
• PropertyChanged.Fody: Библиотека, автоматически реализующая интерфейс
  INotifyPropertyChanged
  .
• System.IO.Compression: Используется для извлечения ресурсов из архивов.

Предварительные требования

• Операционная система Windows
• .NET Framework 4.7.2 или новее (требуется для WPF) - должна быть предустановлена в современных версиях Windows.

Инструкция по установке

1. Скачайте последнюю версию из репозитория GitHub.
2. Распакуйте загруженный архив в выбранную вами директорию.
3. Запустите исполняемый файл
   HollywoodEditor.exe
   .

Руководство по использованию

1. Открытие файла сохранения:

   • Нажмите кнопку "Open File".
   • Выберите "OFD", чтобы открыть файл сохранения. Файлы сохранений находятся в
     %localappdata%Low\Weappy\Hollywood Animal\Saves\Profiles
     .

2. Выбор локали:

   • Нажмите кнопку "Open File" и выберите директорию с locale json.
   • Перейдите в директорию установки Hollywood Animal, затем в
     Hollywood Animal_Data\StreamingAssets\Data\Localization\RUS
     .
   • Выберите папку
     RUS
     , содержащую файлы локализации.
   • Нажмите "Select Folder".

3. Фильтрация персонажей:

   • Используйте выпадающий список
     Filter_studio
     для фильтрации персонажей по студии, к которой они принадлежат.
   • Используйте выпадающий список
     Filter_Prof
     для фильтрации персонажей по их профессии.
   • Введите текст в текстовое поле
     Filter_txt
     для поиска персонажей по имени.
   • Используйте флажок
     ShowOnlyTalent
     , чтобы показывать только таланты (персонажей).
   • Используйте флажок
     ShowOnlyDead
     , чтобы показывать только мёртвых персонажей.
   • Используйте флажок
     ShowWithDead
     , чтобы включать мёртвых персонажей в результаты.

4. Редактирование атрибутов персонажа:

   • Выберите персонажа из списка.
   • Измените атрибуты в разделе с деталями персонажа.
   • Текстовые поля используют свойство Tag для проверки ввода:
     • STR
       : Разрешает ввод строк.
     • INT
       : Разрешает ввод целых чисел.
     • AGE
       : Разрешает ввод целых чисел до 150.
     • DBL
       : Разрешает ввод чисел с плавающей точкой.
     • LMT
       : Разрешает ввод чисел с плавающей точкой от 0 до 1.

5. Добавление/Удаление навыков и черт:

   • Выберите персонажа из списка.
   • Чтобы добавить навык, выберите его из выпадающего списка и нажмите кнопку "+".
   • Чтобы удалить навык, нажмите кнопку "X" рядом с навыком в списке.
   • Чтобы добавить черту, выберите её из выпадающего списка и нажмите кнопку "+".
   • Чтобы удалить черту, нажмите кнопку "X" рядом с чертой в списке.

6. Сохранение изменений:

   • Нажмите кнопку "Save".
   • Выберите место для сохранения изменённого файла сохранения. Рекомендуется создавать резервные копии оригинальных файлов сохранений.

Рекомендации по внесению вклада

1. Сделайте форк репозитория.
2. Создайте новую ветку для вашей функции или исправления ошибки.
3. Реализуйте свои изменения, обеспечивая качество кода и добавляя соответствующие тесты.
4. Отправьте pull request с четким описанием ваших изменений.