game patches

Xenia Canary-Spiel-Patches

Dieses Repository enthält Spielpatches für Xenia Canary.
Die Plugin-Dokumentation finden Sie hier.

Nicht-Patch-Fragen gehören auf den Xenia Discord-Server.

Dies sind KEINE tatsächlichen Spiele oder Titel-Updates!
Lesen Sie Xenias Schnellstart, um Spiele zu erhalten.

Installieren/Aktualisieren

0. Voraussetzungen
   • Neuestes Xenia Canary-Experiment.
     • Patches werden auf Master- oder veralteten Versionen von Xenia Canary nicht unterstützt.
1. Laden Sie diese ZIP-Datei herunter.
2. Gehen Sie dorthin, wo sich xenia_canary.exe befindet.
3. Löschen Sie patches Ordner, falls vorhanden (sichern Sie ihn bei Bedarf).
4. Öffnen Sie game-patches.zip und extrahieren Sie patches im selben Verzeichnis wie xenia_canary.exe . Die Ordnerstruktur sollte wie folgt aussehen:
   

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

5. Fahren Sie mit dem folgenden Abschnitt fort.

Wie zu verwenden

0. Voraussetzungen
   • Neuestes Xenia Canary-Experiment
     • Patches werden auf Master- oder veralteten Versionen von Xenia Canary nicht unterstützt.
   • Die richtige Version des Spiels, z. B. Title Update (TU).
   • apply_patches ist in der Xenia Canary-Konfiguration auf true (Standard) gesetzt.
1. Öffnen Sie die .patch.toml-Datei, die Ihrem Spiel entspricht, in einem Texteditor (Notepad, VSCode, VSCodium, Notepad++ usw.).
2. Ändern Sie is_enabled von false in true . So aktivieren Sie beispielsweise einen 60-FPS-Patch:

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

   wird

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

Wenn in der Titelleiste [Patches Applied] angezeigt wird, wurden die Patches erfolgreich angewendet.

Ändern Sie nicht den Hash vorhandener Patches. Wenn Ihre Version des Spiels eine andere ist, müssen die Patches auf diese Version portiert werden.

Hinweise zu Seitenverhältnis-Patches

• present_letterbox muss von true auf false geändert werden!
• Seitenverhältnis-Patches erhöhen die Auflösung nicht !
• Während die meisten Seitenverhältnis-Patches 21:9 (3440/1440) sind, können sie auch in andere Seitenverhältnisse geändert werden, sofern nicht anders angegeben oder angegeben;
  1. Teilen Sie die Auflösung Ihres Monitors Breite durch Höhe (z. B. 3440/1440).
  2. Wandeln Sie das Ergebnis in Hex um.
  3. Ändern Sie den Wert in 0x######## und ersetzen Sie ######## durch den Hexadezimalwert.

Hinweis zu Framerate-Patches

Für Frameraten über 60 FPS muss vsync in der Xenia Canary-Konfiguration von „true“ auf „false“ geändert werden.

---

Cheat Engine einrichten

• Speicherhaltepunkte können in Cheat Engine oder MSVC mit emit_source_annotations = true festgelegt werden. Dadurch werden bei der Demontage Anmerkungen angezeigt.
• Cheat Engine 7.2+ enthält Big-Endian-Typen, diese müssen jedoch aktiviert sein;
  • Klicken Sie auf Edit > Options > Extra Custom Types und aktivieren Sie alle.
• Gehen Sie zu Scan Settings und aktivieren Sie MEM_MAPPED .
• Ändern Sie „Speicherscan-Optionen“ in:

  	Alle
  Start	100000000
  Stoppen	200000000

  • Dies kann sich je nach den von Ihnen ausgeführten Programmen ändern.
• Sobald Sie einen Wert gefunden haben, können Sie den Debugger von Cheat Engine anhängen, um zu sehen, was diese Adresse liest/schreibt.
  Dadurch wird eine XEX-Adresse angezeigt, wenn ein Haltepunkt erreicht wird. Derzeit gibt es jedoch keine Möglichkeit, im Xenia-Debugger einen Haltepunkt bei der Ausführung festzulegen.

Einen Patch erstellen

Voraussetzungen

• Cheat-Engine
  • Siehe Einrichten der Cheat Engine
• Ghidra
  • XEX-Loader
• IDA Pro
  • IDA 7 XEX Loader
  • IDA 6 XEX-Lader
• Texteditoren:
  • Visual Studio-Code
  • VSCodium
  • Notepad++
• Empfohlen, aber optional:
  • ESLint TOML-Plugin
    • Siehe Editor-Integrationen
  • Visual Studio Code/VSCodium-Erweiterungen:
    • Noch besseres TOML
  • Zur Vereinfachung platzieren Sie Xenia Canary in dem Verzeichnis, das /patches enthält, und führen Sie es mit portable.txt aus.

Richtlinien

• Der Patch muss Title ID - Game Title.patch.toml heißen und sich in /patches befinden.
  Beispielsweise muss eine Patch-Datei für Blue Dragon 4D5307DF - Blue Dragon.patch.toml heißen.
• Wenn Sie einen Patch für ein Spiel erstellen, für das bereits eine Datei vorhanden ist, fügen Sie diese hinzu*
  • Die einzige Ausnahme besteht, wenn Sie ein anderes Modul patchen.
• Einreichen von Patches:
  • Kein Leerzeichen.
  • Hexadezimalbuchstaben in Kleinbuchstaben für Adresse/Werthex, Großbuchstaben für Titel-ID/Hash/Medien-ID.

So erhalten Sie den Modul-Hash und den Dateinamen:

0. Ändern Sie nicht den Hash vorhandener Patches. Wenn Ihre Version des Spiels eine andere ist, müssen die Patches auf diese Version portiert werden.
1. Setzen Sie log_level in der Xenia Canary-Konfiguration auf mindestens 2 (Standard). Siehe So verwenden Sie den Standort.
2. Führen Sie das Spiel mindestens einmal aus.
3. Schließen Sie Xenia Canary.
4. Modul-Hash/Titel-ID/Titelname abrufen;
   • Suchen Sie Strg+F nach Module hash: in xenia.log
     Sie sollten etwa Folgendes sehen:

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

   • Patches können mehrere ausführbare Dateien/Hashes haben. Lassen Sie nur die Hashes, die Sie verwenden, unkommentiert:

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

     Zeilen 3 bis 6 in 95f5180

     	Hash = [
     	" 7C5F016EA6A81E95 " # default.xex
     	# "2330F2A205951B81" # AO3MPGame-XeReleaseLTCG.xex
     	]

Patch-Typen

[[patch.*]]	Info	Wert (Beispiel)
be8	Hex, 1 Byte	0x00
be16	Hex, 2 Bytes	0x0000
be32	Hex, 4 Bytes	0x00000000
be64	Hex, 8 Bytes	0x0000000000000000
array	Sechskant, jede Größe	"0x##*"
f32	Float, Single	1.0
f64	Float, doppelt	1.0
string	Zeichenfolge, UTF-8	"string"
u16string	Zeichenfolge, UTF-16	"string"

Beispiel-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