(GUIDE) How to add Ocarina of Time PC Port to Retropie (Pi5 64bit)
-
This guide will show you how to add Ship of Harkinian (https://www.shipofharkinian.com) to RetroPie. I've tested this on Raspberry Pi OS using a Pi 5. I can't confirm if it will work on a Pi 4 (either 32bit or 64bit build)
To avoid running out of memory, increase the memory swap (it's likely this is not needed on a 8GB Pi 5):-
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
Edit the below line, I used CONF_SWAPSIZE=1024
CONF_SWAPSIZE=100
Finally restart the swapfile so programs recognise the change
sudo dphys-swapfile setup sudo dphys-swapfile swapon
Note:- for peace of mine I would reverse this process after building as it will damage your SD card in the long run
Step Two:-
Now you can follow the steps in the Shipwright GitHub:-
git clone https://github.com/HarbourMasters/Shipwright.git cd Shipwright git submodule update --init
Copy your Ocarina .z64 (vanilla or master quest or both) roms into ORTExporter folder. There's certain roms it needs, Google is your friend, Ship of Harkinian's website also has a web app that checks if your rom is valid.
Install the dependancies:-
sudo apt-get install gcc g++ git cmake ninja-build lsb-release libsdl2-dev libpng-dev libsdl2-net-dev libzip-dev zipcmp zipmerge ziptool nlohmann-json3-dev libtinyxml2-dev libspdlog-dev libboost-dev libopengl-dev
Now we can start building:-
cmake -H. -Bbuild-cmake -GNinja cmake --build build-cmake --target ExtractAssets cmake --build build-cmake
You should end up with some file inside Shipwright/build-cmake/soh:-
soh.elf
soh.otr
oot.otrCopy these over to /opt/retropie/ports/soh
Inside /opt/retropie/ports/soh create a file soh.sh (make it executable as well)
#!/bin/bash # Change directory cd /opt/retropie/ports/soh || exit # Run the soh.elf file ./soh.elf
Create a folder soh inside /opt/retropie/configs/ports and add emulators.cfg:-
soh = "/opt/retropie/ports/soh/soh.sh" default = "soh"
Finally create another .sh file inside your roms/ports folder and make that executable:-
#!/bin/bash "/opt/retropie/supplementary/runcommand/runcommand.sh" 0 _PORT_ "soh" ""
Edit: added @roslof 's step here to change ownership from root to pi group:-
sudo chown -R pi:pi /opt/retropie/ports/soh
To use Mods, inside /opt/retropie/ports/soh create a folder called mods and put the mod .otr files inside there
-
-
Enjoying this very much. Similar to the Mario 64 PC project. Thanks for providing the detailed steps!
@retropieuser555 said in (GUIDE) How to add Ocarina of Time PC Port to Retropie (Pi5 64bit):
Edit the below line, I used CONF_SWAPSIZE=1024
FWIW with this value, I still ran out of memory. With a large enough drive, would recommend boosting to 2048 to be safe.
Would also remove the
-- -j4
at the end of each command-line for Bookworm.Lastly, for things to work with the .sh files provided, note that the /opt/retropie/ports/soh folder should be pi:pi
sudo chown -R pi:pi /opt/retropie/ports/soh
Hope this helps.
-ros -
So, I followed everything as said in here, the port opens and works just fine on raspbian, but when i try to run it trough retropie it just sends me back to the ports menu.
-
@Deityfierezy So there might be some kind of error in the master branch, I re-tried it now with an earlier branch it worked out for me.
Maybe try this and see if it works for you:-
git clone https://github.com/HarbourMasters/Shipwright.git cd Shipwright git checkout 8.0.4 git submodule update --init
-
Also I have been testing out their Majora's mask Port and it also works. Same steps and dependencies as for Ocarina but after those then run this:-
git clone https://github.com/HarbourMasters/2ship2harkinian cd 2ship2harkinian git submodule update --init
Copy your Majora's mask .z64 rom into ORTExporter directory then run these:-
cmake -H. -Bbuild-cmake -GNinja cmake --build build-cmake --target ExtractAssets cmake --build build-cmake
As before copy the 2s2h.elf, 2ship.o2r & mm.o2r into /opt/retropie/ports/2s2h and create an .sh file that points towards it and the similar steps as before.
Only done a quick run around as the deku doing the first cycle but it seems to play pretty well
Contributions to the project are always appreciated, so if you would like to support us with a donation you can do so here.
Hosting provided by Mythic-Beasts. See the Hosting Information page for more information.