Skip to content

organismzero/Luna

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

92 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Luna

An Animal Crossing New Horizons tool to dump Dream Islands.

SD file structure

SDMC
├── ...
├── /config/luna/                                   # config folder for Luna.
│   ├── /dump/                                      # folder for dumps.
│   │   ├── /[DREAM_ADDRESS] TownName/              # dump folder format. Example: "/[DA-XXXX-XXXX-XXXX] MyTown
│   │   │   ├──/Date @ Time (in dream)/             #                               /12.12.2020 @ 4.20/"
│   │   │   │   ├── /VillagerX/                     # variable amount of players,  0 <= X < 8
│   │   │   │   │   ├── /personal.dat
│   │   │   │   │   ├── /photo_studio_island.dat
│   │   │   │   │   ├── /postbox.dat
│   │   │   │   │   └── /profile.dat
│   │   │   │   ├── /landname.dat
│   │   │   │   └── /main.dat
│   │   │   └── ...   
│   │   └── ...   
│   └── /template/                                  # folder for user provided template.
│       ├── /VillagerX/                             # variable amount of players,  0 <= X < 8; 
│       │   ├── /personal.dat
│       │   ├── /photo_studio_island.dat
│       │   ├── /postbox.dat
│       │   └── /profile.dat
│       ├── /landname.dat
│       └── /main.dat
├── /switch/.overlays/                              # Tesla-Menu Overlay folder.
│   └── /Luna-ovl.ovl                               # Luna Overlay.
└── ...

How-To

  1. do the thing (Building) or grab a release.
  2. put everything on the SD card and provide 1.10.0 DECRYPTED save as template.
  3. run overlay when you're on a dream island.
  4. grab the dump from your SD card.
  5. ENCRYPT dump and fix file hashes.
  6. ???
  7. Profit.

Building

  1. Requires devkitPro
  2. Requires switch-dev, switch-freetype, switch-zlib

Known Issues

  • Non-ASCII island names can't be saved (e.g. Japanese/Chinese/Korean/Russian, basically every language that doesnt use the roman alphabet.) this is due to Nintendo Switch handling file paths in Shift JIS (basically utf8), which doesn't include non-ASCII characters. I wont be able to fix this. Currently Luna just doesn't include the island name in the path, if its invalid, you can still dump foreign islands, duh.

  • If you want to go online with dumped dream towns and avoid error 2219-3003 ("Network temporarily unavailable"), use your own save file as a template.

Contact

Discord: Poyo#0828

Supporting

If you like my work, please consider supporting me on Patreon, thanks!

Patreon donate button

Credits

  • WerWolv for libtesla and coding help.
  • J-D-K for JKSV, which was used for testing and also part of its code was used for file handling.
  • WalteeWartooth for testing Luna and allowing me to dump their island for research!
  • rabbit_ruby for testing Luna and also breaking my (weak) Revision checker!

About

ACNH Dream dumper Tesla Overlay

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 73.4%
  • C 18.4%
  • Makefile 8.2%