Hacking Wii(mms) ISO Patcher for Windows, Linux and Mac

Wiimm

Developer
OP
Member
Joined
Aug 11, 2009
Messages
2,291
Trophies
1
Location
Germany
Website
wiimmfi.de
XP
1,465
Country
Germany
Wii(mms) ISO Patcher for Windows, Linux and Mac
This is an offer for developers who want to distribute patches for original wii discs.

You (the developer) have patched a orginal game to change textures or gameplay and you want to distribute it. One way is to use Riivolution. An other way is this toolset. It enables all end users to built a new ISO image which includes your patch.

Features of the patching tool set:[*] The core of the patching system is hidden in the subdirectory bin.
.
[*] The host system (Windows, Linux/32, Linux/64, Mac) of the end user is detected automatically.
.
[*] The patching system uses unix tools and wit. For Linux and Mac the used unix tools are standard. For windows the subdirectory ./bin/cygwin contains all needed tools. Other unix systems are supported too if they have self compiled wit tools.
.
[*] There is no need that developers or end users install anything (this includes wit)!
.
[*] The developer must create one or more patch files. These patch files can be ZIP or TAR files. TAR files has the advantage of hardlink support that may reduce the download size. It is important, that the archive follow the directory structure of the image and that the base directory is: ./patch-dir/files/
.
[*] If the patch file contains the bash script ./patch-dir/post-patch.sh/ the script is executed with ./patch-dir/ as working directory after extracting the patch file. This Script must be a bash script without shebang to avoid cygwin problems and to support all host systems. It can modify any files before composing starts.
.
[*] The bash script job-helper.sh controls the conversion. (see below).
.
[*] There are additional scripts (batch files) for Windows and Unix users. These scripts allow a 1-Click-Conversion. The different scripts have different option setups (see next points) and can be edited.
.
[*] The user can use different options to controll the conversion. For example he can define the output file format (--iso, --ciso, --wdf, --wia, --wbfs, --split).
.
[*] Before converting the user must copy the original ISO image into the base directory. Alternatively he can use the option --extract to force direct extraction from a WBFS partition (admin rights needed).
.
[*] After the conversion the new images are stored in the subdirectory ./new-image. Alternatively the use can use the option --add to force direct creation to a WBFS partition (admin rights needed).
.
[*] With the selection of a conversions cript the user decides the destination file format (ISO or WBFS or WDF).
[*] In my example the new Mario Kart shares by default the savegame (the profiles) with the original games when calling a 'shared-savegame' script. But if calling a 'new-savegame' script the ID of boot.bin, ticket and tmd is changes so that the game uses a new savegame.
.
[*] For end user problems the tool set contains the diagnostic scripts 'view-iso.*' and 'verify-iso.*'. Both are availabe as Windows batch files (*.bat) and as bash scripts (*.sh). view-iso.* lists all detected ISO images in the current directory. verify-iso.* verifies the checksum of all detected ISO images (this takes time).
The core script named job-helper.sh must be edited by the developer. Here is an example:
CODE#!/bin/bash

#----- setup

. ./bin/options.sh
workdir=./patch-dir

#----- patching jobs (developers: edit this part)

# job source_id dest_id "title" patch_file
job RMCP01 RMCPT1 "Wiimms Mario Kart Test.pal"ÂÂpatch.zip
job RMCE01 RMCET1 "Wiimms Mario Kart Test.ntsc" patch.zip

#----- termination status

printlog ">>>>>ÂÂ$done_count image(s) createdÂÂÂÂ$done_count Image(s) erstelltÂÂ
 
  • Like
Reactions: TeamScriptKiddies

WiiUBricker

News Police
Banned
Joined
Sep 19, 2009
Messages
7,828
Trophies
0
Location
Espresso
XP
7,437
Country
Argentina
For the ones that dont understand what this tool is for, I'll make it easy to understand.

Imagine you have a Game X and want to modify it. You have first to build your patch files (like the Mario Kart example provided in the package above).

Once you have your patch files built and your game iso dumped, you have to run Wiimms ISO patcher. This will create another ISO with the patches enabled on the game.

Game X + patch files + ISO patcher -----> Game X (patched)

QUOTE said:
A "riivolution to patch-dir" converter.

That sounds really interesting. Keep up the good work :)
 

FGOD

Wii gaming bitch
Member
Joined
Jun 1, 2008
Messages
1,384
Trophies
1
Age
39
Location
Netherlands, Den Helder
Website
www.familievermeylen.nl
XP
451
Country
Netherlands
yeah i understood that, but i'm looking for a good app to convert from ntsc to pal... and the ones i tried didn't work... so if this would do the trick i would love to know how
tongue.gif
 

giantpune

Well-Known Member
Member
Joined
Apr 10, 2009
Messages
2,860
Trophies
0
XP
213
Country
United States
what exactly do you mean "convert NTCS to PAL"? you could mean "change the game ID" or you could mean "patch the video modes in the dol". your question is too ambiguous for anybody to answer it.
 

Wiimm

Developer
OP
Member
Joined
Aug 11, 2009
Messages
2,291
Trophies
1
Location
Germany
Website
wiimmfi.de
XP
1,465
Country
Germany
FGOD said:
yeah i understood that, but i'm looking for a good app to convert from ntsc to pal... and the ones i tried didn't work... so if this would do the trick i would love to know how
tongue.gif
It is possible if your patch file contains all needes pal files. But this makes no sense. This toolset is for developers which want to distribute patches in file level to other user. And these other users start the patching conversion by clicking one of the batch files. And this works on Windows, Linux and Mac.
 

JonthanD

Well-Known Member
Member
Joined
Jul 9, 2010
Messages
279
Trophies
0
Age
48
Location
Sitting
XP
201
Country
United States
FGOD said:
yeah i understood that, but i'm looking for a good app to convert from ntsc to pal... and the ones i tried didn't work... so if this would do the trick i would love to know how
tongue.gif

Regionfrii

http://wiki.gbatemp.net/wiki/RegionFrii

If you take a look it does exactly what you are asking for, but please note that it is not compatible with 100% of the games.

I am in the reverse situation some games I would like are in Pal only and they are not compatible with this tool.

It's not the tools fault, some games just cannot be converted.
 

Wiimm

Developer
OP
Member
Joined
Aug 11, 2009
Messages
2,291
Trophies
1
Location
Germany
Website
wiimmfi.de
XP
1,465
Country
Germany
I have updated the tool set. Logging is now english or german (auto detection). The new tool supports also a post patch script:
  • If the patch file contains the bash script ./patch-dir/post-patch.sh/ the script is executed with ./patch-dir/ as working directory after extracting the patch file. This Script must be a bash script without shebang to avoid cygwin problems and to support all host systems. It can modify any files before composing starts.
 

FGOD

Wii gaming bitch
Member
Joined
Jun 1, 2008
Messages
1,384
Trophies
1
Age
39
Location
Netherlands, Den Helder
Website
www.familievermeylen.nl
XP
451
Country
Netherlands
JonthanD said:
FGOD said:
yeah i understood that, but i'm looking for a good app to convert from ntsc to pal... and the ones i tried didn't work... so if this would do the trick i would love to know how
tongue.gif

Regionfrii

http://wiki.gbatemp.net/wiki/RegionFrii

If you take a look it does exactly what you are asking for, but please note that it is not compatible with 100% of the games.

I am in the reverse situation some games I would like are in Pal only and they are not compatible with this tool.

It's not the tools fault, some games just cannot be converted.

all games i tried with this one couldn't be converted
tongue.gif
but i have a tool now which seems to be working better
smile.gif
got it at dark umbra. but thanks anyway
smile.gif
 

iNuKe

Active Member
Newcomer
Joined
Jan 2, 2011
Messages
42
Trophies
0
Age
30
Location
USDA ORGANIC VILLE
XP
56
Country
United States
I really like this good job Wiims, But please tell me how exactly this will fix my problem, I'm kind of a noob and don't get how your application works as in an alternative to

Riivolution.
 

Wiimm

Developer
OP
Member
Joined
Aug 11, 2009
Messages
2,291
Trophies
1
Location
Germany
Website
wiimmfi.de
XP
1,465
Country
Germany
iNuKe said:
I really like this good job Wiims, But please tell me how exactly this will fix my problem, I'm kind of a noob and don't get how your application works as in an alternative to

Riivolution.
[*] Extract you image with "wit extract image patch-dir --psel data".[*] Replace the custom files in patch-dir[*] Create a new image with "wit copy patch-dir newimage.iso --newid" or "wwt add --auto patch-dir --id=newid"And this may help to distribute a patch file: http://wit.wiimm.de/r/iso-patcher
Sorry, I had thought, this was the wit theme.

If your patched ISO works fine do this:[*] Remove all orig files in patch-dir (perhaps by date) and leave only replaced files.[*] zip or tar the patch-dir[*] Get this patcher and edit "job-helper" to setup id and patch file.[*] Remove unwanted batch files (pars of *.bat and *.sh)[*] Put an image of the orig disc in the directory[*] Test the patch files[*] Remove the orig image and 'patch-dir' and dir 'new-image'[*] Pack the whole working dir an upload it.Be careful to not removing important files.
 

Wiimm

Developer
OP
Member
Joined
Aug 11, 2009
Messages
2,291
Trophies
1
Location
Germany
Website
wiimmfi.de
XP
1,465
Country
Germany
chaosdarkneo said:
Maybe this is what I need to make the patch for our game! Thanks Wiimm.
At this moment I would PN you.

Try this:
[*] Remove the subdirectories "arenas", "tracks", "bin" and "messages" from patch-dir.[*] Remove "post-patch.sh" from "patch-dir".[*] Insert your files into "patch-dir/files".[*] ZIP "patch-dir" and store "patch-dir.zip" into "iso-patcher"[*] Remove "iso-Patcher/zero-files.list"[*] Edit "create-image.sh" and set IDs and Names and the ASK_* values. Be careful to leave UNIX file format (no CR at line end).
 

chaosdarkneo

Well-Known Member
Member
Joined
Sep 13, 2009
Messages
530
Trophies
0
XP
205
Country
United States
Wiimm said:
chaosdarkneo said:
Maybe this is what I need to make the patch for our game! Thanks Wiimm.
At this moment I would PN you.

Try this:
[*] Remove the subdirectories "arenas", "tracks", "bin" and "messages" from patch-dir.[*] Remove "post-patch.sh" from "patch-dir".[*] Insert your files into "patch-dir/files".[*] ZIP "patch-dir" and store "patch-dir.zip" into "iso-patcher"[*] Remove "iso-Patcher/zero-files.list"[*] Edit "create-image.sh" and set IDs and Names and the ASK_* values. Be careful to leave UNIX file format (no CR at line end).

When it is zipped, should "patch-dir" have the files in this order?

patch-dir/patch-dir/files/etc

or

patch-dir/files/etc


I get the first as a result when zipping.


Also, what program do you recommend when editing the files? I'm using notepad, but it's a bit messy.
 

You may also like...

General chit-chat
Help Users
  • No one is chatting at the moment.
    K3N1 @ K3N1: https://youtu.be/ec_PoNcsgcY