03-20-2018, 11:08 PM
Getting Started with Wiimm's Tools
Before you read this guide. It is recommended you read the following threads.
http://mkwii.com/showthread.php?tid=115
http://mkwii.com/showthread.php?tid=12
The threads linked above will give you a brief introduction about Wiimm's Tools, and provide you quick guides for downloading, installation, plus upgrading.
Now that you have some basic knowledge and the tools are installed, let's get to work.
Chapter 1: Introduction
It is important to understand that Wiimm designed his Tools for Linux. While he has made a cygwin-usable version (Windows), the tools were made for Linux. Therefore, this tutorial will be for Linux users only. Also, we will be utilizing the WBFS format for your USB stick instead of FAT32. Yes FAT32 is easier but it does have rare bugs and WWT from WIT Tools make WBFS more practical than what it use to be.
Chapter 2: ISO vs WBFS
We will start off with WIT from WIT Tools. The main utility for ISO/WBFS editing. I am assuming you already have an ISO/WBFS ready on your computer.
Ok, as you should know already, there are two main file types for Wii Disc image use. WBFS and ISO. ISO is the raw image file. You can't simply add it to the USB, it can only be 'mounted'. Back in the olden days, we had to use the WBFS manager to 'add' our ISO files to the USB stick. Back then the WBFS format was a mess. Anyway what I'm getting at is the ISO format is outdated. WBFS format is the modern filetype which you can add to a wide variety of formats of hard disks. If you want to throw a wbfs file on a USB stick to move it to another computer, just drag and drop it.
With everything mentioned above, if your game is in ISO format. Let's change it to the modern '.wbfs' file-type. Open up a terminal and navigate to the directory where your ISO is stored. Let's say, for demo purposes, it is the /home/user/games directory. Type in terminal - cd /home/user/games. You are now in the games directory. Now type this command in terminal:
wit copy nameofyourgame.iso nameofyourgame.wbfs
That command will make a copy of your game but save it as a wbfs file.
Chapter 3: Scrubbing
Chances are, your game still has all the partitions. Only 1 of the 3 partitions is needed (data) to play the game. It would be silly to keep the unused partitions. Wiping these partitions is known as 'scrubbing'. Run the following command in terminal:
wit copy nameofyourgame.wbfs newnameforgame.wbfs --psel data
WIT will copy your game again but the new wbfs file will only have the DATA partition.
Chapter 4: Extracting WBFS
Alright, we have our 'scrubbed' WBFS file. Most likely, you play online using the Wiimmfi server. There is a WIT command to easily patch the game for Wiimmfi, but I want you to use WSTRT from SZS Tools to do it, you will understand why later. Before we can use SZS Tools, we need to extract the game first. SZS Tools cannot do any commands on a non-extracted game.
Run this command...
wit extract newnameforgame.wbfs /home/user/newfolder
NOTE: Do NOT create the 'newfolder' directory beforehand, or an error will occur. WIT will create the newfolder for you.
Once that command is done, view the contents of 'newfolder'. You will see your wbfs in extracted format.
Chapter 5: Patching WBFS for the Wiimmfi Server
We need to navigate to where the main.dol is located to do our first patching for Wiimmfi. Type this in terminal:
cd /home/user/newfolder/files/sys
wstrt patch main.dol --wiimmfi
Main.dol is patched for Wiimmfi, but there's still one more file we need to patch. Type this in terminal:
cd /home/user/newfolder/files/rel
wstrt patch StaticR.rel --wiimmfi
Chapter 6: Rebuilding WBFS
Sweet, all patches are completely. Now it's time to rebuild our game. Type this in terminal - cd /home/user
Ok now run this command for the rebuild...
wit copy ./newfolder /home/user/wiimmfireadygame.wbfs
Once command is complete, your wiimmfi patched game is in your main user directory (/home/user). Game is now ready to be added to the USB stick.
Chapter 7: Formatting USB to use WBFS
As mentioned earlier, we will be utilizing WBFS via WWT Commands instead of FAT32. For this guide, we will start off with a USB already in FAT32 format.
Plug in your USB stick. Exit out of any file manager windows that pop up due to USB mounting. Type this in terminal:
sudo fdisk -l
Enter in your password and then a list of hard disks will appear. USB's on Linux are usually located as /dev/sdb or /dev/sdb1 (for USBs with normal partition table, aka FAT32). Sometimes it will be under sdc or sdc1. The USB stick is usually listed as the last item.
!!!IMPORTANT!!!: DOUBLE CHECK where your usb is located. We will be formatting the USB drive. If you mess up in this section of the thread, and format the wrong device, you could accidentally destroy your Hard Drive. Be smart, take your time. If you are not sure which listed device is your USB, then don't proceed.
In this guide, the USB stick is located at /dev/sdb1. Therefore the command to type in terminal would be...
sudo umount /dev/sdb1
Substitute /dev/sdb1 with the correct location for you USB. The above command will unmount the USB so it will be safe to use. Writing files to mounted USB sticks can cause errors.
Ok, run this command now (sdb1 used for USB location):
sudo wwt format /dev/sdb --test
As you can see in the above command, do NOT include the "1" on /dev/sdb.
WWT will do a test format. There should be no errors. If no errors, run the following command (replace sdb with the correct variable that applies to your USB)
sudo wwt format /dev/sdb --force
USB is now formatted to WBFS.
Chapter 8: Adding WBFS to USB Drive
Now we are finally ready to add our wiimmfi patched WBFS to the USB. Make sure you are in the /home/user directory. Type this in terminal:
cd /home/user
sudo wwt add --auto wiimmfireadygame.wbfs
Your wiimmfi patched game will now add to the USB. USB 2.0's take about 6-8 minutes. USB 3.0's take about 3-5 minutes. Once done, run this command (substitute sdb with the correct variable for your USB):
sudo wwt list /dev/sdb
Your game (via Game ID and short description) will be listed. Since USB was unmounted (via umount) command earlier, you are safe to pull USB out of computer.
Chapter 9: Conclusion
Congratz! You now have a good idea of how to use WIT, SZS, and WWT commands.