Difference between revisions of "WBZ Converter"

From Custom Mario Kart
Jump to navigation Jump to search
Line 9: Line 9:
 
The toolset is script (batch file) based and runs under Linux, Mac and Windows.
 
The toolset is script (batch file) based and runs under Linux, Mac and Windows.
 
It needs no installation, but only a single setup to create the needed patch library.
 
It needs no installation, but only a single setup to create the needed patch library.
The toolset s portable. You can copy and move the directory to any places, this includes an USB stick. Moving from one operating system to an other is also possible.
+
The toolset is portable. You can copy and move the directory to any places, this includes an USB stick. Moving from one operating system to an other is also possible.
  
 
== Setup ==
 
== Setup ==

Revision as of 12:21, 14 April 2013

WBZ-Converter is a toolset by Wiimm to simplify the conversions between WBZ files and SZS files.



System Requirements

The toolset is script (batch file) based and runs under Linux, Mac and Windows. It needs no installation, but only a single setup to create the needed patch library. The toolset is portable. You can copy and move the directory to any places, this includes an USB stick. Moving from one operating system to an other is also possible.

Setup

Linux and Mac user shall execute the following command once: chmod a+x *.sh

For the very first time, a auto-add library must be created. It contains files needed for the SZS patching. The files are extracted from an image copy of any original Mario Kart Wii DVD. All SZS files of the DVD directory ./Race/Course/ are needed.

The user has 2 choices:

Use an image
Copy an image of an original Mario Kart Wii DVD to the subdirectory ./original-image/'. ISO, CISO, WBFS, WDF and WIA files are supported.
Use SZS files
Copy all SZS files of './Race/Course/' to the subdirectory ./original-race-course.

If you have done one of above, call create-patch-library.bat for Windows or create-patch-library.sh for all other systems.

Read the output for diagnostics.


General Usage

After setup you can use the scripts to convert WBZ file to SZS files or SZS files to WBZ files. Read the console logging output for diagnostics.

convert-WBZ-to-SZS

Place your WBZ files into the subdirectory ./WBZ-to-SZS/ and call (or click) convert-WBZ-to-SZS.bat for Windows or convert-WBZ-to-SZS.sh for all other systems. The script will convert all *.WBZ files to SZS and overwrites already existing SZS in './WBZ-to-SZS/'.

Remove unneeded files after conversion.

convert-SZS-to-WBZ

Place your SZS files into the subdirectory ./SZS-to-WBZ/ and call (or click) convert-SZS-to-WBZ.bat for Windows or convert-SZS-to-WBZ.sh for all other systems. The script will convert all *.SZS files to WBZ and overwrites already existing WBZ in './SZS-to-WBZ/'.

Remove unneeded files after conversion.

Directories

bin

Place of tools. Don't touch it.

original-image

This directory is only needed during setup. Original images are searched here. It can be deleted after setup.

original-race-course

This directory is only needed during setup. The original track files are stored here. It can be deleted after setup.

auto-add

This is the patch library. It is created by the setup and needed for the conversion. Don't touch it.

WBZ-to-SZS

This directory is used for the conversion from WBZ to SZS. Place your WBZ files here and remove unneeded files after conversion.

SZS-to-WBZ

This directory is used for the conversion from SZS to WBZ. Place your SZS files here and remove unneeded files after conversion.

Download and Discussion