gitwtfhub

wtf is n64-to-soh?

ctgl1987/n64-to-soh — explained in plain English

Analysis updated 2026-05-18

2JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

A browser tool that converts N64 emulator save files into the format used by the Ship of Harkinian PC port, with full inventory editing built in.

Mindmap

mindmap
  root((N64 to SoH Converter))
    What it does
      Converts emulator saves
      Edits inventory visually
      Upgrades save versions
    Tech stack
      JavaScript
      Browser only
    Use cases
      Continue progress on PC port
      Edit items and equipment
      Load existing SoH saves
    Audience
      Retro gamers
      Emulator users
    Setup
      Open in browser
      Drag and drop save file
      Export .sav file

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Convert an N64 emulator save file into a format Ship of Harkinian can load, so you can continue your progress.

REASON 2

Edit an existing save's items, equipment, and quest progress before or after conversion.

REASON 3

Load an existing Ship of Harkinian save to view or tweak it without touching the emulator.

REASON 4

Automatically upgrade an older save file version to the current supported format.

What's in the stack?

JavaScript

How it stacks up

ctgl1987/n64-to-soh3imed-jaberi/cryptography-si-isamm3imed-jaberi/koa-isomorphic-router
Stars222
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-09-252021-02-06
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencegeneralresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

No install needed, just open index.html or the live demo page in a browser.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

This is a browser-based tool that converts old Nintendo 64 emulator save files into a format used by Ship of Harkinian, a fan-made PC port of a classic N64 game. People who have been playing the game on an emulator like Mupen64Plus, Project64, RetroArch, or BizHawk can take their existing .sra or .srm save file and turn it into a .sav file that Ship of Harkinian understands, so they can keep playing on the PC version without starting over. The converter shows the save data using the same visual layout as the game's in-game pause menu, split into Items, Equipment, Quest, and Save screens across all three save slots. Beyond just converting the file format, it lets someone open an edit panel on any screen and change what they have: check or uncheck items, pick which upgrade tier their equipment is at, mark which songs or spiritual stones they have collected, and adjust basic details like the player's name, money, and health. Any changes made show up as color coded badges so it is clear what was in the original save versus what was added during editing, and there is a button to undo all edits and go back to the original values. The tool also understands Ship of Harkinian's own save files directly, so someone can load an existing .sav file to view or re-edit it, and it automatically upgrades older save format versions to the current one. It automatically figures out which emulator produced a given save file by checking the byte order and padding the file if needed, since some emulators save in a smaller size than others. Everything runs entirely in the browser with no server involved, so a person can just open the page, drag their save file in, make any edits, and export the result directly to their Ship of Harkinian save folder. The project is released under the MIT license.

Yoink these prompts

Prompt 1
Explain which emulator save formats this tool supports and how it detects byte order automatically.
Prompt 2
Walk me through converting my Project64 save file into a Ship of Harkinian .sav file.
Prompt 3
Show me how the equipment upgrade bitmask works in the save format so I can edit it manually.
Prompt 4
Help me understand what changes when a save is upgraded from version 1 to version 4.

Frequently asked questions

wtf is n64-to-soh?

A browser tool that converts N64 emulator save files into the format used by the Ship of Harkinian PC port, with full inventory editing built in.

What language is n64-to-soh written in?

Mainly JavaScript. The stack also includes JavaScript.

What license does n64-to-soh use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is n64-to-soh to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is n64-to-soh for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.