explaingit

zelda64recomp/zelda64recomp

7,015CAudience · generalComplexity · 3/5Setup · moderate

TLDR

A native PC port of The Legend of Zelda: Majora's Mask that runs without an emulator, adding high framerates, ultrawide support, instant load times, and a drag-and-drop mod system.

Mindmap

mindmap
  root((Zelda64Recomp))
    What it does
      Native PC port
      No emulator needed
      Any framerate
      Ultrawide support
    Features
      Autosave system
      Gyro aiming
      Dual analog camera
      Instant load times
    Mod support
      Drag and drop mods
      Texture packs
      Thunderstore catalog
    Requirements
      Own the game ROM
      GPU from 2012 plus
      64-bit x86 or ARM
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Play Majora's Mask natively on PC at high framerates and ultrawide resolutions without an emulator.

USE CASE 2

Install community texture packs and mods by dragging files onto the game window.

USE CASE 3

Use gyro aiming with a PlayStation DualSense or Switch Pro controller while playing.

USE CASE 4

Create your own Majora's Mask mods using the included mod template and documentation.

Tech stack

CRT64

Getting it running

Difficulty · moderate Time to first run · 30min

You must provide your own legally-owned North American Majora's Mask ROM or cartridge.

License details are not described in the explanation.

In plain English

This project is a native PC port of The Legend of Zelda: Majora's Mask, the Nintendo 64 game originally released in 2000. It does not include the game itself, and you must own a legitimate copy of the original North American cartridge or ROM to use it. What the project provides is a rebuilt version of the game that runs directly on Windows, Linux, and Mac without an emulator, using a technique called static recompilation that converts the original N64 machine code into native code the PC can run directly. Because it runs as a native application rather than through emulation, it can add features that emulators struggle to provide cleanly. The game runs at any framerate and any aspect ratio, including ultrawide monitors, with most effects adapted to work correctly at those settings. Load times are essentially instant. Input lag is low. There is an autosave system added on top of the original save mechanics. Controller support includes gyro aiming (using the motion sensor in controllers like the PlayStation DualSense or Switch Pro) and a dual-analog camera layout similar to later games in the Zelda series. The rendering uses an engine called RT64 that was written to reproduce the original Nintendo 64 graphical effects accurately while also allowing enhancements. The README describes the attention paid to effects like grayscale cutscenes, depth-based effects, lighting, and texture rendering that emulators often approximate or get wrong. The project also has a mod system. Community mods and texture packs can be installed by dragging files onto the game window. A mod template and documentation are available for people who want to create their own mods. A catalog of available mods is hosted on Thunderstore. To run it, you need a reasonably modern GPU from 2012 or later and a 64-bit x86 or ARM processor. An Ocarina of Time port is described as in progress. The project is discussed in a public Discord community, and releases are available on the GitHub releases page.

Copy-paste prompts

Prompt 1
I want to create a mod for the zelda64recomp PC port of Majora's Mask. Walk me through the mod template structure and how to package my mod for Thunderstore.
Prompt 2
Using the zelda64recomp project as reference, explain how static recompilation of N64 MIPS code to x86 works and what limitations it has.
Prompt 3
I am building a texture pack for the zelda64recomp port. What file formats and folder structure does the project expect for custom textures?
Prompt 4
Help me set up gyro aiming in zelda64recomp on Linux with a PS5 DualSense controller.
Open on GitHub → Explain another repo

← zelda64recomp on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.