https://github.com/XorTroll/mkds-re
Work-in-progress decompilation project of Mario Kart DS: documentation, ASM-hacking and other tools
https://github.com/XorTroll/mkds-re
asm-hacking decompilation ds mkds nintendo-ds reverse-engineering
Last synced: about 1 month ago
JSON representation
Work-in-progress decompilation project of Mario Kart DS: documentation, ASM-hacking and other tools
- Host: GitHub
- URL: https://github.com/XorTroll/mkds-re
- Owner: XorTroll
- License: mit
- Created: 2023-06-22T12:05:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-27T01:33:34.000Z (6 months ago)
- Last Synced: 2024-10-27T02:25:52.832Z (6 months ago)
- Topics: asm-hacking, decompilation, ds, mkds, nintendo-ds, reverse-engineering
- Language: C
- Homepage: https://xortroll.github.io/mkdsdecomp/
- Size: 2.63 MB
- Stars: 29
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred - XorTroll/mkds-re - Mario Kart DS (EU) reverse-engineering work: ASM-hacking and other tools (C)
README
# Mario Kart DS (EU) reverse-engineering
- [Mario Kart DS (EU) reverse-engineering](#mario-kart-ds-eu-reverse-engineering)
- [Save editor](#save-editor)
- [ASM-hacking](#asm-hacking)
- [Command-line utility](#command-line-utility)
- [Credits](#credits)
This repository contains my reverse-engineering work of the *European version* of **Mario Kart DS** (game code `AMCP`): ASM-hacking, better understanding of yet not fully documented DS/MKDS formats, additional tools (like a save editor) and hopefully more:
[](https://www.youtube.com/watch?v=bEItGRcRmDU)
> YouTube video showcasing an ASM-hack injection of a custom scene with custom dialogs
> Screenshots of the [online save editor](https://xortroll.github.io/mkds-re/)
## Save editor
Reversing [save-data formats and encryption/decryption](tools/common) allowed me to create an almost fully-featured [online Mario Kart DS save editor](https://xortroll.github.io/mkds-re/):
## ASM-hacking
Check out the [ASM-hacking examples](asmhack-examples) for more detailed information on how to inject custom code in MKDS, using generated [headers](re-export/include) and [symbols](re-export/mkds-eu-decomp-symbols.x) of my reverse-engineering work on this game.
## Command-line utility
For practical purposes (to make my life easier) I made a simple command-line tool, [mkdsutil](tools/mkdsutil), in order to work with several MKDS formats in a more straightforward way (better than staring into a hex editor).
It currently has the following features:
- Decrypt and/or encrypt save data
- Print info/fields of decrypted save data
You will need [CMake](https://cmake.org/) in order to compile it, without any external dependencies other than standard C++.
If you wish to make your own tools or extend these ones, you may be interested in [the C++ code](tools/common) covering various MKDS formats and utils.
## Credits
- [GBATEK](https://problemkaputt.de/gbatek.htm) for its great (although sometimes limited/outdated) DS docs
- [mkds-asm](https://github.com/rocoloco321/mkds-asm) containing some basic reference MKDS RE work
- [Existing MKDS decomp headers](https://github.com/HaroohiePals/MKDS-decomp-headers) for being a great reference for so many internal structs and types
- [Super Mario Wiki](https://www.mariowiki.com/Mario_Kart_DS) for allowing me to understand some basic gameplay aspects without having to spend hours playing or watching gameplay footage :P
- [Pokémon Diamond decompilation](https://github.com/pret/pokediamond) as a helpful reference for already (partially) understood DS SDK code
- [simontime's MKDS time trial code encoder](https://github.com/simontime/MKDSTTEncoder)
- ['Hacking Nintendo DS' EnHacklopedia page](https://doc.kodewerx.org/hacking_nds.html) as the only (and great) specifications I found regarding DS cheat codes
- [NCPatcher](https://github.com/TheGameratorT/NCPatcher) as a great tool for simplifying the process of making DS ASM hacks
- [Custom Mario Kart Wiiki](https://wiki.tockdom.com/wiki/Friend_Code) for providing me some understanding of WFC-related fields and data