2022-04-24 11:00:14 -04:00
# Building Ship of Harkinian
2022-05-11 13:18:24 -04:00
## Windows
2022-05-13 18:44:58 -04:00
1. Install [Python ](https://www.python.org/downloads/ ) >= 3.6.
2022-04-24 11:00:14 -04:00
2. Install [Visual Studio 2022 Community Edition ](https://visualstudio.microsoft.com/vs/community/ )
2022-05-13 18:44:58 -04:00
3. In the Visual Studio Installer, install `MSVC v142 - VS 2019 C++` .
2022-04-24 11:00:14 -04:00
4. Clone the Ship of Harkinian repository.
5. Place one or more [compatible ](#compatible-roms ) roms in the `OTRExporter` directory with namings of your choice.
6. Run `OTRExporter/OTRExporter.sln` .
7. Switch the solution to `Release x64` .
2022-05-11 13:18:24 -04:00
8. Build the solution.
2022-04-24 11:00:14 -04:00
9. Launching `OTRExporter/extract_assets.py` will generate an `oot.otr` archive file in `OTRExporter/oot.otr` .
10. Run `soh/soh.sln`
11. Switch the solution to `Release x86` .
12. Build the solution.
13. Copy the `OTRExporter/oot.otr` archive file to `soh/Release` .
14. Launch `soh.exe` .
2022-05-11 13:18:24 -04:00
## Linux
```bash
# Clone the repo
git clone git@github.com:HarbourMasters/ShipWright.git
cd ShipWright
# Copy the baserom to the OTRExporter folder
cp < path to your ROM > OTRExporter
# Build the docker image
sudo docker build . -t soh
# Run the docker image with the working directory mounted to /soh
sudo docker run --rm -it -v $(pwd):/soh soh /bin/bash
```
Inside the Docker container:
```bash
# Clone and build StormLib
git clone https://github.com/ladislav-zezula/StormLib external/StormLib
cmake -B external/StormLib/build -S external/StormLib
cmake --build external/StormLib/build
cp external/StormLib/build/libstorm.a external
cp /usr/local/lib/libGLEW.a external
cd soh
# Extract the assets/Compile the exporter/Run the exporter
2022-05-13 18:44:04 -04:00
make setup -j$(nproc) OPTFLAGS=-O0 DEBUG=0
2022-05-11 13:18:24 -04:00
# Compile the code
2022-05-13 18:44:04 -04:00
make -j $(nproc) OPTFLAGS=-O0 DEBUG=0
2022-05-11 13:18:24 -04:00
```
# Compatible Roms
2022-04-24 11:00:14 -04:00
```
OOT_PAL_GC checksum 0x09465AC3
OOT_PAL_GC_DBG1 checksum 0x871E1C92 (debug non-master quest)
```
2022-05-13 18:44:58 -04:00
# OTRExporter Usage
The OTRExporter exports an `oot.otr` archive file which Ship of Harkinian requires to play.
Use the `extract_assets.py` script file to run the exporter using any of the following methods:
1. Double click on the script after placing one or more roms in the directory.
2. Drag & Drop a rom onto the script.
3. In a terminal run `python3 extract_assets.py` after placing one or more roms in the directory.
4. In a terminal run `python3 extract_assets.py <path_to_rom>`
If the script finds multiple roms the user is prompted which to use. Selection is done using the number keys and then pressing the carriage return key.