mirror of
https://github.com/yuzu-emu/yuzu-emu.github.io.git
synced 2025-06-08 13:27:25 +00:00
5.4 KiB
5.4 KiB
yuzu Quickstart Guide
To start playing games, yuzu needs a couple of different files and directoires from your switch in order to play them properly.
This guide will help you copy all of your system files, games, updates, and DLC from your switch to your computer and organize them in a format yuzu understands. This process should take about an hour to an hour and a half.
Prerequisites
- A Nintendo Switch vulnerable to fusee-gelee
- An SD card with at least ~29 GB of free space (an almost empy 32GB card will work)
- biskeydump
- hekate
- Joiner Scripts
- HacDiskMount
You will also need to know how to run RCM payloads on your switch, which is detailed here, except in that guide when it says to use hekate's bin use the one required by that step in this guide.
%YUZU_DIR%
is the home directory for yuzu on your computer:
- For Windows, this is C:\Users\<YourUserName>\AppData\Roaming\yuzu
- For Linux, this is ~/.local/share/yuzu
Directions
- Download this keys template. It will help make sure you don't miss anything in the next steps.
- Launch biskeydump on your switch using RCM (Follow the guide in prerequisites but replace the hekate bin with biskeydump.bin). If the background of the QR code is red, retry until it is blue. You can scan the QR code for convenience or copy the codes by typing them into your computer. Copy the keys template from step 1 into
%YUZU_DIR%/keys
and make sure it is still namedconsole.keys
. In it, replace the largeXXXX...XXX
strings with the corresponding key from biskeydump. You should have copied:tsec_key
bis_key_0_crypt
bis_key_0_tweak
bis_key_1_crypt
bis_key_1_tweak
bis_key_2_crypt
bis_key_2_tweak
- Launch hekate on your switch using RCM (Follow the guide in prerequisites exactly, using hekate's bin).
- 3a. Go to the tools menu and select
Tools > Dump package1
. Once that is complete selectTools > Backup > Dump eMMC BOOT
. Then selectConsole > Dump fuses
. Finally selectTools > Backup > Dump eMMC GPP
. This last one will take 20-40 minutes depending on your sd card. Go get a latte and come back then. - 3b. Open your sd card on your computer side by side with
%YUZU_DIR%/sysdata
- 3c. Copy the following files from your sd card into
sysdata
:fuse.bin
- 3d. Open the folder called backup on your sd card and then open the first directory in that. Copy the following files from that directory into
sysdata
:BOOT0
pkg1/secmon.bin
pkg1/pkg1_decr.bin
- 3d. Copy all of the files starting with
rawnand.bin.
and ending in a two-digit number to a folder somewhere on your computer.
- 3a. Go to the tools menu and select
- Select all of the rawnand.bin files from step 3d and drag them onto the joiner script downloaded earlier. This should take some time depending on you system, but you will be left with a single
rawnand.bin
. You can delete any of the files ending in two-digits at this point. - Open HacDiskMount and go to File > Open and select the rawnand.bin from step 4.
- 5a. Double-click on the row marked
PRODINFO
. Under the export to file area, click browse and locate your yuzu sysdata dir (%YUZU_DIR%/sysdata
). Save the file asPRODINFO.bin
. Click start and wait for it to complete. Then close the dialog. (NOTE: There is no need to enter any keys in the boxes at the top of the dialog at this moment.) - 5b. Repeat step 5a with the row named
BCPKG2-1-Normal-Main
. Save it into the same directory with the nameBCPKG2-1-Normal-Main.bin
. Again, no keys are necessary at this point. - 5c. Double-click on the row named
SYSTEM
. In the keys boxes, enterbis_key2_crypt
in the top one andbis_key2_tweak
in the bottom one and click test. If the text is red, double check your keys. Click onInstall Driver
and then clickMount
. The application may become unresponsive for a moment. In the new drive (default Z:), there will be a couple of folders with some namedContents
,save
, andsaveMeta
. Copy all of these into%YUZU_DIR%/nand/system
. - 5d. Repeat step 5c with the row named
USER
. Enter the same key. This time you should not have to install the driver again. Once this mounts, copy theContents
andsave
folders to%YUZU_DIR%/nand/user
.
- 5a. Double-click on the row marked
- (OPTIONAL) If you have games or game data stored on your sd card, copy the
Nintendo
folder of your sd card into%YUZU_DIR%/sdmc
. - Open yuzu. You should see a dialog with a progress bar informing you that your keys are being derived. If you get a missing file error message, double check the files in your
sysdata
dir and try again. If there is no errors, a message informing you that it was successful will show and then yuzu will refresh to show you your games.
If you need any help during this process or get a strange error during or while using yuzu, feel free to ask for help on the yuzu discord! Happy Emulating!
Notes
- Should you need to re-run this process (in the event of a firmware update or new games), you can simply update the sysdata files and then go to
Help > Reinitialize keys...
.