README 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. It is required to use Python 3.8
  2. Python modules required:
  3. - lxml (to read XMLs)
  4. - PyQt5 (GeckoLoader)
  5. - chardet (GeckoLoader)
  6. - bs4 (GeckoLoader)
  7. Usage:
  8. Windows:
  9. py -3.8 main.py "path/to/iso/wbfs/file" "path/to/riiv/xml" "path/to/mod/files/folder"
  10. Linux:
  11. python3.8 main.py "path/to/iso/wbfs/file" "path/to/riiv/xml" "path/to/mod/files/folder"
  12. For games that have "original" memory patches conditions you have to download a ram dump of your game (region specific) and put it in the "ram_dumps" folder.
  13. This riivolution patcher is supposed to work with SMG1/2 mods but it might work with other games. The only thing is that "ocarina", "offset", and similar condition patches are not supported and custom savefiles will need to be manually handled (will depend on the mod, you may use SaveGame Manager GX for that).
  14. For SMG1/2 here is a link of the ram dumps I could find:
  15. https://archive.org/download/SMG_1-2_All-Regions
  16. Name them exactly as the game id of your game.
  17. Examples:
  18. - SMG1 USA --> Game ID: RMGE01 --> Ram dump name: RMGE01.bin
  19. - SMG2 EUR --> Game ID: SB4P01 --> Ram dump name: SB4P01.bin
  20. After the end of the patching process, a "result.wbfs" file will be created with the mod applied to it. You can test the file with the USB Loader of your choice >:] (hope it works lol)
  21. This tool will enforce that the Riivolution XML is correct before applying a mod. So if a XML file isn't formatted right in the slightest the tool will complain about it (i.e. it will be usual that the tool won't accept an XML lol). If you have trouble finding out which is the XML issue (if you have any), open an issue and let me know.
  22. TODO:
  23. - see if I can implement the other weird riivolution features.
  24. Thanks to:
  25. - Wiimm for his epik WIT tool
  26. - JoshuaMKW for his GeckoLoader tool
  27. Without those tools this tool would not be possible at all