mirror of
https://github.com/yuzu-emu/yuzu-emu.github.io.git
synced 2025-06-08 13:27:25 +00:00
8 KiB
8 KiB
title | description |
---|---|
Quickstart Guide | A guide designed to get you started with yuzu quickly. |
yuzu Quickstart Guide
To start playing games, yuzu needs a couple of different files and directories 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 (purchased before July 2018 will definitely work, purchased after has a lower probability of working)
- An SD card with at least ~29 GB of free space (an almost empty 32GB card will work)
- biskeydump
- hekate
- Copy Script
- HacDiskMount
- TegraRcmSmash
- Zadig
- microSD Card Reader -- If your computer has one built-in, you can use thatm
- RCM Jig -- we highly recommend this one, but you could use any of the methods outlined here
%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 this sub-guide using the biskeydump.bin file you downloaded earlier. 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. Our testing has found that QRDroid doesn't work properly but QR Code Reader by Kaspersky Lab does. 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 this sub-guide except using the hekate_ctcaer_3.2.bin file you downloaded earlier. Navigate hekate using volume up and down to go up and down and power to select.
- 3a. Select
Console info
and thenPrint fuse info
. It should print out some data onto your screen and then sayPress power to dump to SD card
. Press power and it should now sayDone
andPress volume to go to menu
. Press a volume button and then select back in the menu. - 3b. Select
Tools
and then selectDump package1/2
. After it finishes, it should sayDone press any key
near the bottom. Press any key to return to the tools menu. - 3c. Select
Backup
and then selectBackup eMMC BOOT0/1
. After it finished filling the progress bar it should sayFinished and verified press any key
. Press any key to return to the backup menu. - 3d. Finally, select
Backup eMMC Raw GPP
. This should take some time as your switch's nand is quite large. If the progress bar appears to go backwards at some points or turn green, do not worry as this is hekate verifying the data. This should take between 40-80 minutes depending on the quality of your SD card. - 3e. Make sure you power off your switch to avoid damage to your sd card, then open your sd card on your computer. Find the
yuzu_copy.bat
file you downloaded earlier and copy it to the root of your sd card. Double-click it to start the copy. This should take between 10-20 minutes. It should not have any errors listed. If it does, double check and make sure you ran steps 3a-3d correctly.
- 3a. Select
- Open HacDiskMount as Administrator (Right-click and select Run As Administrator) and go to
File > Open file
and select the rawnand.bin that was copied to your Desktop in step 3e.- 4a. Double-click on the row marked
PRODINFO
. Under the export to file area, click browse and pick somewhere easy to get to, like your Desktop. Dump 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.) - 4b. Select the row named
BCPKG2-1-Normal-Main
. Dump it into the same directory you used last step with the nameBCPKG2-1-Normal-Main.bin
using theDump to file
button. Again, no keys are necessary at this point. After it finishes, close the dialog - 4c. Copy the
PRODINFO.bin
andBCPKG2-1-Normal-Main
files to the%YUZU_DIR%/sysdata
dir. - 4d. 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
and wait until it says driver, 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
andsave
. Copy all of these into%YUZU_DIR%/nand/system
. After this is done, clickUnmount
and close the dialog. - 4e. Double-click on the row named
USER
. Enter the same key. ClickMount
, and the tool may become unresponsive again. Once this mounts, open the new drive (usually Z:) and copy theContents
andsave
folders to%YUZU_DIR%/nand/user
. After, clickUnmount
and close the dialog and then the program.
- 4a. 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.
RCM
- If you have already used this guide once, skip to step 6.
- Extract the RCMSmasher zip file you downloaded in the prerequisites. Put the bin file from the step that redirected you here in the same folder.
- Plug your switch into your computer
- Download and Open Zadig (prerequisites) and choose APX in the device list. If APX does not show, go to the Options menu and check List all devices. If it still doesn't appear, double check the connection the between the switch and your computer.
- For Driver type, cycle the arrows until it says libusbK (v3.0.7.0). This is very important.
- Hit install driver.
- Power off your switch while it is still connected to your computer.
- Insert your RCM jig into the right joy-con slot and then press VOL+ and Power at the same time. Nothing should happen. If the switch starts to turn on normally, go back to step 6 and try again.
- Drag and drop the bin file from step 1 of this guide onto the RCMSmasher.exe program. It should not stay open and your switch should now display some text on it. If it did not, make sure you have carefully followed all of the previous steps and try again.
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...
.