From 992504abae301827a7dd4ee7faea498a1c2116fe Mon Sep 17 00:00:00 2001 From: MetrosexualGarbodor <79612681+MetrosexualGarbodor@users.noreply.github.com> Date: Sat, 2 Mar 2024 13:44:59 +0000 Subject: [PATCH] Updated FAQ and Troubleshooting (markdown) --- FAQ-and-Troubleshooting.md | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/FAQ-and-Troubleshooting.md b/FAQ-and-Troubleshooting.md index 16affea..b596329 100644 --- a/FAQ-and-Troubleshooting.md +++ b/FAQ-and-Troubleshooting.md @@ -145,20 +145,17 @@ Open the .txt file and add your cheats into it. Afterwards, right click the game - `F9` toggles docked/handheld mode. - `F11`/`Alt+Enter` toggles fullscreen. -There are also hotkeys for increasing and decreasing resolution scaling, and increasing and decreasing sound volume, but they are unbound by default. Most of these are exposed and configurable in the new Avalonia UI, and there's an [open pull request](https://github.com/Ryujinx/Ryujinx/pull/4503) to add the remaining ones. +There are also hotkeys for increasing and decreasing resolution scaling, and increasing and decreasing sound volume, but they are unbound by default. Most of these are exposed and configurable in the Avalonia UI, and there's an [open pull request](https://github.com/Ryujinx/Ryujinx/pull/4503) to add the remaining ones. ### **__• What is Avalonia?__** Avalonia is a user interface framework. We have been developing a new Avalonia-based UI for quite some time now, and we plan to completely replace the current one with it once it’s mature enough. ### **__• Where can I try this Avalonia thing?__** -https://github.com/Ryujinx/release-channel-master/releases Under `Assets`, pick the `test-ava-ryujinx` for your operating system, download, extract and run. +As of 1.1.1217, Avalonia has become the default UI. ### **__• Does Avalonia autoupdate?__** Yes. -### **__• This Avalonia UI seems pretty solid, why isn’t it the default?__** -There are several problems with it and we’d prefer to make it where there’s not a single reason to still use the old one before making it the default. While not all of them are listed here, this discussion keeps track of the issues it has: https://github.com/Ryujinx/Ryujinx/issues/3662 - ### **__• How do I report a bug?__** If you've found a bug, please first make sure it's not been reported on the [main issue tracker](https://github.com/Ryujinx/Ryujinx/issues) or on the [game compatibility list](https://github.com/Ryujinx/Ryujinx-Games-List/issues). Then post a comment in the game's compatibility entry with a screenshot, a log 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. @@ -280,8 +277,6 @@ There are many ways to support or contribute to Ryujinx. You can support us thro If you are a developer, there are [Good First Issues](https://github.com/Ryujinx/Ryujinx/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) listed on our issue tracker. We do encourage you to talk to some devs in our Discord’s development channel before setting off, so we can confirm your work isn't conflicting with another user's, and so we can help you get used to the codebase and what needs to be done with various issues. -If you would like to make UI changes, please focus your efforts on the new Avalonia UI first instead of the current GTK one, as Avalonia is what will be supported moving forward. - ## **Common Errors and Troubleshooting** @@ -293,6 +288,8 @@ Most of the errors below will be displayed on the console or log files. To view ![image](https://user-images.githubusercontent.com/79612681/232947552-2c7a66e9-3e4b-4714-bc1c-b2cdeeb86ac8.png) ### • Can’t open Ryujinx: `|E| Application : Unhandled exception caught: System.TypeInitializationException: The type initializer for 'Gtk.Application' threw an exception. ---> System.DllNotFoundException: Gtk: libgtk-3-0.dll, libgtk-3.so.0, libgtk-3.0.dylib, gtk-3.dll` +This error is specific to the old GTK UI. As of 1.1.1217, Avalonia has become the default, so please redownload Ryujinx if possible. If you're on an old, unsupported version: + Some emulator files are missing. Redownload Ryujinx, make sure it’s extracted properly and don’t put it on the desktop or the root of a drive, as those are protected folders. Third party antivirus software can also randomly delete these files, so if you have one, make exceptions for Ryujinx or uninstall the antivirus. ### • Can’t open Ryujinx: `|E| Application : Unhandled exception caught: GLib.GException: Unrecognized image file format at Gdk.PixbufLoader.Write(Byte[] buf, UInt64 count)` @@ -323,7 +320,8 @@ Similar to the issue above, the emulator cannot detect a graphics card with Vulk Similar to the issue above, the emulator cannot detect a graphics card with Vulkan support. Check that your GPU drivers are on the latest possible version, and if they are, then unfortunately your GPU doesn’t meet minimum requirements. ### • Crashing after double-clicking any game with `(Ryujinx:18152): Gtk-CRITICAL **: 00:44:23.202: gtk_list_store_get_value: assertion 'iter_is_valid (iter, list_store)' failed 00:00:00.058 |I| Gpu : Backend Threading (Auto): True Marshaling row-activated signal 00:00:00.265 |E| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.NullReferenceException: Object reference not set to an instance of an object. at Ryujinx.Ui.MainWindow.LoadApplication(String path, Boolean startFullscreen) in D:\a\Ryujinx\Ryujinx\Ryujinx\Ui\MainWindow.cs:line 718` -If the error looks like this, click the game once then press `Enter` or [use the Avalonia UI](https://github.com/Ryujinx/Ryujinx/wiki/FAQ-and-Troubleshooting#-where-can-i-try-this-avalonia-thing). This is a bug specific to the current GTK UI. +This error is specific to the old GTK UI. As of 1.1.1217, Avalonia has become the default, so please redownload or update Ryujinx if possible. If you're on an old, unsupported version: +If the error looks like this, click the game once then press `Enter` or use the Avalonia UI. ![image5](https://user-images.githubusercontent.com/79612681/232948327-0bf8e054-b9c2-4b4f-9c96-27177d7e0b2a.png)