Homebrew [RELEASE] FriishProduce - multiplatform WAD injector

[admin]

​

Today I am rising out of the dead to announce a new project I've been working on for about a month now: introducing FriishProduce.

What is this?

FriishProduce is an automated WAD injector which allows for ROM/SWF replacement and customization in certain Wii VC channels. What's unique about it compared to other injectors? By handling many steps directly from the program's code, it bypasses several third-party assets & apps which may otherwise be required in Wii VC injection (such as Wii Common Key, and most of HowardC's tools). Some examples:

• Automatic WAD/U8 handling using libWiiSharp or Wii.cs
• VC ROM injection through hex writing and/or file replacement - bye-bye AutoInjectuwad
• Automatic banner/icon editing using VCBrlyt
• Generates custom savedata image using original WAD's source TPL/WTE(s) - good riddance VCIconGen
• Automatically edits savedata title using hex or .txt writing - Sayonara VCSaveInject
• Additional content/emulator options for each platform where supported
• Replace WAD contents with forwarder to auto-load specific emulator core and ROM

This was actually based off of an earlier project that I worked on back in 2020, until it was left abandoned and eventually wiped after my hard drive failed. I started work on a preliminary revision of FriishProduce for around three weeks before my then-seven-month-old drive also ended up failing, after which I coded the current version in about a week or so.

Platforms/Features How-to Credits

• 
  Currently supported as of the latest release:
  
  • Nintendo Entertainment System (NES) / Famicom
  • Super Nintendo Entertainment System (SNES) / Super Famicom
  • Nintendo 64
  • Sega Master System
  • Sega Mega Drive/Genesis
  • NEC PC Engine/TurboGrafx-16
  • SNK NEO-GEO AES
  • Microsoft MSX/MSX2 (Japan only)
  • Shockwave/Adobe Flash
  • Sony PlayStation (forwarder; experimental)
  Emulator forwarders:
  
  • FCE Ultra GX (dborth et al.)
  • FCE Ultra RX (NiuuS et al.)
  • FCEUX TX / FCEUGX-1UP (Tanooki16)
  • Snes9x GX (dborth et al.)
  • Snes9x RX (NiuuS et al.)
  • Snes9x TX / Snes9xGX-Mushroom (Tanooki16)
  • Wii64 1.3 MOD forked by saulfabreg (original author: Wii64 Team)
  • Not64 (Extrems)
  • Mupen64GC-FIX94 (Wii64 Team, forked by FIX94)
  • Genesis Plus GX (eke-eke et al.)
  • WiiSX (Wii64 Team)
  • WiiStation / WiiSXRX_2022 (xjsxjs197, forked from NiuuS' WiiSX RX)
  Spoiler: Additional content options

  • NES/Famicom:
    • Set custom palette
  • Nintendo 64:
    • Clear all preinstalled VC textures (*.T64)
    • Fix brightness (remove dark/epilepsy filter)
    • 8 MB extended memory (Expansion Pak detection)
    • Auto-allocation of ROM size (supports up to 56 MB; not available in later revisions)
    • Fix crashes (not available in later revisions)
  • Master System & Mega Drive/Genesis:
    • Emulator configuration editor
    • Controller mapping
  • PC Engine/TurboGrafx-16:
    • Emulator configuration editor
  • NEO-GEO:
    • Custom BIOS (*.zip/*.rom)
  • Shockwave/Adobe Flash:
    • Enable "Unsaved data" message in HOME Menu
    • Change SWF update rate (FPS?)
    • Enable save data; change total savedata size in KB
    • Strap reminder setting
    • Controller mapping to keyboard values
  • Forwarders:
    • Use Comex or Waninkoko NAND loader/WAD contents order
    • Use v12 or v14 forwarder.dol
    • Use vWii (Wii U) NAND loader
    • Load from USB instead of SD card
    • Show BIOS startup screen (PSX only)
• 
  See the Wiki for a more detailed explanation on setup & usage. TL;DR:
  
  1. Select a target platform, then browse for a ROM, and select a base WAD.
     • Optionally, you can also browse for a *.bps/*.ips to be patched to the ROM before injection.
  2. (Optional) Toggle the "Customize" checkbox, then fill in the relevant fields with the game's title, a shortened version thereof if needed, its release year and the number of players.
     • An image of the title screen is also recommended, but may not be needed if you are injecting a non-cosmetic ROM hack (e.g. a randomizer, TAS hack, etc.). Left click on the image field to browse for a new file, and right/middle click to remove it.
  3. Enter a title ID and change any content options to your liking.
  4. Save the WAD and you're done!
  
  Make sure you have a (v)Wii NAND backup in case anything goes wrong!
  
• 
  This program uses the following third-party components and apps:
  
  • libWiiSharp (orig. author: Leathl), forked by WiiDatabase.
  • Wii.cs library (part of Leathl's ShowMiiWads).
  • Floating IPS (Flips) by Alcaro.
  • ccf-tools (orig. author: paulguy) and BrawlLib (orig. author: soopercool101), both forked by libertyernie.
  • ROMC compressor by Jurai, with additional LZSS code by Haruhiko Okumura.
  • gbalzss by Andre Perrot, with additional LZSS code by Haruhiko Okumura.
  • WWCXTool by alpha-0.
  • lzh8_cmpdec by hcs.
  • HowardC's Tools (particularly, VCbrlyt).
  • For homebrew emulators compatiblity:
    • comex's NAND loader. (file renamed as "nandloader_wii_comex.app")
    • Waninkoko's NAND loader, retrieved from ShowMiiWads repo. (file renamed as "nandloader_wii.app")
    • FIX94's tiny-vwii-nand-loader. (file renamed as "nandloader_vwii.app")
    • Forwarder DOL generated from ModMii Classic (application author: XFlak) (file renamed as "forwarder.dol")
  I would also like to thank the following people:
  
  • SuperrSonic for reverse-engineering much of Wii software and official emulator code, and in particular, his fork of RetroArch Wii.
  • SaulFabre for archiving several tools and aiding in research & documentation.
  • sr_corsario for his work in disclosing NEO-GEO ROM injection methods.
  • Larsenv for his astounding work in the Wii homebrew community, and for originally disclosing a method for Flash WAD injection (GBAtemp thread).
  • And of course, the team at the 0RANGECHiCKEN release group, including lolsjoel, and the late G0dLiKe, without whose work this project would not have been possible.
  This application is distributed and licensed under the GNU General Public License v3.0.
  

Download

Releases/Changelog (Github)
Source code (GitHub)

Please note that this project is still in early beta stage and certain features may be subject to change or removal.