-
Notifications
You must be signed in to change notification settings - Fork 3
Getting Started
There are a couple steps that need to be done before we can start writing code.
In order to run code from this tutorial it is necessary to have WiiMake installed. This program compiles, allocates, links, and injects C source code into an .iso file. The README on the front page on the repository (previous link) explains how to install wiimake on your computer. How to set up a config file for wiimake is covered in this tutorial.
note: wiimake v1.3.4 is required for this tutorial
First, you should acquire a Super Smash Bros. Melee (v1.02) iso. The PAL version of the game will eventually be supported, but for now NTSC 1.02 is the required version of the game. We are going to be heavily modifying this .iso file so it is useful to create a backup of the vanilla version of the game. WiiMake provides a tool for doing exactly this. Run the following command to create the backup.
wiimake-isotool [MELEE.ISO] --save vanilla_melee.data
and replace [MELEE.ISO] with the path to your iso file. Whenever you want to restore your iso to its vanilla state, simply run:
wiimake-isotool [MELEE.ISO] --load vanilla_melee.data
For reference, the checksum value of SSBM v1.02 is d5b82501ab04cee0. You can check this value with:
wiimake-isotool [MELEE.ISO] --checksum
If you ever encounter run time errors with your code, the first thing to try is to restore the .iso to its vanilla state and re-run wiimake.
All of the libmml releases are on the release page. This tutorial is written for v1.0.0. Please refer to the FAQ to see which versions of the library are compatible with this tutorial.
Download either the .tar.gz or .zip file and unpack. The release contains all the tutorial code, but you may wish to re-write it yourself.
Now that you have all the necessary pieces, it's time to write your first program.