Updated Frequently Asked Questions (markdown)

Frequently-Asked-Questions.md

@@ -1 +1,93 @@
-* ###  Where can I get Ryujinx?You can get the latest version from our website: https://ryujinx.org/download/
+* ###  Where can I get Ryujinx?<br>
+  You can get the latest version from our website: https://ryujinx.org/download/
+
+* ###  Do I need a switch to use this emulator?<br>
+  Yes, you need a hacked switch to dump games and your system keys.<br>
+  If you don't have a switch you can only run homebrew applications.
+
+* ### Where can I download <game>?<br>
+  We do not support piracy here. It is forbidden to request copyrighted content here (Firmwares/Games/Keys).
+
+* ### Does Ryujinx support <game>?<br>
+  Some games are untested or the tests are out of date you can find compatibility reports here: https://github.com/Ryujinx/Ryujinx-Games-List/issues <br>
+If you wish to contribute you can open a new issue if the game has never been added or you can add a comment on the games issue for it to be merged into the top post.
+
+* ### Are game mods currently supported in Ryujinx?<br>
+  Yes, see https://github.com/Ryujinx/Ryujinx/wiki/Ryujinx-Setup-&-Configuration-Guide#managing-mods for more details.
+
+* ### Is Vulkan currently supported in Ryujinx?<br>
+  Ryujinx is currently using OpenGL to send commands to the GPU. We would also like to support Vulkan in the future, however this is a big task that would require a major rewrite of the graphics system. There aren't any developers willing to invest the time in learning Vulkan in order to implement it at the moment, as there are other, more important features for them to spend time on.
+
+* ### Can I run Ryujinx on macOS?<br>
+  macOS support is currently very experimental. This is due to limited OpenGL support in macOS, which is something that is out of our control. When Vulkan is supported we may be able to make more progress here. For now, you are able to use Boot Camp to run the Windows version of Ryujinx.
+
+* ### Game run really slowly for me. What can I do to increase the FPS?<br>
+  Ryujinx is still in the early stages of development. Over time, new updates will gradually increase performance. For now, the biggest contributor to performance in Ryujinx is a fast, high clock-speed CPU. As for GPUs, a GTX 1050 or better should be perfectly adequate (at least in the long term) to play nearly any Nintendo Switch game.
+
+* ### What should I do if I'm having trouble with Ryujinx or found a bug?<br>
+  Provide a detailed explanation of the issue, tell us which build number you're using, and upload a Ryujinx.log file in the #support channel on our Discord. Someone will take a look and give you some pointers on what's going wrong. <br><br> If you've found a bug, please upload a screenshot and a save file, along with an explanation on how to reproduce the issue. This allows our developers to quickly look into bugs, without having to worry about how to reproduce them.
+
+* ### How can I support Ryujinx?<br>
+  There are many ways to support Ryujinx. You can support us through Patreon (https://www.patreon.com/ryujinx) or you can boost the Discord server with Discord Nitro. If you know how to help somebody in #support (on our Discord) you can help us by answering questions there.<br><br>If you are a developer there are Good First Issues listed on the Ryujinx GitHub (https://github.com/Ryujinx/Ryujinx/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).<br>
+We do encourage you talk to some devs in #development (on our Discord) before setting off so we can make sure you aren't conflicting in work with another user and so we can help you getting used to the code base and what needs to be done with various issue.
+
+* ### What should I do if Ryujinx is just showing a black screen?<br>
+  First, make sure that the game you are trying to run is actually supported and that your graphics card is capable of running it. Once you've done that, make sure that any external application that could affect the rendering is disabled. This includes things like the **MSI Afterburner** overlay, which puts an overlay on top of the emulator display window.
+
+* ### How can I dump games?<br>
+  A hacked Nintendo Switch is needed to dump games, which you can learn how to do here: https://nh-server.github.io/switch-guide/.<br>
+  Once you have hacked your Switch, you can dump your games to get an XCI or NSP file with this homebrew: https://github.com/DarkMatterCore/nxdumptool/releases
+
+* ### Can I extract data from a game using Ryujinx?<br>
+  Once you have set a games folder and your Switch keys properly, just right click on a game to extract the chosen section to a folder.
+
+* ### How do I install System Data Archives? Why are they needed?<br>
+  Some of our System Module implementations, such as time, require System Data Archives. You can get them by installing a Switch firmware from a game through our Firmware Installer, which can be found by clicking on the Install Firmware option in the Tools menu in the GUI.<br>
+Alternatively, you can install them manually by mounting your nand partition using `HacDiskMount` and copying the content to `Ryujinx/bis/system`.
+
+* ### Do I need to install shared fonts? Where I can get them?<br>
+  Extracted shared fonts will not be supported in the future. If you need them, just install a Switch firmware from a game through our Firmware Installer, which can be found by clicking on the `Install Firmware` option in the `Tools` menu in the GUI.
+
+* ### Where can I find a game's save files?<br>
+  Once you have set a games folder and your Switch keys properly, just right click on a game and select `Open Save Directory` or `Open Device Save Directory`.<br>
+You can then copy the save files in the opened folder and paste them somewhere else.
+
+* ### I'm getting a `SoundIOSharp.SoundIOException` error. What should I do?<br>
+  It's due to a bad implementation of our audio backend.<br>
+You can fix it by installing OpenAL, which can be found here: https://www.openal.org/downloads/oalinst.zip
+
+* ### I'm getting slow FPS, how can I increase it?<br>
+  If you have the Debug Logging options enabled in Ryujinx's settings, disable them **ONLY** if you can get the game working. Don't forget to set the VSync on. If your game is still slow, you need to get a better PC or wait for emulator optimizations.
+
+* ### I get the error Process initialization returned error `InvalidMemRange`. What should I do?<br>
+  It's a normal behavior, so you don't have to worry about it. It's just an internal error of the emulator.
+
+* ### My game is not looking good, and it's all glitched!<br>
+  If you have an Intel graphic card, this can happen, consider updating your GPU drivers.
+
+* ### I get the error "returned error PortRemoteClosed". What should I do?<br>
+  It's a normal behavior, so you don't have to worry about it. It's just an internal error of the emulator.
+
+* ### I have no idea what I'm doing. How do I Ryujinx?<br>
+  Follow the Ryujinx Setup & Configuration Guide: https://github.com/Ryujinx/Ryujinx/wiki/Ryujinx-Setup-&-Configuration-Guide or see the Readme: https://github.com/Ryujinx/Ryujinx/blob/master/README.md . If you are still having trouble, please come to #support on our Discord Server and we will be happy to assist.
+
+* ### Ryujinx crashes with an error about "NAX0 key derivation failed".<br>
+  Delete everything in `(your user folder)\appdata\roaming\ryujinx\sdcard\nintendo\save`
+
+* ### What is needed to use the new Multiplayer function?<br>
+  See the Multiplayer Guide here: https://github.com/Ryujinx/Ryujinx/wiki/Multiplayer-(LDN-Local-Wireless)-Guide and the New Horizons Renamer guide (only necessary if you still have the default player name/town name from our Patreon save file) here: https://github.com/Ryujinx/Ryujinx/wiki/How-to-Change-Your-Player-Name-and-Town-Name-with-Animal-Crossing:-New-Horizons-Renamer
+
+* ### Can I use Ryujinx in portable mode?<br>
+  Yes! See the portable mode quick reference guide here: https://github.com/Ryujinx/Ryujinx/wiki/Ryujinx-Setup-&-Configuration-Guide#portable-mode
+
+***
+
+* ### ACNH - I am stuck on the loading screen of the game!<br>
+  Either wait 10 minutes for the game to load, or restart the emulator and see if it gets fixed. If not, be sure you use the provided save file and that it's well extracted.<br>
+Read the Patreon post at: https://www.patreon.com/posts/animal-crossing-35196813 for more info!
+
+* ### ACNH - My save file won't work! How do I install a save file?<br>
+  Read the Patreon post at: https://www.patreon.com/posts/animal-crossing-35196813
+
+* ### ACNH - How can I rename my character when using a save file?<br>
+  You can't. If you want your own character name and town name, you can try starting the game without the provided save file, but as stated above, a softlock may occur.