OpenPunk/citra
1
0
Fork 0
mirror of https://github.com/citra-emu/citra.git synced 2024-11-23 20:00:09 +00:00
Code Issues Projects Releases Wiki Activity

all home folder information has been relegated to other pages and links to this page have been updated. This is being updated with a redirect link so that existing external links don't land on a 404 page.

tekas 2016-11-29 11:30:04 -06:00
parent 22b160d8b7
commit e08caf4967
1 changed files with 1 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
Home-Folder.md

@ -1,71 +1 @@
## Dumping the Home Folder
At this time, Citra can run many games without needing to do any special work on a physical 3DS. However, some games do require files dumped from a 3DS in order to function properly. These files are copyrighted and are not allowed to be shared, so don't ask for them on the forum. If you do not own a 3DS to dump the files from, you are out of luck.
This tutorial will teach you [how to dump the system archives and system font](https://github.com/citra-emu/citra/wiki/Home-Folder#how-to-dump-system-archives-and-system-font), which are critical for some games, such as Pokemon, to work. It will also teach you how to [dump the config savegame](https://github.com/citra-emu/citra/wiki/Home-Folder#how-to-dump-the-config-savegame), but that is much more difficult to do and is generally not required to play most titles except in certain special cases.
##### Preview of the dumped files in this tutorial after being merged into Citra, from Citra's root directory
Location of the "User Directory": on Windows it is the user folder in the same directory as the Citra executable. on macOS and Linux it is at ~/.local/share/citra-emu/
```
"User directory"
├── nand
│   ├── 00000000000000000000000000000000
│   │   └── title
│   │   ├── 0004009b
|   │   │   ├── 00010202
│   │   │   │   └── content
│   │   │   │   └── 00000000.app.romfs
│   │   │   └── 00010402
│   │   │   └── content
│   │   │   └── 00000000.app.romfs
│   │   └── 000400db
│   │   └── 00010302
│   │   └── content
│   │   └── 00000000.app.romfs
│   └── data
│   └── 00000000000000000000000000000000
│   └── sysdata
│   └── 00010017
│   └── 00000000
│   └── config (optional)
└── sysdata
└── shared_font.bin
```
### How to dump system archives and system font
The system archives (found at `nand/00000000000000000000000000000000`) and system font (found at `sysdata/shared_font.bin`) are required to play some games in Citra. Dumping these files is relatively simple.
#### Required tools
- A 3DS with [homebrew launcher](http://smealum.github.io/3ds/) access
- [3dsutils](https://github.com/citra-emu/3dsutils) - (There is no official precompiled version now, you can download [an unofficial build](https://cdn.discordapp.com/attachments/220742362740162560/222507077031952384/3dsutils-master.3dsx), or [install devkitPro](http://wiki.gbatemp.net/wiki/3DS_Homebrew_Development#Install_devkitPro_w.2F_devkitARM) and [compile it](http://wiki.gbatemp.net/wiki/3DS_Homebrew_Development#Compiling_sources) yourself)
- SD card reader (preferred), or a way to use wireless file transfer
### Instructions
1. Run 3dsutils via the homebrew launcher.
2. Press A when prompted to begin. First the shared font is dumped. Wait for the process to finish and press A again when prompted. The system archives will be dumped. Wait for the process to finish, then press A when prompted to be taken back to the homebrew launcher.
3. There will now be a `3dsutils` folder at the root of the 3DS's SD card. Inside that folder are two more folders, `nand` and `sysdata`. Transfer these folders to the `user` folder at Citra's root directory. The folders will merge with the existing `nand` and `sysdata` folders contained therein. If prompted to overwrite any files, say yes.
**Note: the section below is NOT required by most games! you can stop reading and try your games.**
----
### How to dump the Config Savegame
The Config Savegame (found at `nand/data/00000000000000000000000000000000/sysdata/00010017/00000000/config`) is required to play some specific games in Citra. If you don't dump it, a dummy `config` file is created (sufficient to play various games) but you will get an error similar to the one below if the game you are trying to play requires a dumped Config Savegame.
Service.CFG <Error> core/hle/service/cfg/cfg.cpp:GetConfigInfoBlock:197: Config block 0xB0001 with flags 2 and size 2048 was not found
#### Required Tools:
This procedure to dump the Config Savegame requires a 3DS able to run Decrypt9WIP. Instructions on modding a 3DS can be found [here](https://plailect.github.io/Guide/).
- [Decrypt9WIP](https://github.com/d0k3/Decrypt9WIP)
- 3DS system with 9.2.0-20 or lower, or arm9loaderhax
- SD card with enough space to hold the dump; 8GB or higher recommended
- SD card reader (preferred), or a way to use wireless file transfer
#### Instructions
1. Set up Decrypt9WIP using one of the various entry points. [Read its readme](https://github.com/d0k3/Decrypt9WIP#how-to-run-this--entry-points) on how to do this.
2. Create a folder at the root of the 3DS SD card called `files9`.
4. Put the SD card into the 3DS.
5. From the root Decrypt9 menu, choose `SysNAND Options`, then `Miscellaneous`, then `Dump Config (for Citra)`
The extracted `config` file is in `/files9/config` on your SD card. Copy this file to the computer you will be running Citra on, and paste it into `<Citra location>/user/nand/data/00000000000000000000000000000000/sysdata/00010017/00000000`. If you are asked if you wish to overwrite the file, say yes.
Moved to: [[User Directory]]