game patches

Ксения Канарейка Игровые патчи

В этом репозитории собраны игровые патчи для Xenia Canary.
Документацию по плагину можно найти здесь.

Вопросы, не связанные с исправлениями, относятся к серверу Xenia Discord.

Это НЕ настоящие игры или обновления!
Прочтите Краткое руководство Ксении, чтобы получить игры.

Установка/Обновление

0. Предварительные условия
   • Последний эксперимент Ксении Канарейки.
     • Патчи не поддерживаются в основных или устаревших версиях Xenia Canary.
1. Загрузите этот zip-архив.
2. Перейдите туда, где находится xenia_canary.exe .
3. Удалите папку patches , если она есть (при необходимости сделайте резервную копию).
4. Откройте game-patches.zip и извлеките patches в тот же каталог, что и xenia_canary.exe . Структура папок должна выглядеть так:
   

    └─── Xenia Canary
       |  ...
       │  xenia_canary.exe
       |  ...
       └─── patches
               ...
               584111F7 - Minecraft (XBLA, TU0).patch.toml
               ...
   

5. Перейдите к разделу ниже.

Как использовать

0. Предварительные условия
   • Последний эксперимент Ксении Канарейки
     • Патчи не поддерживаются в основных или устаревших версиях Xenia Canary.
   • Правильная версия игры, например Обновление названия (TU).
   • apply_patches установлено значение true (по умолчанию) в конфигурации Xenia Canary.
1. Откройте файл .patch.toml, соответствующий вашей игре, в текстовом редакторе (Блокнот, VSCode, VSCodium, Notepad++ и т. д.).
2. Измените is_enabled с false на true . Например, чтобы включить патч 60 FPS:

   [[ patch ]]
       name = " 60 FPS "
       desc = " Description "
       author = " Author "
       is_enabled = false
   
       [[ patch . be8 ]]
           address = 0 x########
           value = 0 x##

   становится

   [[ patch ]]
       name = " 60 FPS "
       desc = " Description "
       author = " Author "
       is_enabled = true
   
       [[ patch . be8 ]]
           address = 0 x########
           value = 0 x##

Если вы видите [Patches Applied] в строке заголовка, значит, исправления применены успешно.

Не меняйте хеш существующих патчей. Если у вас другая версия игры, то патч(и) необходимо перенести на эту версию.

Примечания об исправлениях соотношения сторон

• present_letterbox необходимо изменить с true на false !
• Патчи соотношения сторон не увеличивают разрешение!
• Хотя большинство патчей с соотношением сторон имеют соотношение сторон 21:9 (3440/1440), их также можно изменить на другие соотношения сторон, если не указано иное;
  1. Разделите ширину разрешения вашего монитора на высоту (например, 3440/1440).
  2. Преобразуйте результат в шестнадцатеричный формат.
  3. Измените значение на 0x######## заменив ######## шестнадцатеричным значением.

Примечание об исправлениях частоты кадров

Частота кадров выше 60 кадров в секунду требует изменения значения vsync с true на false в конфигурации Xenia Canary.

---

Настройка Cheat Engine

• Точки останова в памяти можно установить в Cheat Engine или MSVC с помощью emit_source_annotations = true . Это даст аннотации при разборке.
• Cheat Engine 7.2+ включает типы Big Endian, но их необходимо включить;
  • Нажмите Edit > Options > Extra Custom Types и отметьте все из них.
• Перейдите в Scan Settings и включите MEM_MAPPED .
• Измените «Параметры сканирования памяти» на:

  	Все
  Начинать	100000000
  Останавливаться	200000000

  • Это может измениться в зависимости от запущенных вами программ.
• Как только вы найдете значение, вы можете подключить отладчик Cheat Engine, чтобы увидеть, что читает/пишет по этому адресу.
  Это покажет адрес xex при достижении точки останова, хотя в настоящее время нет способа установить точку останова при выполнении в отладчике Xenia.

Создание патча

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

• Чит-движок
  • См. настройку Cheat Engine.
• Гидра
  • XEX-погрузчик
• ИДА Про
  • Загрузчик IDA 7 XEX
  • Загрузчик IDA 6 XEX
• Текстовые редакторы:
  • Код Visual Studio
  • VSCodium
  • Блокнот++
• Рекомендуется, но необязательно:
  • Плагин ESLint TOML
    • См. Интеграцию редактора
  • Расширения Visual Studio Code/VSCodium:
    • Еще лучше ТОМЛ
  • Чтобы упростить задачу, поместите Xenia Canary в каталог, содержащий /patches и запустите его с помощью portable.txt .

Рекомендации

• Патч должен называться Title ID - Game Title.patch.toml и находиться в каталоге /patches .
  Например, файл патча для Blue Dragon должен называться 4D5307DF - Blue Dragon.patch.toml .
• Если вы делаете патч для игры, у которой уже есть файл, то добавьте в него*
  • Единственным исключением является ситуация, когда вы исправляете другой модуль.
• Отправка патчей:
  • Никаких пробелов.
  • Шестнадцатеричный регистр адреса/значения в нижнем регистре, идентификатор заголовка/хеш/идентификатор носителя в верхнем регистре.

Как получить хеш модуля и имя файла:

0. Не меняйте хеш существующих патчей. Если у вас другая версия игры, то патч(и) необходимо перенести на эту версию.
1. Установите log_level как минимум 2 (по умолчанию) в конфигурации Xenia Canary; См. раздел «Как использовать определение местоположения».
2. Запустите игру хотя бы один раз.
3. Закрыть Ксению Канарейку.
4. Получить хеш модуля/идентификатор заголовка/имя заголовка;
   • Найдите Ctrl+F для Module hash: в xenia.log
     Вы должны увидеть что-то вроде:

      i> ######## Module DeviceCdrom0default.xex:
     Module Hash: ################
     

   • Патчи могут иметь несколько исполняемых файлов/хешей. Оставляйте без комментариев только те хеши, которые вы используете:

     game-patches/patches/454108D8 - Army of Two The 40th Day.patch.toml

     Строки с 3 по 6 в 95f5180

     	хеш = [
     	" 7C5F016EA6A81E95 " # default.xex
     	# "2330F2A205951B81" # AO3MPGame-XeReleaseLTCG.xex
     	]

Типы патчей

[[patch.*]]	Информация	Значение (пример)
be8	Шестнадцатеричный, 1 байт	0x00
be16	Шестнадцатеричный, 2 байта	0x0000
be32	Шестнадцатеричный, 4 байта	0x00000000
be64	Шестнадцатеричный, 8 байт	0x0000000000000000
array	Шестигранник, любой размер	"0x##*"
f32	Поплавок, одиночный	1.0
f64	Плавающий, двойной	1.0
string	Строка, UTF-8	"string"
u16string	Строка, UTF-16	"string"

Пример патча

 title_name = " Game Title "
title_id = " 1234ABCD " # AB-1234
hash = " ################ " # Module the hash applies to (i.e. default.xex)
          # Can be an array if applicable:
hash = [
  " ################ "     # See above
]
# media_id = "1234ABCD" # Optionally you can add a redump link; Disc (Region): http://redump.org/disc/1234
#                        Can also be an array if applicable:
# media_id = [
#  "1234ABCD"          # See above
# ]
# Title ID, hash, and media ID must be uppercase.

[[ patch ]]
  name = " Patch name "
  author = " Me "
  desc = " Patch description " # Description is optional
  is_enabled = false         # Must be false for PRs

# [[patch.*]]
#  For example, be8:
  [[ patch . be8 ]]
    address = 0x82000000 # Tends to start with 0x8, always 4 bytes
    value = 0x00
#  Address and value hex must be lowercase.
#   string:
  [[ patch . string ]]
    address = 0x82000000 # Tends to start with 0x8, always 4 bytes
    value = " string "
# End of file newline