# zelda64recomp/zelda64recomp

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/zelda64recomp-zelda64recomp).**

6,843 stars · 316 forks · C · gpl-3.0

## Links

- GitHub: https://github.com/Zelda64Recomp/Zelda64Recomp
- awesome-repositories: https://awesome-repositories.com/repository/zelda64recomp-zelda64recomp.md

## Description

Zelda64Recomp is a native game recompilation project that translates legacy binary machine code into modern machine code. It functions as a native hardware port and a static recompiled binary, executing original game logic directly on modern CPUs and GPUs to run without an emulator.

The project serves as a moddable game engine, providing a framework to apply community texture packs and code patches to the recompiled title. It includes native hardware porting capabilities that remove emulator overhead to improve stability and frame rate control.

The software covers retro game modernization through widescreen support, high frame rate scaling, and native hardware input mapping for gamepads and gyroscope sensors. It also includes capabilities for legacy code patching, native asset injection, and a dedicated interface for game modding integration.

The application can be distributed as a containerized Flatpak for Linux environments and supports a portable mode for storing configurations and save files within the application folder.

## Tags

### Part of an Awesome List

- [Game Engine Porting](https://awesome-repositories.com/f/awesome-lists/devtools/game-engine-porting.md) — Executes original game logic directly on modern CPUs and GPUs by replacing binary instructions with native code.
- [Moddable Engines](https://awesome-repositories.com/f/awesome-lists/devtools/strategy-game-engines/moddable-engines.md) — Provides a framework for applying community texture packs and code patches to the natively recompiled game.

### Game Development

- [Native Recompilations](https://awesome-repositories.com/f/game-development/retro-game-emulation/native-recompilations.md) — Executes original game logic directly on modern CPUs and GPUs to remove emulator overhead and improve performance. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))
- [Game Asset Importers](https://awesome-repositories.com/f/game-development/game-asset-importers.md) — Automatically loads game assets from original files without requiring manual extraction. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp#readme))
- [Engine Modernizers](https://awesome-repositories.com/f/game-development/game-engines-frameworks/game-engines/engine-modernizers.md) — Updates a classic title with widescreen support, high frame rates, and modern controller mappings.
- [Native Game Ports](https://awesome-repositories.com/f/game-development/native-game-ports.md) — Provides a high-performance native implementation that runs original game logic directly on modern CPUs and GPUs.
- [Modding Frameworks](https://awesome-repositories.com/f/game-development/tooling-asset-pipeline/modding-frameworks.md) — Provides a framework and interface to apply community-created content and texture packs. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp#readme))
- [Cross-Platform Porting](https://awesome-repositories.com/f/game-development/cross-platform-porting.md) — Adapts original console hardware logic into a containerized application that runs across different modern platforms.
- [Game Memory Modifiers](https://awesome-repositories.com/f/game-development/game-memory-modifiers.md) — Allows modification of gameplay variables like movement speed and item availability through configuration files. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/config_example.cheats.en_us.json))
- [Game Modding Interfaces](https://awesome-repositories.com/f/game-development/game-modding-interfaces.md) — Load community-made modifications and textures using a drag-and-drop interface or an integrated menu. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))
- [Sensor Input Handlers](https://awesome-repositories.com/f/game-development/sensor-input-handlers.md) — Implements native support for controller gyroscopes to allow precise first-person aiming. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))

### Programming Languages & Runtimes

- [AOT Binary Recompilation](https://awesome-repositories.com/f/programming-languages-runtimes/aot-binary-recompilation.md) — Implements static translation of legacy game binary instructions into host-compatible source code to eliminate emulator overhead.

### Hardware & IoT

- [Native Controller Mappings](https://awesome-repositories.com/f/hardware-iot/emulated-input-mappings/native-controller-mappings.md) — Connecting modern gamepads and gyroscope sensors to legacy control schemes for a more precise playing experience.
- [Input Remapping](https://awesome-repositories.com/f/hardware-iot/input-behavior-configurators/input-configurators/input-remapping.md) — Allows remapping physical controller buttons to virtual actions with options for axis inversion and deadzones. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))
- [Input Control Assignment](https://awesome-repositories.com/f/hardware-iot/input-control-assignment.md) — Connect physical gamepad buttons and axes to virtual controls using a standardized input database. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/recompcontrollerdb.txt))

### Operating Systems & Systems Programming

- [Binary Instruction Patching](https://awesome-repositories.com/f/operating-systems-systems-programming/binary-instruction-patching.md) — Modifies original binary instructions and memory addresses to fix crashes and optimize performance for modern hardware.
- [Nintendo 64 Recompilation](https://awesome-repositories.com/f/operating-systems-systems-programming/nintendo-64-recompilation.md) — Translates Nintendo 64 binaries and symbol data into a native application for modern hardware. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/us.rev1.toml))
- [Symbol-Based Patching](https://awesome-repositories.com/f/operating-systems-systems-programming/binary-instruction-patching/symbol-based-patching.md) — Modifies native binary instructions by resolving original symbol addresses to apply fixes or optimize logic.

### Software Engineering & Architecture

- [Logic-Rendering Decouplers](https://awesome-repositories.com/f/software-engineering-architecture/headless-logic-decoupling/logic-rendering-decouplers.md) — Decouples the rendering speed from the game simulation clock to maintain consistent timing across different refresh rates. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp#readme))
- [Game Asset Injection](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/dependency-injection/environment-asset-injection/game-asset-injection.md) — Loads original game data files directly into a modern memory layout without requiring a full emulator.
- [Game Binary Patching](https://awesome-repositories.com/f/software-engineering-architecture/game-binary-patching.md) — Modifies memory addresses and instructions to prevent crashes or optimize original game behavior. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/us.rev1.toml))

### User Interface & Experience

- [Game Input Mapping](https://awesome-repositories.com/f/user-interface-experience/game-input-mapping.md) — Translates raw gamepad and hardware inputs into virtual game actions through a standardized mapping database.
- [Display Scaling](https://awesome-repositories.com/f/user-interface-experience/display-scaling.md) — Provides options to scale the image to fit widescreen and ultrawide aspect ratios with a repositionable HUD. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))
- [Native Input Mappers](https://awesome-repositories.com/f/user-interface-experience/form-and-input-management/input-handling/native-input-mappers.md) — Maps modern gamepad and gyroscope signals into kernel-level input events for legacy control schemes.
- [Control Scheme Customization](https://awesome-repositories.com/f/user-interface-experience/numeric-inputs/numeric-input-fields/control-scheme-customization.md) — Implements modern control schemes including dual analog cameras, gyro-aiming, and adjustable stick deadzones. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp#readme))

### Graphics & Multimedia

- [Frame Rate Capping](https://awesome-repositories.com/f/graphics-multimedia/frame-rate-capping.md) — Enables graphics to run at any target frame rate without altering the speed of game physics or events. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))
- [Surface Effect Rendering](https://awesome-repositories.com/f/graphics-multimedia/surface-effect-rendering.md) — Replicates original hardware graphical effects and lighting using native rendering techniques. ([source](https://github.com/Zelda64Recomp/Zelda64Recomp/blob/dev/README.md))