Installing the Game - BrianAllred/Unofficial-HDR-Troubleshooting-Wiki GitHub Wiki

Installing the Game

Installing HDR on modded Switches or emulators is very simple.

Switch

Note: I will not be covering how to mod your Switch in this guide. Please refer to the Homebrew Discord's official guide. I recommend setting up mods on SysCFW (or SysNAND or SysMMC, all names for the same thing). SysCFW allows you to play HDR online (with an NSO subscription) and carries no ban risk as long as you stick to private HDR arenas and use wifi-safe mods (and DO NOT install ANY NSP files, even ones you dumped yourself). People who need to setup mods on EmuCFW know who they are and can follow those instructions as necessary.

Before starting

Ensure your SD card is formatted as FAT32. You can verify this by sticking it into a Windows PC, right-clicking the drive, and clicking properties. If it says exFAT, then you need to reformat the drive with Hekate. This is covered here (TODO: make hekate reformat guide)

I also recommend not using FTP for this installation. I've personally seen issues when people use FTP. The homebrew USB transfer tools is also not recommended due to stability issues. The recommended file transfer methods are, in preferred order

  1. SD plugged into PC
  2. Hekate USB tools plugged into PC
  3. Hekate USB tools plugged into a different device

Installing

To begin with, do not use the HDR launcher in the HB app store. I'm not entirely sure why or how it's there, but it doesn't work.

  1. Download the switch-package.zip for either the latest beta or the latest prerelease
  2. Extract both folders inside the zip file to the root of your SD card, merging with the contents already there
  3. Boot the Switch and boot Smash Ultimate
  4. The HDR launcher should appear. Select Play

If you get stuck on a black screen, which is very common, then simply completely reboot the Switch. If you're still stuck on a black screen, then just wait. HDR pre-patches Ultimate before it loads, so the load speed is heavily dependent on the speed of your SD card. To facilitate faster load times, I heavily recommend installing Ultimate and any updates/DLC to the Switch system memory, if possible.

Emulator

Note: I will not be providing downloads or links to any emulators, firmware, anything. Nintendo has been very heavy-handed in dealing with Switch emulation, so the only thing provided by this wiki will be information.

Before starting

You'll need several things:

  • Your Ultimate base game dump (NSP recommended)
  • Your Ultimate game update dump (13.0.4 required)
  • (Optional) Your Ultimate game DLC dump(s)
  • title.keys and prod.keys files and firmware (17.0.1 recommended for Yuzu (and forks)) dumped from your Switch
    • Note that your key files must be from the same firmware version or newer, not older

After installation

You'll probably want to import a fully unlocked save

Yuzu (and Yuzu forks)

Basic setup

  1. Open your Yuzu folder (File -> Open Yuzu folder)
  2. Open the keys folder
  3. Copy your title.keys and prod.keys files into this folder
  4. Click Tools -> Install Firmware
  5. Select the firmware you dumped from your Switch
  6. Click File -> Install Files to NAND
  7. Select your Ultimate game update and DLC files (steps 6 and 7 can be repeated if files are located in different locations)
  8. Click Add New Game Directory
  9. Select the folder where your Ultimate base game file lives
  10. Launch Ultimate
  11. Close the game

Installing HDR

  1. Download the switch-package.zip for either the latest beta or the latest prerelease
  2. Open your Yuzu folder
  3. Open the sdmc folder
  4. Extract the two folders from the switch-package.zip into the sdmc folder
  5. Launch the game

Ryujinx

  • A recent (from the past two years or so) Ryujinx version older than or equal to 1.2.81 OR newer than or equal to 1.3.1 is required.

Basic setup

  1. Click File -> Open Ryujinx folder
  2. Open the system folder
  3. Copy your title.keys and prod.keys files into this folder
  4. Click Actions -> Install Firmware
  5. Navigate to the firmware you dumped and install it
  6. Click Options -> Settings
  7. Under Game Directories, click Add
  8. Navigate to the folder containing your base Ultimate game file
  9. Right click Ultimate in Ryujinx -> Manage Title Updates -> Add
  10. Navigate to your 13.0.3 update file, select it, and click Save
  11. (Optional) Right click Ultimate -> Manage DLC -> Add
  12. (Optional) Navigate to your dumped DLC files, select them, then click Save
  13. Launch the game
  14. Close the game

HDR setup

  1. Download the switch-package.zip for either the latest beta or the latest prerelease
  2. Click File -> Open Ryujinx folder
  3. Open the sdcard folder
  4. Extract the two folders from the switch-package.zip into this folder
  5. In Ryujinx, right click Smash -> create/edit custom configuration
  6. Go to CPU and uncheck both PPTC options
  7. Click Save and Close
  8. Right click Smash -> Cache Management -> purge PPTC cache
  9. Launch the game

The reason for disabling and purging PPTC is that, for reasons unknown, it causes bugs and crashes with HDR.

Issues

If you encounter any issues, see the appropriate troubleshooting page for your platform.

Post-Installation

Check out the post-installation page for recommendations.