Switch ‐ Common Issues - BrianAllred/Unofficial-HDR-Troubleshooting-Wiki GitHub Wiki
Common Issues on the Switch
This page will cover some of the more common issues and their solutions for people playing on Switch consoles.
I installed the game, launched it, and it's stuck on a black screen
Solution
Reboot the switch. Remove it from the dock, hold the power button for a few seconds, and tap Power Options -> Restart.
Explanation
HDR uses a custom HID (input) system module that causes the game to freeze on first boot. This is known and expected.
Moves and characters don't have any effects
Solution
Update or remove One Slot Effects.
Explanation
One Slot Effects is required for certain skin mods to show their effects correctly. However, it's been updated several times recently, and old versions will cause the game to not render any effects at all.
I get a mod conflict error when launching the game
Solution
Arcropolis generated a file at sd:/ultimate/arcropolis/conflicts.json
. Look at the file using Notepad or any other text editor. You'll see something like
{
"stage/training/normal/model/training_figures_set/model.numshexb": [
"sd:/ultimate/mods/hdr-stages",
"sd:/ultimate/mods/green screen"
],
"stage/training/normal/model/training_base_set/training_grid_01_con.nutexb": [
"sd:/ultimate/mods/hdr-stages",
"sd:/ultimate/mods/green screen"
]
}
Generally, you almost always want to delete files out of the non-HDR folders. Very rarely, you may need to delete something out of an HDR folder, but you should probably ask in the Discord first.
In order to solve this particular issue, I would either
- Delete the
green screen
mod, or - navigate to
sd:/ultimate/mods/green screen
and delete the two conflicting files from there.
Explanation
Arcropolis mods Ultimate using file replacement. So when two mods replace the same file and the conflict is not resolved, Arcropolis gets confused and will load one of them at random. To prevent this, Arcropolis generates a conflicts file that lists every file that conflicts and the parent mod folders that both contain this file.
Arcropolis's conflict examination is naive, though, so depending on how many conflicts you have, you may have to repeat this process multiple times.
I get a skyline panic with error: Result code 514
Solution
You're missing the sd:/ultimate/stage-alts
folder. Do a fresh installation of HDR (see Installing the Game, making sure to download the game from one of the release repositories, not the code repository.
Explanation
This is a very common issue when people download HDR from the main code repo, as releases from that repository contain only the compiled code, not any of the required assets. All assets are required when installing HDR, so make sure to download from one of the two release repositories.
My game crashes when I start a match
Solution
There are a few potential solutions here.
- Delete
libsmashline_hook.nro
fromsd:/atmosphere/contents/01006A800016E000/romfs/skyline/plugins/
. - Delete
libparam_config.nro
fromsd:/atmosphere/contents/01006A800016E000/romfs/skyline/plugins/
.
Explanation
libsmashline_hook.nro
is from older versions of HDR. This plugin still existing in your folder means you attempted to update HDR by downloading a new release instead of using the launcher.libparam_config.nro
is used by various moveset and character mods, as well as the CSK collection of mods. Unfortunately, this plugin hooks the same game functions as HDR, and is therefore completely incompatible with HDR, which also means moveset and character mods, as well as most of the CSK collection, are also incompatible with HDR.
My game behaves oddly, and I just updated HDR and/or added and/or removed non-HDR mods
Solution
Odd behavior is usually caused by one of two things.
- A corrupt/outdated Arcropolis cache.
- Conflicting skin mods (that for some reason don't trigger Arcropolis conflict generation).
To solve these issues:
- Delete
sd:/ultimate/arcropolis/cache
- Delete any skin mod(s) for the problematic character(s) where you've already had to resolve conflicts before
Explanation
- For some reason, every now and then, seemingly randomly, Arcropolis's mod cache will corrupt or become outdated when mods change, leading to undefined and odd behavior. Deleting the cache folder will force Arcropolis to regenerate the cache based on the currently mods in the mods folder.
- For some other reason, Arcropolis won't generate a conflict file for certain multi-slot skins that conflict with HDR, but only for certain slots. So if you have a multi-slot skin for Joker, and Arcropolis said it had a conflict on the down-tilt animation, it probably only listed that conflict for slot 1. You now either have to go delete the down-tilt animation from all the other slots or just delete the skin mod entirely.