Code Updater for Nintendo Switch: Update ASM codes by yourself (v1.0.2 meet new code types!)

[admin]

Thank you all for the great advice and feedback!

Unlocks your ability of updating ASM codes for Nintendo Switch!
Refer here for more detailed descriptions.

Version >= 1.0

• Faster code feature localization algorithm
• Support master/normal code cross branches
• Support 'adr' branches
• Support codes in .rodata
• Customizable code type recognization
• Detailed logs if error occurs
• Force ARM64: Force the tool to disassemble codes as ARM64.

Version >= 0.5

• Getting tired with extracting main.nso file? Now Interactive ASM Cheats Updater ver 0.5 comes with an automated extraction! Any XCZ/XCI/NSP/NSZ game packages is supported. But please be aware, the super game package (e.g. any game bundle contains all base/updates/DLCs) is not always a good choice.
• Support ARM-32 cheat codes with automatic recognition.
• Better feature extraction that precisely locates the new address.

Notice (Version >= 0.5):

• PLEASE dump your own keys.txt (prod.keys) file and copy it to the root directory of this tool before use.
• keys.txt format remains the same with NSCB, hactool, etc.

Version >= 1.0

Version >= 0.3

Version < 0.3

* Please note that credits should be given to the originally cheat creator. Nothing can be done without their great efforts.

Functions

Now supports:

• Migrate codes to games from different distribution areas
• Upgrade or degrade codes for all available game versions
• XCZ/XCI/NSP/NSZ game packages auto extraction
• ARM64/ARM32 codes update with automatic sorting
• Recognize branch codes and modify their pointer
• Support master/normal code cross branches
• Update multiple code cave codes with precisely structures
• Support codes in .rodata
• Customizable code type recognization
• Save modified .txt or .NSO file as you like
• Detailed logs if error occurs

Downloads

Thanks to advice from linuxares. Now you can download it from:

• Download Center of GBAtemp (stable version 0.1.0 or active version 0.2.0 with better automation);

• Github releases page or download the latest version (source code released).

Quick Start Guide

Pre-Requisites

• Windows 10 (), Windows 7 ( > 0.2.0_fix), Mac/Linux (: rebuild required (thx to Amuyea))

Dump main file from xci/nsp/nsz game/updates (optional if ver >= 0.5)

There are lots of excellent works for you to dump the main file, like hactool, NSC_Builder, DBI or NXDumpTool. Please choose anyone you familiar with to dump two main files:

• Old Main File: dump from the game which old cheat runs on
• New main File: dump from the game which you want to update the old cheat to

Load main file and copy cheat codes (load game packages directly if ver >= 0.5)

Build ID of the old main file will be shown after loading. Please make sure it is the same with the old cheat.
* Please unpack game packages and load main files manually if automatic dumping process failed to work.

Interactively updating the cheat codes (or press "Generate" until done)

Logs window has everything you need when updating cheat codes.

• Generate: Generate one code or title
• Skip: Skip one code or title, especially for pointer cheats.
• Undo: Undo the last operation.
• Restart: Restart the whole process.
• Wing Length: Decide how many asm code lines are extracted as code features before and after the target address. Supported input type like array [left_side, right_side] and integer "single_input" are listed below:

• Regenerate: Useful when logs window show "address not found". Please change wing length and regenerate until single hit, or maybe double.
• Debug: Generate a debug folder with procedure files to show you what happend during the whole progress.

Save cheat codes with "SaveCHT" button

Trouble Shooting

1. Why my new codes doesn't work?
   A: On most cases, they are pointer cheat codes that can be recognized from the logs window. Please update these cheats with EdiZon SE and SE tools.
2. Why my new codes break the game?
   A: Game developer will make a huge change for some specific version of games, like adding new function or improving code efficiency. In these cases, the ASM cheat codes need to be refind.
3. Why this application repeating same title over and over again?
   A: It happened when capstone in the application failed to recognize bytes features. Here are some major reasons: zero gap in bytes file fail to work in capstone (fixed), nsnsotool decompressing command failed (fixed), application folder structure destroyed, cheat codes BID different from old main file. Please re-download this application or create an issue. Please note that "out of .text or code cave border" has been fixed from 0.4.0.
4. What does "wing length" stand for?
   A: "wing length" represents the number of code lines before and after the target area. Here is the diagram for a better view:
   
5. What code cave remake brings between version 0.3 and 0.4?
   A: In the new version, the code cave structure strictly follows the one from the original cheat code instead of previous "relocate every code cave automatically". Therefore, code caves in cheat codes like [EXP 2X]/[EXP 4X]/[EXP 8X] will only demand identical addresses and nothing more.
6. I have fully run the program and never see any warning, but still no luck. Why?
   A: In most cases, the "master code" which has a title within "{}" takes the responsibility. Some code creater prefer use them as "default function that should run with the game start". These codes and some non "master code" titled like "recovery code" always have links with other ASM codes like "BL #0xADDR". Please add these code contents to other parts of the cheat codes that don't work properly and run the program again.

Credits

Interactive ASM Cheats Updater is based on
a.) Keystone Engine and Capstone Engine: Without their brilliant work, Interactive ASM Cheats Updater will never be born.
b.) nsnsotool: This tiny program helps a lot on transforming nso files, made by 0CBH0.
c.) nsz: Light my day, created by nicoboss.
d.) getMain: main file extraction for IDA Pro by Eiffel2018.
e.) python AES128 implementation: written by SciresM.


Also thanks to:
Eiffel2018, donghui2199, 怪盗B, Geminize, Konia1234 , and lulu for their testing.
All cheat makers that sparing no effort in writing and updating cheat codes, you ARE the true heros!
All the helpers for bringing this application to life!