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

Discussion in 'Wii - Hacking' started by Wiimm, Dec 17, 2010.

Dec 17, 2010
  1. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    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:
    Warning: Spoilers inside!
     
    TeamScriptKiddies likes this.


  2. markehmus

    Member markehmus GBAtemp Advanced Fan

    Joined:
    Jul 26, 2008
    Messages:
    894
    Location:
    in the GAME
    Country:
    Canada
    pretty kool , and thanks for the custom mario kart as well as all these nice tools you make.
     
  3. FGOD

    Member FGOD Wii gaming bitch

    Joined:
    Jun 1, 2008
    Messages:
    1,339
    Location:
    Netherlands, Den Helder
    Country:
    Netherlands
    so this can be used to convert iso's from ntsc to pal?

    and does it need to be run under command promt in windows?

    will there be a gui one day? or a more user friendly edition?
     
  4. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    yes, no, don't know, impossible.
    I think you have not understood the goal of this tool set.
     
  5. WiiUBricker

    Member WiiUBricker Insert Custom Title

    Joined:
    Sep 19, 2009
    Messages:
    5,827
    Location:
    Espresso
    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)

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

    Member FGOD Wii gaming bitch

    Joined:
    Jun 1, 2008
    Messages:
    1,339
    Location:
    Netherlands, Den Helder
    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 [​IMG]
     
  7. giantpune

    Member giantpune GBAtemp Addict

    Joined:
    Apr 10, 2009
    Messages:
    2,860
    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.
     
  8. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    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.
     
  9. JonthanD

    Member JonthanD GBAtemp Regular

    Joined:
    Jul 9, 2010
    Messages:
    279
    Location:
    Sitting
    Country:
    United States
    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.
     
  10. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    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.
     
  11. FGOD

    Member FGOD Wii gaming bitch

    Joined:
    Jun 1, 2008
    Messages:
    1,339
    Location:
    Netherlands, Den Helder
    Country:
    Netherlands
    all games i tried with this one couldn't be converted [​IMG] but i have a tool now which seems to be working better [​IMG] got it at dark umbra. but thanks anyway [​IMG]
     
  12. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
  13. iNuKe

    Newcomer iNuKe Member

    Joined:
    Jan 2, 2011
    Messages:
    42
    Location:
    USDA ORGANIC VILLE
    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.
     
  14. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    [*] 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.
     
  15. iNuKe

    Newcomer iNuKe Member

    Joined:
    Jan 2, 2011
    Messages:
    42
    Location:
    USDA ORGANIC VILLE
    Country:
    United States
    Ok so if I wanted to do this with a legal CD-ROM I'd have to rip its content first?
     
  16. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    I have updated the ISO-Patcher:
    * wiimms-iso-patcher-2011-07-17.zip (12 MB)
    It's now much easier to create a own MKW Distribution. (see 2 README.txt files). But not only MKW is possible. Only a few edits are needed for an adaption of other games.
     
  17. chaosdarkneo

    Member chaosdarkneo GBAtemp Advanced Fan

    Joined:
    Sep 13, 2009
    Messages:
    530
    Country:
    United States
    Maybe this is what I need to make the patch for our game! Thanks Wiimm.
     
  18. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    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).
     
  19. chaosdarkneo

    Member chaosdarkneo GBAtemp Advanced Fan

    Joined:
    Sep 13, 2009
    Messages:
    530
    Country:
    United States
    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.
     
  20. Wiimm
    OP

    Member Wiimm Developer

    Joined:
    Aug 11, 2009
    Messages:
    2,051
    Location:
    Germany
    Country:
    Germany
    The zip should look like "patch-dir/files/...". See the content of the example patch-dir.zip

    The Win(7) notepad does not work, because it can't handle unix text files.
    Try http://notepad-plus-plus.org/
     

Share This Page