How to create a custom Wii U forwarder for ANY vWii Homebrew + gamepad support

After many many hours of research and testing, I have finally learned how to make a forwarder for ANY vWii homebrew. Something I've realized is that a lot of people have the wrong idea of how TeconMoon's injector works when you inject homebrew which is the root of most of the confusion. The two most common problems I saw people having were just not being able to get the homebrew working themselves with an inject that way, or when it did work they were unable to update the homebrew unless they made a new inject. That's because the injector doesn't make an automatic forwarder that will just point to /sd/apps/xxx/boot.dol, it injects the specific boot.dol that you selected to be installed. This means if you were trying to make a forwarder for snes9xgx, and you selected its boot.dol for the inject, you wouldn't even need to have snes9xgx in your apps folder for it to launch from this inject because the homebrew is fully installed. The problem with creating injects with the homebrews own boot.dol is that some of them simply don't work at all, and even the ones that do will need to be manually updated with a new inject and install whenever the homebrew gets updated. But that all changes today...

1. On your PC, download and install devkitPro.

2. Once installed, download devkitPPC r29-1 and extract it. Navigate to your devkitPro folder (usually on the root of your C drive). Delete the devkitPPC folder and then drag in the one you extracted from the download.

3. Download these libogc and portlibs folders, and back inside your devkitPro folder, delete the existing libogc and portlibs folders and replace them with the ones you downloaded.

4. Download the forwarder templates and extract them to your desktop, it should give you two folders "1 Path Template" and "2 Path Template"

5. (Optional, but recommended) Download Visual Studio Code to make editing the code files in the next step easier

6. Go into the folder for the template you want to use -> source and open main.c with Visual Studio Code. Scroll down to line 50 and where it says "YOURAPP", and change that text to exactly match the name of of the app you want to forward in /sd/apps, for example if you were making a forwarder for snes9xGX the updated line would look like const char *fPath = "sd:/apps/snes9xgx/boot.dol"; if you are using the 2 Path Template, meaning you want the forwarder to look in two different possible locations for the boot.dol of the app, change the path in line 54 to what you want the secondary path to be. Once you're done updating the path in the main.c file, go to File -> Save and then you can close out of Visual Studio Code.

7. Open Msys2 (search for it in start menu if you can't find it), once opened you need to type a few commands to build your .dol for the forwarder. First, type "cd desktop" and press enter, then type "cd 1 path template" or "cd 2 path template" depending on which template you're using. Now you should just type "make" and hit enter, and it should build your boot.dol pretty fast. You can find it in the "1 Path Template" or "2 Path Template" folders, whichever one you're using.

8. Now that you have your boot.dol, you need to download and open TeconMoon's VC Injector Mod. At the top select "Wii Homebrew Injection" and for game, select the new boot.dol that you just compiled. You can customize the title, icon, banners, logo, and boot sound to your liking. If you are making a forwarder for WiiSXRX, Wii64, Nintendont or some other homebrew that benefits from c2w patches, make sure to enable them in the "Advanced" tab.

9. VERY IMPORTANT before you build the title, you're going to need to change the Title ID in the GamePad/Meta options tab. This is very important as if you have two forwarders that use the same title ID you will run into issues. Keep track of Title IDs when doing this and make sure 2 are never identical. My personal suggestion for this is changing the last number to go up by one each time. I don't know if it makes a difference but I personally suggest sticking to changing numbers only and ones that are towards the end of the title ID. Once you're sure you have a unique title ID selected, go to the "Build Title" tab and click on build.

10. Copy the new folder you just made with TeconMoon's injector to the install folder of your SD card and put it back in your Wii U. Boot up, install with WUP Installer, and enjoy your fancy new vWii homebrew forwarder from your Wii U homescreen! Anytime your homebrew updates now all you will need to do is update the boot.dol in your apps folder!

Credits:

@SaulFabre for the method of using nintendont autoboot forwarder as a base for the forwarders + the libogc and portlibs files

@TeconMoon for the lovely injector

@FIX94 for the nintendont autoboot forwarder that is used as a base

@leseratte for making it possible to still download old versions of devkitPro

The devkitPro team
 

Lostbhoy

HEY YOU GUYS!
Member
Joined
Aug 23, 2009
Messages
2,831
Trophies
3
Age
44
Location
Scotland
XP
6,099
Country
United Kingdom
  • Like
Reactions: Walwii

Walwii

Active Member
Newcomer
Joined
Jul 21, 2020
Messages
36
Trophies
0
Age
39
XP
531
Country
Brazil
Wait..... Space cadet pinball?? The old Windows one?? Is that on the wii?? Any gamepad support for wii u??

Can I ask anymore questions lol??

Edit.... I actually found the wii u port!

https://github.com/IntriguingTiles/SpaceCadetPinball-WiiU
Yup.
As I already had it on vwii, I preferred to test the forwarder and keep my records. This port turned out great.
Today I intend to make forwarder for openbor and rpgmaker.
 
  • Like
Reactions: Lostbhoy

Lostbhoy

HEY YOU GUYS!
Member
Joined
Aug 23, 2009
Messages
2,831
Trophies
3
Age
44
Location
Scotland
XP
6,099
Country
United Kingdom
Yup.
As I already had it on vwii, I preferred to test the forwarder and keep my records. This port turned out great.
Today I intend to make forwarder for openbor and rpgmaker.
I honestly had no idea it had been ported.... We used to spend hours outdoing each others scores back int' day!!

Meant to say thanks for the info!! Great find!
 
  • Love
Reactions: Walwii

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France
Can someone respond to this question? " What tool can I use to know which WII channel, a WIIU Forwarder launches?"
For example: How to know this particular wiiU forwarder launch the Wii Wad channel with Title ID: SGPG, for example!
Is there a tool that can "modify" WiiU forwarders so that it launch Ios58 instead of 35 for example or adds multiples path to the Dol it launches? (I hope I'm clear enought, sorry if not)
 

Walwii

Active Member
Newcomer
Joined
Jul 21, 2020
Messages
36
Trophies
0
Age
39
XP
531
Country
Brazil
Experience report: I created a forwarder for OpenBOR and it worked perfectly.

I created one for Easy RPG and in three attempts, the installation stops at 40%.

I tried renaming the folder from "Easy RPG" to "EasyRPG" and it worked.

Is it a bug that doesn't allow space in the folder name?
 

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France

Walwii I suppose during the creation of you Easy Rpg forwarder, maybe the path you gave to the dol was sd:\apps\EasyRPG instead of sd:\apps\Easy RPG.....There are many mistakes made like this that can happen during forwarder creation.

(Or maybe there is a sign to put when you have a space in the target directory for WiiVC Injector? Sorry, this tool is rather complicated...)
 
  • Like
Reactions: Walwii

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,467
Trophies
3
XP
29,283
Country
United States
It's not a bug. If you put a space in say a url, it gets changed to iirc %20. The space will make it think it's the end of a command.
 
  • Like
Reactions: Walwii

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France
So because he types "Easy RPG" (supposing it's not his mistake) instead of something else (you didn't tell him what exactly to type if a spacebar is needed), Walwii makes a "bad" forwarder because the forwarders creator doesn't take it in consideration?
 
  • Like
Reactions: Walwii

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,467
Trophies
3
XP
29,283
Country
United States
So because he types "Easy RPG" (supposing it's not his mistake) instead of something else (you didn't tell him what exactly to type if a spacebar is needed), Walwii makes a "bad" forwarder because the forwarders creator doesn't take it in consideration?
Wtf, man? Shouldn't that be obvious? Underscore or dash.
 

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France
Wtf, man? Shouldn't that be obvious? Underscore or dash.
Nope, I'm not in the mind of the guy that create this app....Walwii neither, so imagine the number of people that makes trying to figure out. Normally, a space is a space just like in Notepad.
 
  • Like
Reactions: Walwii

SaulFabre

I like Yoshis and the Wii/Wii U scene.
Member
Joined
Feb 6, 2019
Messages
3,308
Trophies
2
Age
25
Location
Ecuador
Website
saulfabreg-wiivc.blogspot.com
XP
8,549
Country
Ecuador
Link with devkitPPC r29-1 is dead
well, compiling the dol forwarder isn't required anymore, the compiling and source code tutorial (not for inject it) is outdated.
Just make a DOL forwarder with @XFlak's ModMii, make a WiiVC inject using this DOL and it will work fine. (thanks to @ploggy for telling me this).
 
  • Like
Reactions: tehtemp and ploggy

tehtemp

Well-Known Member
Newcomer
Joined
Apr 25, 2022
Messages
77
Trophies
0
Location
.
XP
225
Country
Canada
well, compiling the dol forwarder isn't required anymore, the compiling and source code tutorial (not for inject it) is outdated.
Just make a DOL forwarder with @XFlak's ModMii, make a WiiVC inject using this DOL and it will work fine. (thanks to @ploggy for telling me this).
Is there a tutorial for this, @SaulFabre and @ploggy ?
 
  • Like
Reactions: SaulFabre

SaulFabre

I like Yoshis and the Wii/Wii U scene.
Member
Joined
Feb 6, 2019
Messages
3,308
Trophies
2
Age
25
Location
Ecuador
Website
saulfabreg-wiivc.blogspot.com
XP
8,549
Country
Ecuador
Is there a tutorial for this, @SaulFabre and @ploggy ?
@tehtemp @Trudes

Well, the updated version of this tutorial should be:
(read the quotes)

In this part of this tutorial, we will use the ModMii Forwarder Builder function/section/tool from @XFlak’s greatest (and awesome) tool ModMii, for make the required SD/USB Forwarder DOL with meta.xml arguments support for our custom SRL and VC forwarder channel, basing in the great work in the Forwarder with meta.xml support from @FIX94.
  1. Download and install ModMii by @XFlak here in this link. (IMPORTANT NOTE: download the English version since it’s the most updated)
  2. Once installed ModMii, launch ModMii (or ModMii Classic) from the Start Menu (NOT ModMii Skin, it’s different from ModMii Classic).
  3. When the DISCLAIMER screen appears, write “I Agree” (without quotes), then press Enter. Then let check for updates (if update prompt appears, then update ModMii and let it restart again ModMii) and pass to the main menu screen.
  4. CBCvGKL.png

  5. When the main menu screen appears, type the A letter for choose "Advanced Downloads and Forwarder DOL/ISO Builder", then press Enter. The “Advanced Downloads” section appears.
  6. YDpyuoE.png

  7. When the “Advanced Downloads” menu appears, type the F letter for choose "Forwarder DOL/ISO Builder", then press Enter. The “Forwarder DOL/ISO Builder” menu appears.
  8. 3DVCcmk.png

  9. When the “Forwarder DOL/ISO Builder” menu appears, type the 1 number for choose “DOL”, then press Enter for go to the next step.
  10. oKhVdTF.png

  11. When the “Type of Forwarder” question appears, type the 1 number for choose “SD/USB Forwarder (v12)”, then press Enter. This will allow us to build the required Forwarder with meta.xml support from @FIX94.
  12. tmykKIT.png

  13. When the “Input forwarder path” question appears, type the path of the boot.dol of the SRL you want to load (apps/your_game_SRL/boot.dol), then press Enter. The max limit of characters for your path is 255 characters. Example: apps/sfg_nes_duckhunt/boot.dol
  14. WcCjQ2N.png

  15. When the desired path that you specified appears as “Path # 1”, type the A letter for choose "Add forwarder with the above paths to downloads queue", then press Enter for go to the next step.
  16. EuHatxH.png

  17. When the “Name of the forwarder” question appears, type a name for the new forwarder DOL file (without any spaces), then press Enter for add your forwarder to the Downloads Queue and return to the Main Menu. Example: FCEUXTX_DuckHunt
  18. AN IMPORTANT HINT: For avoid confusion, it is recommendable to put as name the folder you written in the path for the forwarder, for example: if path is apps/sfg_nes_duckhunt, then the forwarder DOL file should be called sfg_nes_duckhunt
  19. p2iETFE.png

  20. When the main menu screen appears again (after doing the previous steps), type the D letter for choose "Download Selected Files", then press Enter. The “Download Confirm” screen appears.
  21. 41jEgIz.png

  22. When the “Download Confirm” screen appears, type the Y letter for select "Yes, Begin Downloading", then press Enter.
  23. aFh6by6.png

  24. ModMii Forwarder Builder is making your DOL forwarder with meta.xml support, please wait for a while…
  25. zP9FlHo.png

  26. When it’s finished, the “Successful” screen appears. Type the O letter for choose "Open File Location "COPY_TO_SD"", then press Enter for open the “COPY_TO_SD” folder from ModMii.
  27. UO48gYP.png

  28. When the “ModMii/COPY_TO_SD” folder appears, open the “DOL” folder.
  29. otGQnQa.png

  30. Your DOL forwarder with meta.xml support was created, ready for inject. Now let’s go to configure the SRL for load your game. Save this DOL forwarder into the same folder where you found it, we will need it later for make the Wii/vWii and Wii U forwarder channels.
  31. 2NCoYjR.png
8. Now that you have your boot.dol, you need to download and open TeconMoon's VC Injector Mod. At the top select "Wii Homebrew Injection" and for game, select the new boot.dol that you just compiled. You can customize the title, icon, banners, logo, and boot sound to your liking. If you are making a forwarder for WiiSXRX, Wii64, Nintendont or some other homebrew that benefits from c2w patches, make sure to enable them in the "Advanced" tab.

9. VERY IMPORTANT before you build the title, you're going to need to change the Title ID in the GamePad/Meta options tab. This is very important as if you have two forwarders that use the same title ID you will run into issues. Keep track of Title IDs when doing this and make sure 2 are never identical. My personal suggestion for this is changing the last number to go up by one each time. I don't know if it makes a difference but I personally suggest sticking to changing numbers only and ones that are towards the end of the title ID. Once you're sure you have a unique title ID selected, go to the "Build Title" tab and click on build.

10. Copy the new folder you just made with TeconMoon's injector to the install folder of your SD card and put it back in your Wii U. Boot up, install with WUP Installer, and enjoy your fancy new vWii homebrew forwarder from your Wii U homescreen! Anytime your homebrew updates now all you will need to do is update the boot.dol in your apps folder!

Hope this understand ;)
 

tehtemp

Well-Known Member
Newcomer
Joined
Apr 25, 2022
Messages
77
Trophies
0
Location
.
XP
225
Country
Canada
The new tutorial by @SaulFabre and @ploggy is way easier!

Just created a forwarder for mGBA:

Code:
https://anonfiles.com/R6beF337yb/mGBA_zip

mGBA should be located at sd:/apps/mGBA/boot.dol. Inject uses the following title ID: 000500029421FFE8. So check to see if you already have an inject with the same ID before installing with WUP Installer GX.
 
Last edited by tehtemp,

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France

Return on the wiiU forwarder made by tehtemp

(interesting, it was 2MB less than the other one existing in the forum)

I'm under tiramisu with a wiiU Forwarder that launches WUP installer GX2, tried to install the mGBA wii Fowarder, it was blocking at 43% installation. So I rebooted the wiiU, supress the bad mgba files and this time, installed the mGBA wiiU Forwarder from the homebrew channel then launch Wup Installer GX2 to install TehTemp 's mGBA forwarder, tried 2 times to install that way, it works! Also, the gamepad works under these forwarders with Cross and Pad of the gamepad.

So making WiiU Forwarders that way is good, but there should be a "litltle" fix somewhere so they are installable for someone loading wup installer GX2 from the wiiU "Frontpage"....
Was wondering it is the wiiU forwarder, the WAD or the program that makes it able to use all the button of the gamepad? (and Cross and Pad?), some forwarder have one or the other that works (like the WiiSXR that hasn't go the directionnal CROSS working for the gamepad)


tehtemp could you make a VBAgx Not64 forwarder please?

 

tehtemp

Well-Known Member
Newcomer
Joined
Apr 25, 2022
Messages
77
Trophies
0
Location
.
XP
225
Country
Canada
Just did a forwarder for Visual Boy Advance GX:

Code:
https://anonfiles.com/u486Ff30ye/vbagx_zip

vbagx should be located at sd:/apps/vbagx/boot.dol. Inject uses the following title ID: 000500029421FFE9. So check to see if you already have an inject with the same ID before installing with WUP Installer GX.
 
  • Like
Reactions: ber71

mrmagicm

Well-Known Member
Member
Joined
May 27, 2018
Messages
889
Trophies
0
Age
49
XP
1,373
Country
France
I'm thinking of something.....All wiiU fowarders should be accompanied by their following "wad" wii channel counterpart, because if you use another title Id, it won't work....No? Testing you VBAGX now.
 

tehtemp

Well-Known Member
Newcomer
Joined
Apr 25, 2022
Messages
77
Trophies
0
Location
.
XP
225
Country
Canada
So making WiiU Forwarders that way is good, but there should be a "litltle" fix somewhere so they are installable for someone loading wup installer GX2 from the wiiU "Frontpage"....
If using Tiramisu, it's recommended to use the Homebrew Channel to load WUP Installer GX2 to install.

The WUP Installer GX2 "forwarder" uses a haxchi method, which can interfere with Tiramisu AFAIK.

could you make a VBAgx Not64 forwarder please?
Not64 doesn't support the Wii U Gamepad, so there's no point in creating a forwarder for that.
 
Last edited by tehtemp,

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
    realtimesave @ realtimesave: :yaysp::yaynds::yay3ds::yaywii::yayu: