Fork 0
mirror of https://github.com/notwa/mm synced 2024-05-19 05:33:22 -07:00
majora's mask scripts, and some ocarina stuff too
Go to file
2021-01-20 23:32:45 +01:00
asm fix asm syntax errors (#1) 2018-11-28 03:51:08 +01:00
dump a dump folder for (gasp) dumps 2016-01-02 02:00:05 -08:00
img describe how to use the Lua and asm stuff 2016-10-02 20:01:44 -07:00
Lua preliminary support for OoT 0.9 2021-01-20 23:32:45 +01:00
.gitattributes fill in the blanks 2016-05-07 03:13:06 -07:00
.gitignore ignore z64crc binary 2016-11-10 17:54:36 -08:00
chksum.py specifically use python 3 2015-11-29 06:13:42 -08:00
dumptext.py bad commit messages incorporated 2018-02-06 12:22:26 +01:00
dumptext2.py update text dumping with unused name commands 2016-11-27 15:57:01 -08:00
fn M US10.txt add and correct more filenames 2020-07-27 10:13:01 +02:00
fn O US10.txt add and correct more filenames 2020-07-27 10:13:01 +02:00
fn O US12.txt add and correct more filenames 2020-07-27 10:13:01 +02:00
heuristics.py fix extraction of Doubutsu no Mori files 2018-06-16 11:47:36 +02:00
mm-bitflags.txt EOL 2016-10-24 09:06:26 -07:00
n64_fast.pyx use proper fixed width types 2016-11-27 22:15:06 -08:00
n64.py rewrite functions in pyrex for performance 2015-03-04 07:21:18 -08:00
notes.md split old notes to new file 2018-05-03 19:35:27 +02:00
README.md bump bizhawk version 2020-07-29 16:42:25 +02:00
util.py use debug ROM filenames, less verbose 2015-03-03 00:40:28 -08:00
Yaz0_fast.pyx use proper fixed width types 2016-11-27 22:15:06 -08:00
Yaz0.py rewrite functions in pyrex for performance 2015-03-04 07:21:18 -08:00
z64crc.c fix and rewrite CRC routine 2018-08-10 11:53:06 +02:00
z64dump.py Revert "incredibly insignificant code cleanup" 2020-08-04 11:58:41 +02:00
z64yaz0.c reformat C files 2018-05-03 20:45:46 +02:00
z64yaz0.new.c make yaz0 interface more portable 2019-07-09 06:09:12 -07:00

Zelda 64 Resources

i like to muck around in the memory of these games.

those who are more interested in the ROM may find the binary template repo more resourceful.

there is also a great deal of general documentation and notes on the wikis hosted at CloudModding.

Lua Scripts

this repo contains a ton of Lua scripts written for version 2.4.2 of Bizhawk. all the scripts you'll want to use are in the root Lua directory, and their dependencies are in further subdirectories. that means, if you want to use a script, you must preserve the directory structure. you cannot, say, extract one file from this repo's archive and expect it to work.

a summary of each script is available in the Lua README.md file, and another for the library files that the scripts use.

of these, you probably came for cheat menu.lua. this script will bind your L button to open an on-screen menu allowing you to control many aspects of the game.

cheat menu.lua in action

of immediate interest are the classic levitation and run-fast cheats, but also the menu of warps to any area and any entrance in the game. you can also change your Z-Targeting method to Hold in the 2nd page of the Progress menu, in case you forgot to change it in-game.

Assembly Hacks

i have written a handful of ROM and RAM hacks for Majora's Mask and Ocarina of Time. these have all been written in the custom assembler syntax of lips, a MIPS assembler written in Lua. lips is included in this repository; you do not need to acquire it separately.

you only need to run Lua/inject.lua in Bizhawk to run the RAM hacks — that is, modifications that act directly on the game's RAM while it runs; not modifying the ROM.

for the ROM hacks, you will need to set up a lot more. you will need:

  • bash 4.3 to run the shell scripts responsible for automatically running all the following software.

  • Python 3.4 to run the scripts responsible for splitting the ROM into files, and merging those files into a single ROM again.

  • LuaJIT 2.0 to run the lips assembler responsible for turning the assembly files into executable binary code. you might manage to use the Lua 5.1 interpreter, but this is not strictly supported.

  • gcc 4.9 or clang 3.6 to compile the programs responsible for (de)compressing the Yaz archive files, and for computing checksums.

the versions listed above are rough estimates, and newer versions of software are likely to work fine.

if you're on Windows, and you're not afraid of the (*nix) console, you can set up msys2 to install binaries of bash, python, and gcc. then all that's left is to compile LuaJIT yourself, or you can grab a 64-bit binary built by myself.

last, but not least, you will need the appropriate ROM for the ROM hack. you will probably need to change the hard-coded paths to the ROMs. (note to self: change scripts to take the required ROM as their first argument)

finally, you just run the appropriate shell scripts for the ROM hacks you want to produce. for example:

$ cd asm
$ ./mm-bq
00-07-31 17:04:16
uncompressed 0031 V00B3C000
ratio: 59%
compressed 0031 V00B3C000
ratio: 59%
compressed 1552 V02EE7040
ratio: 1%
bootcode: 6105
crcs: 5CF5359C A893E696


to compile the C programs, you might need to pass -std=gnu11. basically:

gcc -std=gnu11 -Wall -Ofast z64yaz0.c -o z64yaz0
gcc -std=gnu11 -Wall -Ofast z64crc.c -o z64crc

in the future, it'd be nice to only depend on LuaJIT to build ROMs.

cygwin's newline mangling will be the death of me.


some sheets have been put together to dump data in. some of them can be used to predict the result of glitches.