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,
Hi !
New update about v2
I needed to pause the rework during summer. I will retake it in a few days.
Major changes :
No python dependency needed anymore
Faster build
Better UI
(Almost) no setup
And an in-engine (Unity) extensions

I want to know if you have some request to make (features, fixes, tools...) for the v2.
I hope to release it before the ends of November 2024.

Great day !
 
Hi
I’m glad people had interested to make Wii I games again. Especially with my tool
Unfortunately I am not able to work on it for now. The v1 (normally) works.
The v2 will be directly an Unity plugin to make post build actions. But I don’t have the time for now. I have 2 other majors projects with one who will release in 2-3 weeks. And as a student, I have classes, homework and tests/exams this year.
I will do the v2, if not before maybe during July/August 2025. It will need a lot of time to rework it completely, because it’s been almost 2 years since I got an app working on a Wii U and I don’t remember exactly how to do it again (and there is maybe a easier way)
If you have questions about the v1 ask them, I can reply but I will not make updates to the v1.
I hope you can still use the v1 and I promise to make the v2 real and easier to use
 
I think I'm using a fork of your project that allows for me to use the program on windows 10. I've made it to where I can "Make Master For my Hardware" but it always throws an exception:

Code:
See the end of this message for details on invoking
just-in-time (JIT) debugging instead of this dialog box.


************** Exception Text **************
System.ComponentModel.Win32Exception (0x80004005): The system cannot find the file specified
   at System.Diagnostics.Process.StartWithCreateProcess(ProcessStartInfo startInfo)
   at System.Diagnostics.Process.Start()
   at WiiUCafeSDKDeluxe.MasteringWindow.RepackContentWithNus()
   at WiiUCafeSDKDeluxe.MasteringWindow.<CopyRawToNus>d__18.MoveNext()
--- End of stack trace from previous location where exception was thrown ---
   at System.Runtime.CompilerServices.AsyncMethodBuilderCore.<>c.<ThrowAsync>b__6_0(Object state)

I don't know how to get past that.

EDIT:
I figured it out. I didn't have java pointed to in the settings. Smooth sailings.
 
Last edited by handy333,
Hello devs !
Today I annonce that I retake the project as I am in vacations ! Yay !!!

So, after a bit of digging with the help of a wonderful thing named “Internet” I found more Wii U Unity things. If everything is good, the v2 version will use Unity 2018.1.0a7 or 2017.4.40f1 (if I remember correctly the exact versions)

As well with the complete rewrite of Wii U SDK Deluxe, I will create a full documentation to make games on the Wii U as I will back port Into the Breach on it. With new content and feature.

I only have one thoughts about the v2.
Would you prefer an Unity plugin, that is maybe less stable but have a better integration
Or a python app in CLI
(Or maybe a mix of both ? With a post build script in Unity to make the build usable on retail Wii U unit)

If you have any suggestions for the tool let me know !

Stay tuned for the next days.
Have a good day !
 
  • Love
Reactions: lordelan
v2 Sounds so good, I was wondering if both 2018.1.0a7 and 2017.4.40f1 had native support for building to the Wii U because it makes sense for Nintendo to discontinue Unity for Wii U around 2017, but if you're planning on supporting them with a unity asset, I'm guessing they do? Anyways, hope development goes well and I deeply appreciate the work you're currently doing, keep it up.
 
It's been a long time since I made a real update of this tool. Today, I post the first preview of the v2 !
Here is a link of me building, mastering and installing a Unity game on a retail Wii U unit.
Café SDK Deluxe v2 - Demonstration : Mastering & Installing a Unity game to a Wii U

Café SDK Deluxe v2.0.0 is almost ready as a standalone tool. No more need of Java and Python, now as a single executable file ! Faster installations, faster builds and easier to use

Stay tuned for release tomorrow or this weekend (as a beta).

I ordered a new Wii U unit for risky jobs as I don't want to brick my own with customs OS, firmware and apps... argh ! I already talked too much...
New announcements of tools and utilities for Wii U Unity Homebrew games are coming in the next few weeks. I'll keep the suspense a bit more.
See you tomorrow for release (I hope so !)
 

Site & Scene News

Popular threads in this forum