Thread Rating:
  • 0 Vote(s) - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Getting Started with Wiimm's Tools
#1
Getting Started with Wiimm's Tools

Before you read this guide. It is recommended you read the following threads.
http://mkwii.org/showthread.php?tid=115
http://mkwii.org/showthread.php?tid=11
http://mkwii.org/showthread.php?tid=12

The above threads will give you an intro on the Tools, provide downlinks to the Tools, and help you install them.

Now that you have some basic knowledge and the tools are installed, let's get to work.

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.

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. Now delete your ISO file, never use ISO files again. 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. This will save some space. If you want, you can deleted the unscrubbed original 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 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: It is important you 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. 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

Run this command: 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

Run this command: wstrt patch StaticR.rel --wiimmfi

Remember I said we needed to use SZS tools instead of WIT? Well this next command cannot be done on WIT Tools, it's to remove Nintendo's VR Matchmaking Algorithm. This will make finding WW's easier. Run this command now: wstrt patch StaticR.rel --all-ranks

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: wstrt ./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. As mentioned earlier, we will be utilizing WBFS via WWT Commands instead of FAT32.

In 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,sdc1. The USB stick is listed as the last item. DOUBLE CHECK where your usb is located.

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 sometimes 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, we did  NOT include the "1" on /dev/sdb. So let's say your USB was on /dev/sdc, your command would be: sudo wwt format /dev/sdc --test.

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 applys to your USB)

sudo wwt format /dev/sdb --force

USB is now formatted to WBFS. 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. Now run the following command:

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. 

Congratz! You now have a good idea of how to use WIT, SZS, and WWT commands.
Reply


Forum Jump:


Users browsing this thread: 1 Guest(s)