Homebrew Sonic mania port to wii u

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
Why ofc? I mean you could use this as a base: https://github.com/V10lator/sohwf - simply exchange the meta files (esp the title ID!) and this one line of code: https://github.com/V10lator/sohwf/blob/master/src/main.c#L16
Then use Docker to get the forwarder. Note that you need to handle the Wii Us common key to it through (on GitHub actions this is automated: https://github.com/V10lator/sohwf/blob/master/.github/workflows/master.yml#L32 ). ;)
so that's how we make a forwarder for RPX HBL apps ?
 

Rayz0rum

Well-Known Member
Newcomer
Joined
Mar 16, 2020
Messages
46
Trophies
0
XP
307
Country
United States
Full tutorial to make a forwarder using V10lator's sohwf as a base:
1. Download the master of the following Github repository, Python 3 and Docker:
https://github.com/V10lator/sohwf/
https://www.python.org/downloads/
https://www.docker.com/
2. Change this one line to point to whatever .rpx file you want to forward to:
https://github.com/V10lator/sohwf/blob/master/src/main.c#L16
3. Change the "meta" folder to include the wanted information. (Change graphics, title ID, group ID and the forwarders name in the .xml files) (The Title ID is in Hex characters so 0-9 and A-F)
4. Change these five lines:
https://github.com/V10lator/sohwf/blob/master/Makefile#L33
https://github.com/V10lator/sohwf/blob/master/.github/workflows/master.yml#L37
https://github.com/V10lator/sohwf/blob/master/build.py#L34 (same as to what's in the cos.xml)
https://github.com/V10lator/sohwf/blob/master/build.py#L23
https://github.com/V10lator/sohwf/blob/master/build.py#L40 (to whatever you like but both line 40 and 23 must have the identical name change)
5. Create a file called encryptKeyWith (no file extension) in the same dir, open it with a text editor and put the Wii U Common Key (google it)
6. Open a command prompt or terminal in the same directory.
7. Run this command to get the required dependencies:
docker build . -t builder
8. Run this command to compile:
Windows:
docker run --rm -v %cd%:/project builder python3 build.py
Linux:
docker run --rm -v ${PWD}:/project builder python3 build.py

Troubleshooting:
The docker lines at the end of the guide don't work: Make sure Docker is running in the background.
When installing the forwarders to my NAND and opening them, I get error 199-9999: This is a Title ID issue. Try experimenting with different Title IDs and recompiling till it works on the NAND.
 
Last edited by Rayz0rum,

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
Full tutorial to make a forwarder using V10lator's sohwf as a base:
1. Download the master of the following Github repository and get Docker:
https://github.com/V10lator/sohwf/
https://www.docker.com/
2. Change this one line to point to whatever .rpx file you want to forward to:
https://github.com/V10lator/sohwf/blob/master/src/main.c#L16
3. Change the "meta" folder to include the wanted information. (Change graphics, title ID, group ID and the forwarders name in the .xml files) (The Title ID is in Hex characters so 0-9 and A-F)
4. Change these five lines:
https://github.com/V10lator/sohwf/blob/master/Makefile#L33
https://github.com/V10lator/sohwf/blob/master/.github/workflows/master.yml#L37
https://github.com/V10lator/sohwf/blob/master/build.py#L34 (same as to what's in the cos.xml)
https://github.com/V10lator/sohwf/blob/master/build.py#L23
https://github.com/V10lator/sohwf/blob/master/build.py#L40 (to whatever you like but both line 40 and 23 must have the identical name change)
5. Create a file called encryptKeyWith (no file extension) in the same dir, open it with a text editor and put the Wii U Common Key (google it)
6. Open a command prompt or terminal in the same directory.
7. Run this command to get the required dependencies:
docker build . -t builder
8. Run this command to compile:
Windows:
docker run --rm -v %cd%:/project builder python3 build.py
Linux:
docker run --rm -v ${PWD}:/project builder python3 build.py

Troubleshooting:
The docker lines at the end of the guide don't work: Make sure Docker is running in the background.
When installing the forwarders to my NAND and opening them, I get error 199-9999: This is a Title ID issue. Try experimenting with different Title IDs and recompiling till it works on the NAND.
do i do all of this inside or outside of docker?
 

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
do i do all of this inside or outside of docker?
after you do git clone but before you run docker.
Post automatically merged:

oh, he's downloading the master version. well, after that, but before you use docker. you can change this stuff in notepad++ or what most devs do is use visual studio. that's usually how they code.
 

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
after you do git clone but before you run docker.
Post automatically merged:

oh, he's downloading the master version. well, after that, but before you use docker. you can change this stuff in notepad++ or what most devs do is use visual studio. that's usually how they code.
"git clone" means downloading the shofw master file right?
 

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
yeah, it's about the same thing. some things do not like it if you don't use git clone (say this isn't a git repository or something), but I don't think you have to worry here. plus, it's not all that common when that happens.
 

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
yeah, it's about the same thing. some things do not like it if you don't use git clone (say this isn't a git repository or something), but I don't think you have to worry here. plus, it's not all that common when that happens.
okay so i basically run docker and open the master file of soh using docker? i'm just so confused. also would this work with docker toolbox?
 

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
you need to download the zip, then make the changes. after that, run the docker commands. changes can be done with notepad++. docker just makes it to where you don't have to download a bunch of dependencies, so it's like cheating for compiling. however, it only works with repos that have a docker file like this one.
 

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
you need to download the zip, then make the changes. after that, run the docker commands. changes can be done with notepad++. docker just makes it to where you don't have to download a bunch of dependencies, so it's like cheating for compiling. however, it only works with repos that have a docker file like this one.
thank you so much, this clears things up ALOT
 
  • Love
Reactions: godreborn

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
does anyone know where the flag is for determining if it's plus or not? I think it's in the sonic mania repo itself instead of the rsdk one, but I don't know for sure. I'm going to add it to the ps3 build.
Post automatically merged:

Nm, I figured it out.
 
Last edited by godreborn,

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
In this case downloading is fine but for the next time: https://github.com/git-guides/git-clone
btw can you code the Sonic 1, 2 and CD decomps to support the Wii U Pro Controller? It's such a deal breaker to me to play them using the Wii U Gamepad. I hate it.
Post automatically merged:

Full tutorial to make a forwarder using V10lator's sohwf as a base:
1. Download the master of the following Github repository and get Docker:
https://github.com/V10lator/sohwf/
https://www.docker.com/
2. Change this one line to point to whatever .rpx file you want to forward to:
https://github.com/V10lator/sohwf/blob/master/src/main.c#L16
3. Change the "meta" folder to include the wanted information. (Change graphics, title ID, group ID and the forwarders name in the .xml files) (The Title ID is in Hex characters so 0-9 and A-F)
4. Change these five lines:
https://github.com/V10lator/sohwf/blob/master/Makefile#L33
https://github.com/V10lator/sohwf/blob/master/.github/workflows/master.yml#L37
https://github.com/V10lator/sohwf/blob/master/build.py#L34 (same as to what's in the cos.xml)
https://github.com/V10lator/sohwf/blob/master/build.py#L23
https://github.com/V10lator/sohwf/blob/master/build.py#L40 (to whatever you like but both line 40 and 23 must have the identical name change)
5. Create a file called encryptKeyWith (no file extension) in the same dir, open it with a text editor and put the Wii U Common Key (google it)
6. Open a command prompt or terminal in the same directory.
7. Run this command to get the required dependencies:
docker build . -t builder
8. Run this command to compile:
Windows:
docker run --rm -v %cd%:/project builder python3 build.py
Linux:
docker run --rm -v ${PWD}:/project builder python3 build.py

Troubleshooting:
The docker lines at the end of the guide don't work: Make sure Docker is running in the background.
When installing the forwarders to my NAND and opening them, I get error 199-9999: This is a Title ID issue. Try experimenting with different Title IDs and recompiling till it works on the NAND.
Cmd tells me Unable to find builder:latest locally
What do I do
 
Last edited by muniryka,

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
btw can you code the Sonic 1, 2 and CD decomps to support the Wii U Pro Controller? It's such a deal breaker to me to play them using the Wii U Gamepad. I hate it.
Post automatically merged:


Cmd tells me Unable to find builder:latest locally
What do I do
are you inside the folder with the docker image?
 

muniryka

Well-Known Member
Newcomer
Joined
Feb 24, 2023
Messages
55
Trophies
0
Age
23
XP
70
Country
Algeria
do you mean on the wiiu?
Oh no this is all being done on my pc. When I try to run that command it just says it can't find builder:latest locally even though i'm on the folder of sohfw-master.

I haven't inserted the SD Card of the WII U at all
Post automatically merged:

Oh no this is all being done on my pc. When I try to run that command it just says it can't find builder:latest locally even though i'm on the folder of sohfw-master.

I haven't inserted the SD Card of the WII U at all
So yes cmd is operating on the right folder (sohfw-master) but it keeps bringing that error whenever i try to run the second command of docker.
 

godreborn

Welcome to the Machine
Member
Joined
Oct 10, 2009
Messages
38,471
Trophies
3
XP
29,103
Country
United States
Oh no this is all being done on my pc. When I try to run that command it just says it can't find builder:latest locally even though i'm on the folder of sohfw-master.

I haven't inserted the SD Card of the WII U at all
Post automatically merged:


So yes cmd is operating on the right folder (sohfw-master) but it keeps bringing that error whenever i try to run the second command of docker.
is docker open? it should be a white or black sub icon on the taskbar.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
    K3Nv2 @ K3Nv2: Sorry for accidentally bending over