Wiki/wiki-rtd/docs/wiki_bugs/known-issues.md

124 lines
7.5 KiB
Markdown

# Known issues
What follows is a list of known issues.
For a list of reported bugs please check here on github: [RetroDECK issues](https://github.com/XargonWan/RetroDECK/issues?q=is%3Aissue+is%3Aopen+label%3A%22Bug+%F0%9F%95%B7%EF%B8%8F%22)
## Emulator / Engine Issues
- `PPSSPP` Retroachievements is in the latest version, you can login / logout / enable hardcore mode normally from the emulators interface. It is right now not configurable in the Configurator (as it works a bit differently than the other emulators), we hope to have a solution for it later.
- `RetroArch: Gambatte` Quitting the core with the `Quit` radial function makes the core swap the palette while playing GB.
- `RetroArch` Borders are in some few cases disappearing in the latest RetroArch version. A workaround is to reset RetroArch from the Configurator.
- `OpenBOR` The standard implementation RetroDECK uses does not work, we are going to redesign it in a minor update.
- `Ryujinx` now cannot handle the symlinks correctly, our saves, firmware (nand) and keys folder are symlinked in retrodeck folders.
This means that Ryujinx don't recognize any keys and firmware as it cannot resolve the symlink, so the games are not starting.
In the time that we will set up a proper working and safe workaround this issue might be already fixed so is not worth investigating it further.
An user-sided workaround could be to replace the symlinks with actual folders but users should backup them as the next version (or an emulator reset) will remove the real folders and replace them with symlinks again, and in this case will erease all the saves, keys and firmware.
The manual work around, if wished, should be to replace:
- saves folder `bis` with `retrodeck/saves/switch/ryujinx/nand`
- `sdcard` with `retrodeck/saves/switch/ryujinx/sdcard`
- "firmware" folder `system` with `retrodeck/bios/switchch/keys`
- actual firmware folder `bis/system/Contents/` with `retrodeck/bios/switch/firmware`
However, keep in mind that RetroDECK Team will not assume any responsibility for data loss.
## External Controller issues
### Known Issues: External Controllers - Steam Deck
- Sometimes the emulators / engines gets confused on what controller is player 1 and takes the docked Steam Deck as player 1 and not the external controller. You can solve this by going into the Reorder Controllers interface in Steam and try switching between Player 1 or Player 2.
### Known Issues: External Controllers - Linux Desktop
Linux Desktop via Steam Input is complex. There are a lot of variables and the RetroDECK Team don't have the ability to test for all of them:
- What kind of packages are installed.
- What kind of drivers you have installed.
- What distro you are using.
- What desktop you are using.
- If you are running X11 or Wayland.
- If you have a Steam Deck based Distro with Valves "Game Mode".
We are trying to keep track of all the issues here and have reported several to Valve:
https://github.com/XargonWan/RetroDECK/issues/716
**Bug: Destop Profiles take preset over Game Profile**
Since the one of the recent Steam Client updates, there is a bug that causes Steam to take the Desktop Profile instead of the Game Profile. Sometimes it even takes both inputs and sends double inputs for every action.
Possible solutions by our users and team members:
- Try to turn off the RetroDECK's Steam Input: `Select RetroDECK in Steam` -> `Properties` -> `Controller` -> `Disable Steam Input`. Then go to `Steam` -> `Settings` -> `Controller` -> `Desktop Profile` and `Apply the RetroDECK Layout` under Templates for the controller you are using.
- Going into big picture and launching RetroDECK from there.
- Starting big picture, exiting big picture and then launching RetroDECK from the Desktop Client.
**Bug: Missing Radials in certain systems**
The radial menus on certain Linux Systems are hidden behind the game window or the Steam overlay (they still work and you can navigate them).
We thought about doing a temporary none radial profiles for each controller to get around this bug.<br>
But later changed our minds as we would have even more input configs to maintain, with a risk they become permanent.
### External Controller Issues - GZDOOM
GZDOOM have some kind of conflict with Steam Input in when more then one controller that causes input looping in menus. Make sure that the controller you are using is set as Player 1 else use Reorder Controllers interface in Steam to make it Player 1.
We are still investigation the cause of it, if you know of a solution please contact the RetroDECK Team.
## Hotkey Issues
**Not all Emulators has hotkey support; some have partial support; some has none and some has a majority implemented**
The plan is to map as much as we can into the RetroDECK Hotkey System below. We are also patching in Emulator Hotkeys with the `RetroDECK Framework` (if possible) to be compatible with the system. If an emulator later adds better hotkey support, we plan to map it towards the same functions for a unified experience across as many emulators as possible.
- `RPCS3` hotkeys/shortcuts do not work and they are a new experimental feature. To exit you must shut down RPCS3 from the `Switch Window` inside the Steam Deck interface or quit the application on Desktop.
- `CEMU` has almost no hotkey support.
- `XEMU` has no hotkey support.
## External Controller Issues - Steam Deck
- Sometimes the emulators / engines gets confused on what controller is player 1 and takes the docked Steam Deck as player 1 and not the external contrller. You can solve this by going into the Reorder Controllers interface in Steam and try switching between Player 1 or Player 2.
## External Controller Issues - Linux Desktop
Linux Desktop via Steam Input is complex. There are a lot of variables and the RetroDECK Team don't have the ability to test for all of them:
- What kind of packages are installed.
- What kind of drivers you have installed.
- What distro you are using.
- What desktop you are using.
- If you are running X11 or Wayland.
- If you have a Steam Deck based Distro with Valves "Game Mode".
We are trying to keep track of all the issues here and have reported several to Valve:
https://github.com/XargonWan/RetroDECK/issues/716
**Bug: Destop Profiles take preset over Game Profile**
Since the one of the recent Steam Client updates, there is a bug that causes Steam to take the Desktop Profile instead of the Game Profile. Sometimes it even takes both inputs and sends double inputs for every action.
Possible solutions by our users and team members:
- Try and use the RetroDECK Profile as the Desktop Profile and turning off the Game Profile.
- Going into big picture and launching RetroDECK from there.
- Starting big picture, exiting big picture and then launching RetroDECK from the Desktop Client.
**Bug: Missing Radials in certain systems**
The radial menus on certain Linux Systems are hidden behind the game window or the Steam overlay (they still work and you can navigate them).
We thought about doing a temporary none radial profiles for each controller to get around this bug.<br>
But later changed our minds as we would have even more input configs to maintain, with a risk they become permanent.
## External Controller Issues - GZDOOM
GZDOOM have some kind of conflict with Steam Input in when more then one controller that causes input looping in menus. Make sure that the controller you are using is set as Player 1 else use Reorder Controllers interface in Steam to make it Player 1.
We are still investigation the cause of it, if you know of a solution please contact the RetroDECK Team.