Wii U Cafe SDK Deluxe, Easily install Unity Wii U Games to your Retail Wii U

Hello everyone,
Today, I introduce a tool to easily make installable images from a Unity Wii U Build for any Retail Wii U !
This tool is currently in beta, some functions are not ready yet but the big part about decrypting Unity Build and repack it is working.
This is a short tutorial about how to use this tool. You can download it from my GitHub Repo here.

Installation & Setup
To Install Wii U Cafe SDK Deluxe you just need to download it from the Release Page of the GitHub and extract it to your Unity's Build folder. Like that :

follders.png
Here we are inside my "Builds" folder of my Unity Project. The folder "Ver1" is my Unity Build with raw and dev files. You need to add the extracted folder "WiiUCafeSDKDeluxe" to the root folder of your build like in the picture. The "Versions" folder is created by Wii U Cafe Deluxe to store your Wii U Game versions. "tempMastering" is the folder who contains the mastering files (deleted after mastering done) and finaly, "copyToYourWiiUSD" contains the installable files to use with WUP Installer or System Config Tool on Retail Wii U. The two JSON files are the settings to use with the tool.

To set up the tool, you just need to run WiiUCafeSDKDeluxe.exe from the folder of the same name. You will have a message box to ask you if you want to create a new project, select "yes" and you will see this window :
create_fill.png


The "Project Name" is how your final game is named. If later, you check the option "Automatically Copy To SD", this field will be used to create the folder in your SD Card with the installable files.

You can add an icon and developers, but it just aesthetics now.

Cafe SDK Location and Unity version are required later, add them manually or locate your Cafe SDK automatically and your Unity Version from your project files.
For now only Unity.1.2p3 has been tested, other version can work, but I didn't make any tests.


Now we have finished with the installation and the setup. I will now explain the different functionalities and usage of my tool.

Usage and Functions

home-final.png
This is the home of the tool. Here you can access to all functions. You can edit the project info, basic for now. First, we need to configure 3 options in the tool. So go to settings and change java.exe and the python.exe path to make NUSPacker and Kii U Generator to works. You can now change the path of your Wii U SDK parent directory. It's the folder who contains "SDK" folder and files like "SetupEnvironment". To use Kii U Generator, open a terminal window and enter this command to install all the decencies :
Code:
pip install pycryptodome

settings.png


If you have installed App Config Tool and/or Master Editor from the NDI, restart the app, and you will be able to launch them. Now we will take a look at the versions. If you already have a build, you can use this 'Import Version' options, but you need to move first the version folder if he is located in the same parent folder as Wii U Cafe SDK Deluxe. If you don't have any version now, make a build in Unity and save it with a name, for me, I use 'Ver + version number' and place it in the parent build folder. After, use 'Create Version' Option, you will see this window :
createversion.png
Enter the SAME NAME as your Unity Build Folder Name ! And select how you have made your build. Actually, only 'Install Image' works. And create the version. You will see after selecting it in the list the size of the folder 'CopyToSDCard' who contains the normal dev files. Before making a master for the hardware, you need to go in 'Hardware Settings' and pick up your hardware.
I recommend you to dev a game to have a Wii U Deluxe Set with 32go of NAND storage. Now go in 'Master Options' :
masteroptions.png


We are now able to add our game infos. To correctly create the installation files, we need an TitleID and a TitleKey. To create them, we need an UniqueID and a Variation. Variation is not very important, but UniqueID is important, you can change the input with random things, copy the TitleID and check if the TitleID is already used with this website. If the ID is not used, click on 'Generate Title Keys' (Generated with Kii U Generator)
After, you need for CDecrypt to import the Wii U Dev Common Key located in the SDK, just click on 'Import tik_sys.bin' and the tool will try to locate the file, if it failed you can search if manually. It's here, if you want to enable the automatic copy to your Wii U's SD Card and choose the 'Install' folder (For WUP Installer) in Wii U SD. Save and close, you are ready to create your Wii U Installable files.
In the home, select the version to use (if you have multiple versions) and click on 'Make Master for my Hardware' (If in your folder 'copyToSDCard' you have multiple build type (Development or Master From Unity) Wii U Cafe Deluxe will ask you which one to use). Now wait, the tool can freeze, and you will have your files in the parent folder in 'CopyToWiiUSD' folder (if you have enabled the automatic reproduction, you just need to unplug your SD). Now install it to your Wii U.

It's all for me today, to check if there is an update of this tool, follow this thread of manually go to About > Check for Updates.

Have a good day and fun with your Wii U and Unity.

(For interested people about making a Wii U game on Unity, I am currently writing a complete tutorial and documentation in English and French based on my week searchs and Wii U Software and knowledge)
 
Last edited by RetroAndDev,

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
Can you send me the logs from Wii U Cafe SDK Deluxe ? (From home > Logs)
Do you launch the exe (by double-clicking it) or in any other ways.
The error describe that the file keygen.py inside the folder of 'WiiUCafeSDKDeluxe.exe' is missing or not found, check if the file exists.
What version of the tool do you use ?
 

Jalm

Member
Newcomer
Joined
Nov 21, 2020
Messages
8
Trophies
0
Age
21
XP
166
Country
Venezuela
Can you send me the logs from Wii U Cafe SDK Deluxe ? (From home > Logs)
Do you launch the exe (by double-clicking it) or in any other ways.
The error describe that the file keygen.py inside the folder of 'WiiUCafeSDKDeluxe.exe' is missing or not found, check if the file exists.
What version of the tool do you use ?
the file exists, I am using version 1.1.0 of the tool

[Log] Checking folders...
[Sucess] Remote version : 1.1.0 local : 1.1.0
[Sucess] Local Major > or = to Remote Major
[Sucess] Local Minor > or = to Local Minor
[Sucess] Local Patch > or = to Local Patch
[Log] Loading settings.json file from application's roaming folder
[Log] Checking for wiiudeluxeproj.json...
[Sucess] Project found. Loading Editor...
[Sucess] Calculated copyToSDCard folder in 1
[Log] Saving settings.json file to application's roaming folder
[Log] Saving settings.json file to application's roaming folder

1691860783158.png

Post automatically merged:

and I have already tried both with double click and running as administrator
 

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
During next day I will make the v1.1.1 with new debug infos. I will make a post here when the version will be available
EDIT : I was Buzzy, I am making it now, releasing in the day
 
Last edited by RetroAndDev,
  • Like
Reactions: Jalm

gegus99

Member
Newcomer
Joined
Sep 8, 2021
Messages
5
Trophies
0
Age
61
XP
40
Country
United States
This is great! I am running into a couple issues. For one thing, I'm having the same issue as MysticTortoise, where trying to use any external tool causes it to crash, even though in my Unity build settings I selected NAND. Also, the tool shows the App Config and Master Editor tools as not being installed, even though they are installed through NDI and I've verified the Java, Python, and Wii U SDK paths are correct. Any ideas on what I could do to fix those?

Also, I'm a little unsure on the file structure. My understanding is the tool should be installed in <Project>/Builds, and then the actual Unity builds should be in <Project>/Builds/Ver1, Ver2, etc... ? Or should I separately be installing the tool in each Ver<number> folder? Also, should I be copying the contents of the <Project>/Builds/Ver1/copyToSDCard into the <Project>/Builds/copyToSDCard folder created by the tool?

Thank you so much for making this tool and for (hopefully) responding whenever you have the time - I'm so excited to see how much work you've put into this since the last time I checked and and it's great to see other people still making things for Wii U!
 

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
Hi !
First, if you run out of some issues send me the logs of Wii U Cafe SDK Deluxe, and what version do you use.
In fact, I try to fix this bug from 4 months !
Can also tell me what version of python/Java do you have ?
For python and java, you can type these commands :
Code:
python --version
java -version

To install Wii U Cafe SDK Deluxe (I know my tutorial is bad, the original French version is (also) not good and after translated in English... you see. I will make an installer to him when I will have some time)
And, yeah I needed to check how you need to install it :rofl2:

So to install it,
#1 : Inside your Unity build folder, It can be where you want, but I recommend you to place it like you said at <Project>/Builds
#2 : Download and extract to your <Project>/Builds/ folder the content of Wii U Cafe SDK Deluxe. You can download it from here. (You copy the folder inside the ZIP to the /Builds/ folder to be precise)
#3 : Open WiiUCafeSDKDeluxe.exe, and configure your project.
#4 : Create a new version inside Wii U Cafe SDK Deluxe, name it as you want.
#5 : Make your Build in Unity.
To build you will target Wii U (logic) as "Download Image" (Build Output) and "NAND" (Boot Mode). You will build inside the version folder (the one you created and not "Versions" who contains tool's versions information)
#6 : Relaunch Wii U Cafe SDK Deluxe and the section about your version will be filled. The size of "copyToSdCard" will be filled with the app size. Now you can use Wii U Cafe SDK Deluxe !

If you created a version "MyVersion", you will select the target build folder like <Project>/Builds/MyVersion. He "normally" be created by tool when you created a version.

If you have any other questions I'm here !
Thank you so much for making this tool and for (hopefully) responding whenever you have the time
I will always respond to my users ! And to say it, the core of the tool is a big piece of sh***. I made it in one week during French February vacations. (With all the search about how to install Unity build to a Wii U). There are a lot of things who are terrible in the code. For the v2 with all news feature I will entire recode it, to have a solid base. I also know that my tutorial is ... how to say it... you see what I mean. I will remake it after the release of the final tutorial.

So here you go. I'm here to support the (best) Nintendo console.
Have a good day !
 

gegus99

Member
Newcomer
Joined
Sep 8, 2021
Messages
5
Trophies
0
Age
61
XP
40
Country
United States
Thank you for the quick response! I'm using WiiUCafeSDKDeluxe v1.1.1, Java version 1.8.0_391, and Python version 3.7.3. Because I'm a new user, I can't attach files or links - I'll see if I can PM you the logs or something. (edit: just sent them!)

I made a new project, reinstalled Cafe SDK Deluxe in that project's Builds folder, and now the App Config and Master Config tools show as properly installed. I'm not sure why it didn't work in the first project since the SDK directory is the same, but I'm happy that's working now.

I'm still having the same issue whenever I try to Generate Title Keys or use any other external tool, though. From looking at the logs I'm guessing it's some issue with finding the Python install - I know the path I've entered in Settings is correct, and the log shows that Python.exe is found but it still seems to have some trouble identifying it:

[Log] [AppCheck] AppCheck is going to check all tools paths
[Sucess] [AppCheck] java.exe exists at C:\Program Files (x86)\Java\jre-1.8\bin\java.exe
[AppCheck] Java is UNDIFINED, and support is not confirmed ! Continue at your own risk(s). If you want this message to go, install and specify Java 18.0.2.1 in settings
[AppCheck] Java JDK 18.0.2.1 sha256: 2faa5c83dc5ca3483b20d4b475a2e6491f1f2a0942a773d92c664fd794c25a5f, Installed Java sha256: f18f7d1597cd057f93bd127c4b614faaca0103b2233bcef5462c0e98d4da3bc7
[Sucess] [AppCheck] python.exe exists at C:\Users\craft\AppData\Local\Programs\Python\Python37-32\python.exe
[AppCheck] Python is UNDIFINED, and support is not confirmed ! Continue at your own risk(s). If you want this message to go, install and specify Python 3.7.3 in settings
[AppCheck] Python 3.7.3 sha256: 5da31132fd6a415e71e3fd40c3a23853a799b91ea2821d2bcbf1bf0e8fa01e16, Installed Python sha256: ca4362492d4625542fd43e4f0e749f7a3fb6c4b0f8beaee180653f25cfb3cb90
[Log] [AppCheck] AppCheck terminated without any error(s)

(For the full log see Log.log in the attached .zip) At first, I thought this was because I had two different versions of Python installed, so I uninstalled both and installed version 3.73, as the log suggests, but the log still gives the same message. And when I try to Generate Title Keys, I get a long error message ( seeMasterOptionsCrash.png and MasterOptionsCrashReport.txt in the attached .zip), though nothing gets added to the log. I know the path I entered to both Python and Java are correct because when I copy paste the paths from the Settings menu into Windows Explorer it launches them (you can double-check that these paths are correct with the PythonInstall and JavaInstall screenshots in the zip) but it still seems to have some trouble finding them.

For what it's worth I did have to manually add Python to PATH (environment variables) in order for the pip install cryptodome command to run in Terminal, and Terminal in general seems to have issues recognizing Python (for example, running python --version just gives me the message:
"Python was not found; run without arguments to install from the Microsoft Store, or disable this shortcut from Settings > Manage App Execution Aliases"
but py --version works fine. Do you think that be the cause or should I look into something else? I'm not familiar enough with Python to really know the significance of that. Thank you so much again : ))
 
Last edited by gegus99,

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
I know these bugs. And I don't know why I can fix them.
For Python, it's an alias problem. I checked in the code if it uses the python.exe path or alias, and it uses the EXE path.....
For Java, the logs just tell you that the java version (1.8.0) was not tested, and I recommend you to use the 18.0.2.1.
If you can't install pip with
Code:
python -m ensurepip --default-pip
use
Code:
py -m ensurepip --default-pip
(use the py alias)
So the issue don't be affected by python alias(es)
For the Ken Gen "crash", I know the issue from 5 months ago, and I can't fix it...
I know this is from a "missing" thing but what. The tool can locate python at launch and the kengen.py file
WHAT THE HELL THIS ISSUE COME FROM ?

For me this work perfectly...

What I can suggest :
Don't use case-sensitive paths :
Ex : C:/Users/<MyUser>/Documents/WiiU_Projects/ is good where C:/Users/<MyUser>/Documents/WiiU Projects/ can produce error(s)
Try to use Python 3.7.2 (x64) and Java 18.0.2.1.

EDIT :
OMG ! I found it !
When you execute a exe from the CLI/Terminal, if there is a space in the path (ex : C:/Program Files/, just as example 🙃) you need to type it like "C:/Program Files/" ANNNNND I have done it only for the script and not for Python exe... (I also noticed that the encrypted key will always fail 'cause of the usage of the default path)
I fix it in the day (For you when you will see this the release will be out)
Thank you for your additional information.
I added some new debug points in logs.

I also want to notice that "normaly" alias can be used now. In Python/Java paths you can now type "py" or "python" / "java" and the tool will use the same exe as "py" in the terminal.
You can see where is "py"/"python"/"java" with "where <alias>"

I fix it now, thanks.
Tell me if you have other issues !
 

gegus99

Member
Newcomer
Joined
Sep 8, 2021
Messages
5
Trophies
0
Age
61
XP
40
Country
United States
Using v1.2 and deleting spaces from the folder names worked! It makes the files properly now :) Now I just need to figure out why I can't get any of my builds to run in Cemu and get past loading (I don't think this is an issue with your tool, I think it's something with Cemu or my Unity build settings since even a straight download image doesn't load). I might try on a real Wii U tonight if I have the time since I saw in another thread that you also had Cemu issues. Thanks again for the help !
 

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
I'm happy to finally fix it !
Forgot Cemu, I never made it work with Unity builds BUT a real Wii U Works
Have fun with Unity Wii U and make games as you want !
 

dakotath

Member
Newcomer
Joined
Dec 27, 2023
Messages
11
Trophies
0
Age
24
XP
23
Country
Canada
Hello, A simple developer here,
I was debugging the Wii U Cafe SDK Deluxe application because it was not launching, and found out that it was not making a settings file. So I made a settings file for it, and it ran. but then I also found out that when you are trying to convert an app that is in a directory that contains a space, it breaks with stuff like

C:\Users\dakot\AppData\Local\Programs\Python\Python310\python.exe: can't find '__main__' module in 'E:\\dakotath\\Unity'

coming out in the decrypted and encrypted key slots of the "Master Options" window. So I renamed the folder from "Unity Builds" to "unity_builds", and it worked.

Another bug I found is that when you create a version, it immediately has an error saying "Cannot find copyToSDCard folder". It did not even create the version folder automatically. So I did that manually, then copied the "copyToSDCard" folder to the manually created version folder, tried making the app, and it worked this time. So there are some bugs that could be fixed.
 

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
My bad. Added to my to do list. Thanks for sharing these. The Wii U Tutorial (part 2) is ready and will be released on January, 5 2024 in the afternoon. I will completely check it, make some edits to WiiU Cafe SDK Deluxe and this will be finished.
If anyone have other improvements, I'm listening!
 

dakotath

Member
Newcomer
Joined
Dec 27, 2023
Messages
11
Trophies
0
Age
24
XP
23
Country
Canada
also, we can't figure out how to install the app to a wii u. We have tried WUP Installer GX2, WUP Installer GX2 Mod, WUP installer y mod, and they all failed with either
  1. the app is not a game, update or dlc

    or

  2. verify wup files are complete

Screenshot 2023-12-29 131459.png
 

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
hum... you're good for the build settings but not the way you install it i think.
You use Wii U Cafe SDK to decrypt and repack the game for Retail Wii U Unit ?
If yes, follow here :
https://gbatemp.net/threads/make-a-unity-game-for-wii-u.633391/page-4#post-10305029
You will find System Config Tool (SCT) in my tutorial files here :
https://gbatemp.net/threads/make-a-unity-game-for-wii-u.633391/

BE CAREFUL !
System Config Tool CAN BRICK YOUR WII U WITH SOME OPTIONS ! DON'T TOUCH TO ANYTHING OTHER ! I WILL NOT BE RESPONSIBLE FOR ANY BRICKED WII U !


I can also recommend you to use (when developing/testing) on real hardware to use these build settings :
Build Debug Level : Development [No network]
Build Output : Download Image
Boot Mode : NAND
 
  • Like
Reactions: dakotath

dakotath

Member
Newcomer
Joined
Dec 27, 2023
Messages
11
Trophies
0
Age
24
XP
23
Country
Canada
hum... you're good for the build settings but not the way you install it i think.
You use Wii U Cafe SDK to decrypt and repack the game for Retail Wii U Unit ?
If yes, follow here :
https://gbatemp.net/threads/make-a-unity-game-for-wii-u.633391/page-4#post-10305029
You will find System Config Tool (SCT) in my tutorial files here :
https://gbatemp.net/threads/make-a-unity-game-for-wii-u.633391/

BE CAREFUL !
System Config Tool CAN BRICK YOUR WII U WITH SOME OPTIONS ! DON'T TOUCH TO ANYTHING OTHER ! I WILL NOT BE RESPONSIBLE FOR ANY BRICKED WII U !


I can also recommend you to use (when developing/testing) on real hardware to use these build settings :
Build Debug Level : Development [No network]
Build Output : Download Image
Boot Mode : NAND
Thankyou for the info, also, will building with debug make it easier to install, or will it just give the same debugging ui that a normal development build would. I have made many games in unity, and really want to make/port some of my games or other open source games to the wii u. Here is my Itch.io page: https://dakotath.itch.io/
 
  • Like
Reactions: RetroAndDev

RetroAndDev

Well-Known Member
OP
Newcomer
Joined
Apr 9, 2023
Messages
75
Trophies
0
Age
16
Location
France
Website
github.com
XP
264
Country
France
I don't precise, you can install System Config Tool with Wup Installer like any other apps/games
You're welcome, have a good day ! (and a good programming session :D)
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
    K3Nv2 @ K3Nv2: Lol rappers still promoting crypto