Nycolazs / ACNHRecomp

# ACNHRecomp
**A native PC port of Animal Crossing: New Horizons, made by static recompilation.**
ACNHRecomp turns the Nintendo Switch code of *Animal Crossing: New Horizons* **3.0.2** (title ID
`01006F8002326000`) into native code for your computer. It is not an emulator: the game's AArch64 machine code is
translated ahead of time into C++ and compiled for the host, the system services the game calls are reimplemented
natively, and the game's NVN graphics calls are translated to **Vulkan**. It is built on the framework of
SuperMarioWonderRecomp.
> [!IMPORTANT]
> **No game files are included.** This repository contains no code, assets, keys or firmware from the game, and
> neither does anything the project shares. You need your own legally obtained copy of the game, its 3.0.2 update
> and your console's keys; the build is produced on your computer from your dump. Never distribute the resulting
> executable: it contains game code recompiled from your dump.
> [!NOTE]
> The detailed developer documentation (docs/STATUS.md, docs/REFERENCES.md)
> is written in Portuguese for now; docs/ACNH.md is in English.
## Contents
- Features
- Screenshots
- Status
- Disclaimer
- Requirements
- Installation
- Playing
- Settings
- Controls
- Saves
- Languages and mods
- Building from source
- Troubleshooting and FAQ
- Repository layout
- How it works
- Credits and references
- License
## Features
- **Native code, no emulation.** The `main`, `sdk` and `subsdk0` modules are recompiled to C++ and compiled with
 clang; game pointers are host pointers.
- **NVN to Vulkan.** The game's graphics API is implemented over Vulkan; its Maxwell GPU shaders are translated
 offline to SPIR-V with the Ryujinx (Ryubing) shader translator.
- **In-game settings screen** (F1, or Minus + Plus on a controller) styled after the game, with its menu in
 12 languages detected from the system.
- **Resolution and display options:** 1080p (TV mode) or 720p (handheld mode), AMD FSR 1 upscaling with adjustable
 sharpness, wider aspect ratios (16:10, 21:9, 32:9 and phone ratios), windowed or fullscreen.
- **Controllers:** any controller SDL3 recognises (Xbox, PlayStation, Switch Pro Controller / Joy-Con, generic
 pads), a Nintendo or Xbox/PlayStation confirm-button layout, and in-game button icons redrawn for Xbox,
 PlayStation or Switch. Fully remappable keyboard controls.
- **Save management:** import from Switch backups (JKSV, Checkpoint), from emulators (yuzu and its forks,
 Ryujinx/Ryubing) or from another ACNHRecomp; export in a format JKSV and Checkpoint can restore on a console;
 automatic backups.
- **All 14 game languages**, plus Brazilian Portuguese through a fan translation you install yourself, loaded as a
 RomFS mod (LayeredFS).
- **DLC** (add-on content) from your own NSPs.
- **Island clock** follows your computer's date, time and time zone, as on the console.
- **Performance work for modest hardware:** presets for integrated GPUs, an option to bypass the CPU-heavy audio
 reverb, pi