zjmerry/Luna-App

Homebrew App to dump Animal Crossing: New Horizons islands you visit. Now using on-device De- and Encryption!

Luna

English / German (Deutsch)

Luna is a homebrew app designed to dump Animal Crossing: New Horizons islands you visit.

Disclaimer & License

• Luna is not affiliated with, endorsed or approved by Nintendo or Animal Crossing: New Horizons in any way.
• Luna is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Quick Start Guide

Pre-Requisites

• A modded Nintendo Switch console running Atmosphère NX

Installation

Head to the release page and download the latest released luna.zip and extract it onto your Switch's SD card.
Luna requires a save-file-template to work. either use your own save file^[1] or use the included enctemplate.zip and unzip it in SD:/config/luna/enctemplate.

^[1]under the requirement, that it has the same amount of players (or more) as the island you are trying to dump.

Usage

When visiting an island, whether it being a dream or a friend's island, open the homebrew menu (album app) and start Luna.
It will show you the option to dump the current island and should also display their name.

Now press the Dump button and let it work for a few seconds. If everything went right, you now have a dumped island in the dump folder, which can be used by the game and tools like NHSE.

File Tree

  📦SD
   ┣ 📂config
   ┃ ┗ 📂luna
   ┃ ┃ ┣ 📂dump
   ┃ ┃ ┃ ┗ 📂[DA-XXXX-XXXX-XXXX] IslandName              # a singular dump folder
   ┃ ┃ ┃ ┃ ┃ 
   ┃ ┃ ┃ ┃ ┗ 📂DD.MM.YYYY @ hh-mm                        # internal date and time of the island you visited.
   ┃ ┃ ┃ ┃                                                 If you plan on using a save manager to load the save,
   ┃ ┃ ┃ ┃                                                 please load this exact folder and not the folder above. :)
   ┃ ┃ ┃ ┃
   ┃ ┃ ┗ 📂enctemplate                                   # folder where the template goes; has to be the standard 
   ┃ ┃                                                     encrypted format, which you get from every save file manager 
   ┃ ┃                                                     (Checkpoint, JKSV) 
   ┃ ┃
   ┗ 📂switch
     ┗ 📜luna.nro                                        #Luna homebrew app

Building

• requires devkitpro/devkita64 for compiling

TO-DO:

• write documentation
• publish source code
• ???
• release

Credits

Thanks to:

• WinterMute, fincs and contributors of devkitPro and specifically devkitA64
• Yellows8 and all the mantainers of switch-examples
• kwsch and contributors of NHSE
• Ninji for their CylindricalEarth research
• Slattz for being a bad bitch and creating LibACNH
• WerWolv for handling my constant questioning

Luna is based on Atmosphère's Daybreak, Adubbz's NanoVG port to deko3d and the filehandling of J-D-K's JKSV, as well as my own arduous research on Animal Crossing: New Horizons' inner workings of visiting other people's islands.