game patches

Patches do jogo Xenia Canário

Este repositório contém patches de jogos para Xenia Canary.
A documentação do plug-in pode ser encontrada aqui.

As perguntas sem patch pertencem ao servidor Xenia Discord.

Estes NÃO são jogos reais ou atualizações de títulos!
Leia o Quickstart de Xenia para obter jogos.

Instalando/Atualizando

0. Pré-requisitos
   • Último experimental de Xenia Canary.
     • Patches não são suportados em versões master ou desatualizadas do Xenia Canary.
1. Baixe este zip.
2. Vá para onde está xenia_canary.exe .
3. Exclua a pasta patches , se houver (faça backup, se necessário).
4. Abra game-patches.zip e extraia patches no mesmo diretório que xenia_canary.exe . A estrutura de pastas deve ficar assim:
   

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

5. Continue na seção abaixo.

Como usar

0. Pré-requisitos
   • Última experiência experimental de Xenia Canary
     • Patches não são suportados em versões master ou desatualizadas do Xenia Canary.
   • A versão correta do jogo, por exemplo, Atualização de Título (TU).
   • apply_patches definido como true (padrão) na configuração do Xenia Canary.
1. Abra o arquivo .patch.toml que corresponde ao seu jogo em um editor de texto (Notepad, VSCode, VSCodium, Notepad++, etc.)
2. Altere is_enabled de false para true . Por exemplo, para ativar um patch de 60 FPS:

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

   torna-se

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

Se você vir [Patches Applied] na barra de título, então os patches foram aplicados com sucesso.

Não altere o hash dos patches existentes. Se a sua versão do jogo for diferente, os patches precisam ser portados para essa versão.

Notas sobre patches de proporção de aspecto

• present_letterbox deve ser alterado de true para false !
• Os patches de proporção de aspecto não aumentam a resolução!
• Embora a maioria dos patches de proporção de aspecto sejam 21:9 (3440/1440), eles também podem ser alterados para outras proporções, a menos que não seja especificado ou especificado de outra forma;
  1. Divida a largura da resolução do seu monitor pela altura (ou seja, 3440/1440)
  2. Converta o resultado para hexadecimal.
  3. Altere o valor para 0x######## substituindo ######## pelo valor hexadecimal.

Nota sobre patches de taxa de quadros

Taxas de quadros acima de 60 FPS exigem que o vsync seja alterado de verdadeiro para falso na configuração do Xenia Canary.

---

Configurando o Cheat Engine

• Os pontos de interrupção de memória podem ser definidos no Cheat Engine ou MSVC com emit_source_annotations = true . Isso fornecerá anotações na desmontagem.
• Cheat Engine 7.2+ inclui tipos Big Endian, mas eles devem estar habilitados;
  • Clique em Edit > Options > Extra Custom Types e verifique todos eles.
• Vá para Scan Settings e habilite MEM_MAPPED .
• Altere 'Opções de verificação de memória' para:

  	Todos
  Começar	100000000
  Parar	200000000

  • Isso pode mudar dependendo dos programas que você está executando.
• Depois de encontrar um valor, você pode anexar o depurador do Cheat Engine para ver o que lê/grava nesse endereço.
  Isso mostrará um endereço xex quando um ponto de interrupção for atingido, embora atualmente não haja como definir um ponto de interrupção na execução no Depurador Xenia.

Criando um patch

Pré-requisitos

• Motor de trapaça
  • Veja configurando o Cheat Engine
• Ghidra
  • Carregador XEX
• IDA Pro
  • Carregador IDA 7 XEX
  • Carregador IDA 6 XEX
• Editores de texto:
  • Código do Visual Studio
  • VSCódio
  • Bloco de notas++
• Recomendado, mas opcional:
  • Plug-in ESLint TOML
    • Consulte Integrações do Editor
  • Extensões do Visual Studio Code/VSCodium:
    • Ainda melhor TOML
  • Para facilitar as coisas, coloque Xenia Canary no diretório que contém /patches e execute-o com portable.txt .

Diretrizes

• O patch deve ser nomeado Title ID - Game Title.patch.toml e estar em /patches .
  Por exemplo, um arquivo de patch para Blue Dragon deve ser chamado 4D5307DF - Blue Dragon.patch.toml .
• Se você estiver fazendo um patch para um jogo que já possui um arquivo, adicione-o*
  • A única exceção é se você estiver corrigindo um módulo diferente.
• Envio de patches:
  • Sem espaço em branco.
  • Hexadecimal minúsculo para endereço/valor hexadecimal, maiúsculo para ID de título/hash/ID de mídia.

Como obter o hash do módulo e o nome do arquivo:

0. Não altere o hash dos patches existentes. Se a sua versão do jogo for diferente, os patches precisam ser portados para essa versão.
1. Defina log_level como pelo menos 2 (padrão) na configuração do Xenia Canary; Consulte Como usar para localização.
2. Execute o jogo pelo menos uma vez.
3. Feche Xenia Canário.
4. Obtenha o hash do módulo/ID do título/nome do título;
   • Pesquise Ctrl + F por Module hash: em xenia.log
     Você deverá ver algo como:

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

   • Os patches podem ter vários executáveis/hashes. Deixe apenas o(s) hash(s) que você está usando sem comentar:

     game-patches/patches/454108D8 - Exército de Dois O 40º Dia.patch.toml

     Linhas 3 a 6 em 95f5180

     	hash = [
     	" 7C5F016EA6A81E95 " # padrão.xex
     	# "2330F2A205951B81" # AO3MPGame-XeReleaseLTCG.xex
     	]

Tipos de patches

[[patch.*]]	Informações	Valor (exemplo)
be8	Hexadecimal, 1 byte	0x00
be16	Hexadecimal, 2 bytes	0x0000
be32	Hexadecimal, 4 bytes	0x00000000
be64	Hexadecimal, 8 bytes	0x0000000000000000
array	Hexadecimal, qualquer tamanho	"0x##*"
f32	Flutuador, solteiro	1.0
f64	Flutuar, duplo	1.0
string	Cadeia de caracteres, UTF-8	"string"
u16string	Cadeia de caracteres, UTF-16	"string"

Exemplo de patch

 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