Static recompilation of Majora's Mask (and soon Ocarina of Time) for PC (Windows/Linux)
Go to file
Mr-Wiseguy b18262c692 Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
assets Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
docs Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
icons Add Linux taskbar icon (#6) 2024-04-25 03:04:18 -04:00
include Implemented UI for controlling autosaving, fixed general config defaults not being applied correctly 2024-05-04 13:08:14 -04:00
lib Update RT64 and shader cache, add decals to N64 effect list in readme, bump version number to 1.0.0-rc2 2024-05-06 22:47:31 -04:00
patches Fix the right edge on the purple background for scene title cards (#20) 2024-05-06 20:03:48 -04:00
rsp Added recomp runtime library and portultra, MM initial boot 2023-02-19 22:27:35 -05:00
shadercache Update RT64 and shader cache, add decals to N64 effect list in readme, bump version number to 1.0.0-rc2 2024-05-06 22:47:31 -04:00
shaders Update RT64, split UI immutable sampler into its own descriptor set 2023-11-24 18:12:58 -05:00
src Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
ultramodern Update RT64 and shader cache, add decals to N64 effect list in readme, bump version number to 1.0.0-rc2 2024-05-06 22:47:31 -04:00
.gitignore Fixed race condition with thread deletion, update RT64 2024-04-27 15:06:26 -04:00
.gitmodules Update RT64 and refactor RT64 handling 2024-04-14 15:59:42 -04:00
CMakeLists.txt Fixed cmake sometimes not linking required libraries on linux 2024-04-27 16:04:13 -04:00
CMakeSettings.json Added release with debug info configuration for VS 2023-10-29 12:13:41 -04:00
COPYING Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
README.md Update readme and general config descriptions, add GPLv3 license, bump verison number to 1.0.0 2024-05-10 00:07:09 -04:00
launch.vs.json Rename cmake project, embed data for custom code directly into executable instead of a separate file 2024-03-15 01:15:33 -04:00
overlays.us.rev1.txt Reorganized config menu tabs, hide debug menu behind manual config file edit, added missing recompiler config file 2024-03-15 12:13:39 -04:00
patches.toml Added function patching, began reorganizing UI code, added native file dialog library 2023-11-11 17:42:07 -05:00
rev1_overlays.txt Initial commit that can build a static library from recompiled functions 2023-02-19 03:28:39 -05:00
us.rev1.toml Removed use of std::exit and changed recomp runtime to exit normally, added helpers for getting recompiled args and returning values, added example of patch code calling native code 2023-11-12 14:47:38 -05:00

README.md

Zelda 64: Recompiled

Zelda 64: Recompiled is a project that uses N64: Recompiled to statically recompile Majora's Mask (and soon Ocarina of Time) into a native port with many new features and enhancements. This project uses RT64 as the rendering engine to provide some of these enhancements.

This repository and its releases do not contain game assets. The original game is required to build or run this project.

Table of Contents

System Requirements

A GPU supporting Direct3D 12.0 (Shader Model 6) or Vulkan 1.2 is required to run this project (GeForce GT 630, Radeon HD 7750, or Intel HD 510 (Skylake) and newer).

A CPU supporting the AVX instruction set is also required (Intel Core 2000 series or AMD Bulldozer and newer).

Features

Plug and Play

Simply provide your copy of the North American version of the game in the main menu and start playing! This project will automatically load assets from the provided copy, so there is no need to go through a separate extraction step or build the game yourself. Other versions of the game may be supported in the future.

Fully Intact N64 Effects

A lot of care was put into RT64 to make sure all graphical effects were rendered exactly as they did originally on the N64. No workarounds or "hacks" were made to replicate these effects, with the only modifications to them being made for enhancement purposes such as widescreen support. This includes framebuffer effects like the grayscale cutscenes and the Deku bubble projectile, depth effects like the lens of truth, decals such as shadows or impact textures, accurate lighting, shading effects like the fire arrows and bomb explosions, and various textures that are often rendered incorrectly.

Easy-to-Use Menus

Gameplay settings, graphics settings, input mappings, and audio settings can all be configured with the in-game config menu. The menus can all be used with mouse, controller, or keyboard for maximum convenience.

High Framerate Support

Play at any framerate you want thanks to functionality provided by RT64! Game objects and terrain, texture scrolling, screen effects, and most HUD elements are all rendered at high framerates. By default, this project is configured to run at your monitor's refresh rate. You can also play at the original framerate of the game if you prefer. Changing framerate has no effect on gameplay.

Note: External framerate limiters (such as the NVIDIA Control Panel) are known to potentially cause problems, so if you notice any stuttering then turn them off and use the manual framerate slider in the in-game graphics menu instead.

Widescreen and Ultrawide Support

Any aspect ratio is supported, with most effects modded to work correctly in widescreen. The HUD can also be positioned at 16:9 when using ultrawide aspect ratios if preferred.

Note: Some animation quirks can be seen at the edges of the screen in certain cutscenes when using very wide aspect ratios.

Gyro Aim

When playing with a supported controller, first-person items such as the bow can be aimed with your controller's gyro sensor. This includes (but is not limited to) controllers such as the Dualshock 4, Dualsense, Switch Pro, and most third party Switch controllers (such as the 8BitDo Pro 2 in Switch mode).

Note: Gamepad mappers such as BetterJoy or DS4Windows may intercept gyro data and prevent the game from receiving it. Most controllers are natively supported, so turning gamepad mappers off is recommended if you want to use gyro.

Autosaving

Never worry about losing progress if your power goes out thanks to autosaving! The autosave system is designed to respect Majora's Mask's original save system and maintain the intention of owl saves by triggering automatically and replacing the previous autosave or owl save. However, if you'd still rather play with the untouched save system, simply turn off autosaving in the ingame menu.

Low Input Lag

This project has been optimized to have as little input lag as possible, making the game feel more responsive than ever!

Instant Load Times

Saving and loading files, going from place to place, and pausing all happen in the blink of an eye thanks to the game running natively on modern hardware.

Linux and Steam Deck Support

A Linux binary is available for playing on most up-to-date distros, including on the Steam Deck.

To play on Steam Deck, extract the Linux build onto your deck. Then, in desktop mode, right click the Zelda64Recompiled executable file and select "Add to Steam" as shown. From there, you can return to Gaming mode and configure the controls as needed. See the Steam Deck gyro aim FAQ section for more detailed instructions.

Planned Features

  • Ocarina of Time support
  • Mod support and Randomizer
  • Texture Packs
  • Model Replacements
  • Ray Tracing (via RT64)

FAQ

What is static recompilation?

Static recompilation is the process of automatically translating an application from one platform to another. For more details, check out the full description of how this project's recompilation works here: N64: Recompiled.

Unlike N64 ports in the past, this project is not based on the source code provided by a decompilation of the game. This is because static recompilation bypasses the need for decompiled source code when making a port, allowing ports to be made without source code. However, the reverse engineering work done by the decompilation team was invaluable for providing some of the enhancements featured in this project. For this reason, the project uses headers and some functions from the decompilation project in order to make modifications to the game. Many thanks to the decompilation team for all of the hard work they've done.

How do I set up gyro aiming on Steam Deck?

This project provides mouse aiming as a way to allow using gyro on Steam Deck, as the Steam Deck's gyro sensors cannot be read directly. First, launch the game in Gaming Mode, press the Steam button and go to "Controller Settings". Choose "Controller Settings" again in the menu that follows, and then set "Gyro Behavior" to "As Mouse".

Controller Settings menu

You'll probably also want to change the default behavior so that you don't need to be touching the right stick to allow gyro input. To do so, click on the Gear icon to the right of "Gyro Behavior" and ensure that "Gyro Activation Buttons" is set to "None Selected (Gyro Always On)." If this isn't the case, then select that option and then press "Select None" in the following menu.

Known Issues

  • The motion blur effect used by the game was capped to prevent ghosting at incredibly high framerates, which causes it to be less noticeable (this is only really noticeable above 120FPS). This may be fixed in the future by offering the option to render to an HDR framebuffer internally, which would allow it to be uncapped.
  • Intel GPUs on Linux may not currently work. If you have experience with Vulkan development on Linux, help here would be greatly appreciated!
  • The prebuilt Linux binary may not work correctly on some distributions of Linux. If you encounter such an issue, building the project locally yourself is recommended. A Flatpak or AppImage may be provided in the future to solve this issue. Alternatively, running the Windows version with Proton is known to work well and may work around this issue.
  • Overlays such as MSI Afterburner and other software such as Wallpaper Engine can cause performance issues with this project that prevent the game from rendering correctly. Disabling such software is recommended.

Building

Building is not required to play this project, as prebuilt binaries (which do not contain game assets) can be found in the Releases section. Instructions on how to build this project are being worked on and will be available in the very near future.