0
0
Fork 0
mirror of https://github.com/GreemDev/Ryujinx.git synced 2024-11-22 10:58:35 +00:00

Replaced all gtk screenshots with ava screenshots and added various missing changes from 1.2.0 onwards.

GabCoolGuy 2024-10-27 19:52:32 +01:00
parent 411786503d
commit cf16a8e122

@ -116,15 +116,17 @@ By default Ryujinx will use `%appdata%/Ryujinx` (or the equivalent application d
double-click on *Ryujinx.exe*. This will launch the emulator and you double-click on *Ryujinx.exe*. This will launch the emulator and you
will be met with the following message (don't worry; this is will be met with the following message (don't worry; this is
normal!) normal!)
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/8581e188-2ac7-479f-ab49-f72034d4071e)
3. Click *OK* on the warning box.\ ![image](https://github.com/user-attachments/assets/bbcd3060-ae1f-4921-a328-a38c44ffdb44)
3. Click *Run anyway* on the warning box.
Now that *Ryujinx* has been launched, the proper folders have been Now that *Ryujinx* has been launched, the proper folders have been
created for you in your %appdata% folder. created for you in your %appdata% folder.
4. Click *File* at the top left of the *Ryujinx* window, and then click 4. Click *File* at the top left of the *Ryujinx* window, and then click
*Open Ryujinx* *Folder*.\ *Open Ryujinx* *Folder*.
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/955c55d0-4084-4239-ad23-d8b1fc5414f8)
![image](https://github.com/user-attachments/assets/a9cab6ef-12eb-4efa-81d1-67c7c17e1640)
5. Navigate down into the system subfolder and paste your prod.keys file 5. Navigate down into the system subfolder and paste your prod.keys file
@ -133,7 +135,8 @@ By default Ryujinx will use `%appdata%/Ryujinx` (or the equivalent application d
![image](https://user-images.githubusercontent.com/62343878/86277827-9d7d2600-bb94-11ea-9900-b5351364fd14.png) ![image](https://user-images.githubusercontent.com/62343878/86277827-9d7d2600-bb94-11ea-9900-b5351364fd14.png)
6. Close and reopen *Ryujinx* so that the prod.keys file is validated.\ 6. Close and reopen *Ryujinx* so that the prod.keys file is validated.\
You're done installing keys!
You're done installing keys!
Initial Setup Continued - Installation of Firmware Initial Setup Continued - Installation of Firmware
================================================== ==================================================
@ -146,32 +149,29 @@ dumped, or have compiled your [dumped firmware](https://github.com/Ryujinx/Ryuji
you still get the warning, go back through the prod.keys steps and you still get the warning, go back through the prod.keys steps and
ensure you have placed the file correctly. ensure you have placed the file correctly.
2. Now that *Ryujinx* is open, click *Tools \> Firmware \> Install from 2. Now that *Ryujinx* is open, click *Tools \> Install Firmware \> Install from
XCI/ZIP*\ XCI/ZIP*\
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/405afd16-9e0a-4911-a82f-575dc8939e36)\ ![image](https://github.com/user-attachments/assets/8c993f94-7620-4188-93cf-a29aff951070)
This brings up the "Choose the firmware file to open" window.\
\
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/fc03f9eb-1210-41be-ab7b-b9ee4f1fce98)
3. Using the *Ryujinx* window, navigate to the location of your dumped 3. This will bring up your OS's File Explorer, navigate to the location of your dumped
XCI file and click *Open*. You will be asked to confirm whether you XCI file and click *Open*. You will be asked to confirm whether you
want to install the firmware. Make sure your prod.keys are at least want to install the firmware. Make sure your prod.keys are at least
as new as the firmware you are installing!\ as new as the firmware you are installing!\
(Your firmware version number may vary)\ (Your firmware version number may vary)\
\ \
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/804c398c-3b2b-446f-aabd-8e7129bec19e) ![image](https://github.com/user-attachments/assets/344502bc-c409-4f10-92a0-ea45ba01e045)
4. Click *Yes*. You will see a message that the firmware is 4. Click *Yes*. You will see a message that the firmware is
installing and was successfully installed:\ installing and was successfully installed:\
![image](https://github.com/Ryujinx/Ryujinx/assets/44103205/155c02c5-dd0d-4888-a94b-23eabff84821) ![image](https://github.com/user-attachments/assets/d0079dce-b65e-44a5-bd9e-632055433b2b)
5. Click *OK*. If all went well, you will now see your firmware version 5. Click *OK*. If all went well, you will now see your firmware version
listed as the "System Version" in the bottom right hand corner of listed as the "System Version" in the bottom right hand corner of
the main *Ryujinx* window.\ the main *Ryujinx* window.\
![image](https://user-images.githubusercontent.com/62343878/86278217-4035a480-bb95-11ea-9803-fabc39dbec5b.png) ![image](https://github.com/user-attachments/assets/5a037460-b039-434a-8897-8102cc138e9c)
Adding Your Games to Ryujinx Adding Your Games to Ryujinx
============================ ============================
@ -179,30 +179,33 @@ Adding Your Games to Ryujinx
You have keys and firmware ready to go. Time to add your games! You have keys and firmware ready to go. Time to add your games!
With *Ryujinx* open, click on *Options \> Settings*. This takes you With *Ryujinx* open, click on *Options \> Settings*. This takes you
straight to the *General* tab.\ straight to the *User Interface* tab.\
![image](https://user-images.githubusercontent.com/62343878/86278362-7c690500-bb95-11ea-9667-cb61e7d45b8e.png) ![image](https://github.com/user-attachments/assets/69cda4d4-c9c6-4608-bc17-dc31bc8051ae)
There are two different methods in which you can add a Game Directory in this window.\ There are two different methods in which you can add a Game Directory in this window.\
\ \
**1st Method:**\ **1st Method:**\
Type the absolute path of the folder containing your games into the path Type the absolute path of the folder containing your games into the path
field and click *Add*.\ field and click *Add*.\
![image](https://user-images.githubusercontent.com/62343878/86278453-a6bac280-bb95-11ea-8bb0-005e89dbb295.png)\ ![image](https://github.com/user-attachments/assets/8a35b38f-a077-491e-9753-805d43dd0bf3)
\ \
**2nd Method:**\ **2nd Method:**\
Without typing anything into the path field, click *Add*.\ Without typing anything into the path field, click *Add*.\
![image](https://user-images.githubusercontent.com/62343878/86278489-b76b3880-bb95-11ea-929c-da8b53052406.png)\ ![image](https://github.com/user-attachments/assets/ac87e4db-e1f1-4d95-bb3c-763b5b20d769)
\ \
This brings up the navigation window. Navigate to the folder containing This brings up your OS's navigation window. Navigate to the folder containing
your games (e.g. D:\\Switch Games) and click *Add*.\ your games (e.g. D:\\Switch Games) and click *Add*.\
![image](https://user-images.githubusercontent.com/62343878/86278572-d5d13400-bb95-11ea-98e6-91a58667a538.png) ![image](https://github.com/user-attachments/assets/3eef0f83-e447-4e50-bf4c-ddbe8f07d90c)
1. Whichever method you chose, **click *Save*** to save the game 1. Whichever method you chose, **click *Save*** to save the game
directory setting. directory setting.
2. Your games will now show up in the main *Ryujinx* window.\ 2. Your games will now show up in the main *Ryujinx* window.\
![image](https://user-images.githubusercontent.com/62343878/86278608-e7b2d700-bb95-11ea-8b2c-f12b1b7f0fcc.png) ![Capture d'écran 2024-10-26 142013](https://github.com/user-attachments/assets/17de16e0-1370-48a9-a6ef-605c598f13be)
Managing Game Updates Managing Game Updates
===================== =====================
@ -213,113 +216,183 @@ Now that your games are added, you may wish to update your game for
various reasons e.g. bugfixes, new content, etc. *Ryujinx* has built-in various reasons e.g. bugfixes, new content, etc. *Ryujinx* has built-in
functionality to manage which version of the game you want to play. functionality to manage which version of the game you want to play.
1. In the main *Ryujinx* game list right-click the game you want to ## Autoadd Game Updates
apply an update to. Then click *Manage Title Updates*.\
![image](https://user-images.githubusercontent.com/62343878/86278648-fef1c480-bb95-11ea-8a28-6099f5e0c8bf.png)\ Since version 1.2.0, *Ryujinx* supports automatically adding and assigning game updates.
1. Go to **Options > Settings**\
![image](https://github.com/user-attachments/assets/cae3284c-5807-4e32-b813-efd107c581ba)
2. Scroll down until you see **"Autoadd DLC/Game Updates"**.\
![image](https://github.com/user-attachments/assets/3cc9ed12-32ce-440e-84b9-7f554cf9fdfc)
From there, simply add the directories where your Game Updates are located by following Method 1 or Method 2 from [Adding Your Games to Ryujinx](#adding-your-games-to-ryujinx).
If you add multiple updates in one go with this method, *Ryujinx* will automatically choose the highest version.
## Managing Game Updates
1. In the main *Ryujinx* game list, right-click the game you want to manage Game Updates for.
Then click **Manage Title Updates**.\
![image](https://github.com/user-attachments/assets/b1cb84de-41aa-4658-a21c-d1d97e72914c)\
\ \
After clicking *Manage Title Updates*, you will see the *Ryujinx -- After clicking *Manage Title Updates*, you will see the *Ryujinx -
Title Update Manager* menu. Title Update Manager* menu.
2. In the *Ryujinx -- Title Update Manager* menu, click *Add*.\ If you want to add a game update file, go to step 2.
![image](https://user-images.githubusercontent.com/62343878/86278688-0d3fe080-bb96-11ea-8aae-f353f2dc952d.png)
3. Clicking *Add* will bring up the navigation menu. Navigate to the If you **do not** want to add a game update file, go to step 4.
location of your game's update files and select update you want to
add to *Ryujinx*, and click *Add*.\
![image](https://user-images.githubusercontent.com/62343878/86278723-16c94880-bb96-11ea-972f-bb1c8683ed6d.png)\
This will bring you back to the *Ryujinx -- Title Update Manager*
window. You may repeat this for any other game version update files
you wish to add to *Ryujinx*.
4. In the *Ryujinx -- Title Update Manager* window, select the version 2. Click **Add**\
of the update you wish to be applied to the game and click *Save*.\ ![image](https://github.com/user-attachments/assets/00806fa9-3c7d-4c12-b870-f78425777b21)
![image](https://user-images.githubusercontent.com/62343878/86278755-22b50a80-bb96-11ea-9c1c-c4fc13a0e4cb.png)
5. Verify that the proper version number is shown in the main *Ryujinx* 3. This will bring up your OS's File Explorer.
games list window.\ From there, navigate to the location of your game's update files,
![image](https://user-images.githubusercontent.com/62343878/86278789-2e083600-bb96-11ea-9b55-816a81b53601.png)\ select which one you want to Add and click on **Open**.\
\ ![image](https://github.com/user-attachments/assets/f09cead4-8556-4438-947c-6e73d8f10ccb)\
Your game update has now been applied, and you may repeat the You may repeat this for any other game update files you want to add.
process for any other games you wish to apply updates to.
4. Select the version of the update you want to
be applied by clicking on it and click **Save**.\
![image](https://github.com/user-attachments/assets/2ecc3b78-78fd-44fd-abea-67016f9ec3ab)
Your game update should now be applied,
you may repeat the process for any other
games you wish to apply updates to.
Managing DLC Managing DLC
============ ============
Manage Downloadable Content for your games Manage Downloadable Content for your games
Some games have downloadable content available that you may wish to add Now that your games and game updates are added,
to your game. *Ryujinx* has built-in functionality to add & manage your you may wish to add DLC to your game.
DLC. *Ryujinx* has built-in functionality to manage your DLC.
1. With *Ryujinx* open, right-click on the game you want to add or ## Autoadd DLC
manage DLC for and click *Manage DLC* to bring up the *Ryujinx - DLC
Manager* window.\
![image](https://user-images.githubusercontent.com/62343878/86278819-37919e00-bb96-11ea-93cb-0a266c0c1b24.png)
2. Within the *Ryujinx -- DLC Manager* window, click *Add* to open the Since 1.2.0, *Ryujinx* supports automatically adding and assigning DLC.
DLC navigation screen.\
![image](https://user-images.githubusercontent.com/62343878/86278847-40826f80-bb96-11ea-99bf-05c22af2c680.png)
3. Navigate to the location of the DLC file(s) you wish to apply, then 1. Go to **Options > Settings**\
double-click the file to automatically add it. Or you may select the ![image](https://github.com/user-attachments/assets/15a1307f-eaa6-460b-b75c-b54923268777)
file or files, and click *Add*.\
**Note: you may add more than one DLC file at a time!**\
![image](https://user-images.githubusercontent.com/62343878/86278879-5001b880-bb96-11ea-9fb3-859efbd631f9.png)
4. You will now see your DLC in the *Ryujinx - DLC Manager* window. 2. Scroll down until you see **"Autoadd DLC/Game Updates"**.\
**Click *Save*** to save your configuration.\ ![image](https://github.com/user-attachments/assets/3cc9ed12-32ce-440e-84b9-7f554cf9fdfc)
![image](https://user-images.githubusercontent.com/62343878/86286616-08822900-bba4-11ea-838e-eaf95c98d6dc.png)\
\
**Note: always drill down to see the proper status of the DLC .nca file you are managing. Checking and unchecking the .nca file is the way to enable and disable the DLC. The parent container (.nsp file) shows unchecked by default, even if the DLC is enabled.**
From there, simply add the directories where your Game Updates
are located by following Method 1 or Method 2 from
[Adding Your Games to Ryujinx](#adding-your-games-to-ryujinx).
If you add multiple DLCs in one go with this method,
*Ryujinx* will automatically enable every DLC for each game.
## Managing DLC
Managing Downloadable Content includes,
removing, adding and selecting which DLC you want.
1. In the main *Ryujinx* game list,
right-click the game you want to manage
Game Updates for. Then click **Manage DLC**.\
![image](https://github.com/user-attachments/assets/9aa885b5-bc6b-45bf-9f30-52246cb4ef88)
If you want to add a game update file, go to step 2.
If you **do not** want to add a game update file, go to step 4.
2. Click **Add**\
![image](https://github.com/user-attachments/assets/f839795f-d1a5-40f1-bbdb-e964a0c9bc63)
3. This will bring up your OS's File Explorer.
From there, navigate to the location of your DLC files,
select which ones you want to Add and click on **Open**.\
![image](https://github.com/user-attachments/assets/5d8476b5-4de2-4407-a338-f60f14540fce)\
You may repeat this for any other DLC files you want to add.
4. Select which DLC you want to be applied by clicking on it and click **Save**.\
![image](https://github.com/user-attachments/assets/b354d3de-fde6-4626-bfe2-58e6977fd73a)\
Repeat this process, if you wish, for any other games you would like to manage DLC for. Repeat this process, if you wish, for any other games you would like to manage DLC for.
Your DLC should now be applied and enabled automatically.
Managing Mods Managing Mods
============ ============
Quick Start Guide for managing mods Quick Start Guide for managing mods
Various game mods are available from enthusiasts & content creators online. _Ryujinx_ supports the following types of mods: Various game mods are available from enthusiasts & content creators online. *Ryujinx* supports the following types of mods:
1. ExeFS Partition Replacement 1. ExeFS Partition Replacement
2. ExeFS File Replacement 2. ExeFS File Replacement
3. ExeFS Patching 3. ExeFS Patching
4. RomFS Partition Replacement 4. RomFS Partition Replacement
5. RomFS File Replacement 5. RomFS File Replacement
**For an in-depth explanation of the mods implementation & advanced usage options in _Ryujinx_, check the description in the original PR [here](https://github.com/Ryujinx/Ryujinx/pull/1249)**. ## Using the Mod Manager
To enable mods: *Ryujinx* has a built-in **Mod Manager** that can
very easily be used to enable, disable, add and remove mods.
1. With _Ryujinx_ open, right-click on the game you wish to manage mods for and click _Open Mods Directory_. 1. Right-click on the game you want to
add a mod for, from there click on **Manage Mods**.\
![image](https://github.com/user-attachments/assets/3af95069-d3d0-4903-b9bd-dec9523ac5eb)
![image](https://user-images.githubusercontent.com/62343878/87058158-f9fbc900-c1c4-11ea-8dcd-7bea51fc71e6.png) 2. The **Mod Manager** window will pop-up,
this is where you can add, remove, enable and
disable your mods for the game of your choice.\
![image](https://github.com/user-attachments/assets/91b3b479-5db0-4c27-9920-68b9d0f31737)
3. To add Mods, simply click the **Add** button.\
![image](https://github.com/user-attachments/assets/ae590e65-3cce-4c63-8af5-50d6c34df6e8)
4. This will bring up your OS's File explorer.
From there select the **unzipped** folder
containing all the files for the mod you want to add.
![image](https://github.com/user-attachments/assets/5fa56993-9a62-44dd-938c-f078842e57c2)
Your mods should now be installed and already enabled by default.
![image](https://github.com/user-attachments/assets/7aec7658-eb06-4a83-bdd4-f68b6c0cf2b0)
5. Click **Save** to exit and save your mods.
![image](https://github.com/user-attachments/assets/a3eb943a-a613-435e-95fb-ebe14d4e294b)
## Manually Adding Mods (NOT RECOMMENDED)
**This is only recommended for experienced users who know what they are doing.**
1. Right-click on the game you wish to add mods for and click **Open Mods Directory**.\
![image](https://github.com/user-attachments/assets/d90a9f35-d7ca-478e-ab88-5e148697cde3)\
This will open the `AppData\Roaming\Ryujinx\mods\contents\<game ID>\` folder. This will open the `AppData\Roaming\Ryujinx\mods\contents\<game ID>\` folder.
2. Create a subfolder under the game id folder with an appropriate name conveying the mod you will be using. For instance, you might name the folder "Lana" if you were using a mod to add a Lana skin to Mario Kart 8 Deluxe. 2. Create a subfolder with a name that fits
the mod you'll be using. Then, place the ExeFS
and RomFS of the mod inside that folder.\
![image](https://github.com/user-attachments/assets/109dcc30-20bb-4809-aba2-f1c4566750bf)
![image](https://user-images.githubusercontent.com/62343878/87060018-3d573700-c1c7-11ea-82f8-3a54c788490c.png) You can also place mods in
`C:\Users\[redacted]\AppData\Roaming\Ryujinx\sdcard\atmosphere`
if the mod was packaged for real hardware
(usually indicated with an "atmosphere" folder as the top directory).
3. Copy your mod's romfs folder or exefs folder into the new folder you created. Right-click the game you wish to add an atmosphere mod
to and click on **Open Atmosphere Mods Directory**.
![image](https://user-images.githubusercontent.com/62343878/87071634-b3fc3080-c1d7-11ea-8a28-a1aa86009f5c.png) This will open `AppData\Roaming\Ryujinx\sdcard\atmosphere\contents\<game ID>`
where you can then place the RomFS and ExeFS of the mod you wish to add.\
Mods can also be placed in the `AppData\Roaming\Ryujinx\sdcard` folder if the mod has been packaged for real hardware (usually indicated with an "atmosphere" folder as the top directory). With _Ryujinx_ open, right-clicking on the game you wish to manage SD mods for and clicking _Open Atmosphere Mods Directory_ will open the `AppData\Roaming\Ryujinx\sdcard\atmosphere\contents\<game ID>` folder where the romfs/exefs folders are located. ![image](https://github.com/user-attachments/assets/eb114e43-77fb-46d1-9355-1c5bbec9b605)\
![image](https://github.com/user-attachments/assets/3c6212c7-2462-4650-bcb8-20e04a5ed220)
![image](https://user-images.githubusercontent.com/44103205/156943587-5242ccda-d74d-4d2f-8446-a1941beb4c2c.png)
![image](https://user-images.githubusercontent.com/44103205/156943543-ea49ec82-57b7-46eb-a12e-5daf64b1cad5.png)
Managing Cheats Managing Cheats
=============== ===============
Ryujinx now has native cheats/runtime mods support! Ryujinx fully supports Atmosphere style cheats (except game pausing/resume): [Atmosphere's cheats doc](https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/cheats.md)
It implements full support Atmosphere style cheats (except game pausing/resume):
https://github.com/Atmosphere-NX/Atmosphere/blob/master/docs/features/cheats.md
## Installation of Atmosphere Cheats ## Installation of Atmosphere Cheats
A good place to acquire Atmosphere cheats is: A good place to acquire Atmosphere cheats is:
- https://github.com/WerWolv/EdiZon_CheatsConfigsAndScripts/tree/master/Cheats (general switch cheats) - [EdiZon](https://github.com/WerWolv/EdiZon_CheatsConfigsAndScripts/tree/master/Cheats) (general switch cheats)
Inside the cheat `zip`, `rar`, or other archive format, there is usually a file structure like this: Inside the cheat `zip`, `rar`, or other archive format, there is usually a file structure like this:
@ -331,52 +404,29 @@ Where `0123456789ABCDEF` will vary according to the game and the cheat (this is
To install the cheat: To install the cheat:
- Open Ryujinx, right-click the game you wish to install the cheat and select to open its `Mod directory`; 1. Open Ryujinx, right-click the game you wish to
- A directory like this will open: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\`, `XXXXXXXXXXXXXXXX` will be the id of the chosen game; install the cheat and select to open its `Mod directory`.\
- Extract the cheat archive to the mod directory, keeping the cheat name: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\Cheat_Name\cheats\<all the txt files>`. ![image](https://github.com/user-attachments/assets/935cc4f3-55b9-4b40-818d-ad58e35f636d)
2. A directory like this will open: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\`,
`XXXXXXXXXXXXXXXX` will be the id of the chosen game.\
![image](https://github.com/user-attachments/assets/2ac1fb9a-de79-4475-8e57-659a4bbd05bc)
3. Extract the cheat archive to the mod directory, keeping the cheat name: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\Cheat_Name\cheats\<all the txt files>`.
The following image may be a bit confusing to look at,
but take your time it's actually quite easy to understand.\
![image](https://github.com/user-attachments/assets/11a57587-4bec-4f60-8f8b-9e04990229f5)
## Activating/Deactivating cheats ## Activating/Deactivating cheats
Currently, all cheats are automatically enabled and cannot be disabled, so mixing, for instance, 60, 90 and 120 fps cheats may cause a conflict. In Ryujinx, cheats are all automatically disabled, so you need to enable them in the Ryujinx UI to be able to use them.
One alternative is to create a directory `disabled_cheats` in the mod directory and move all unused cheats there. Another one is to prepend something to the file name, for instance `off_0123456789ABCDEF.txt` as a valid cheat must not have anything but `0123456789ABCDEF.txt` in its name. To do so, start by right-clicking a game and clicking on **"Manage Cheats"**\
![image](https://github.com/user-attachments/assets/1c69981c-7954-4357-866e-6c29ca5bb24f)
The .txt files can also contain several cheats that may conflict. To switch off individual cheats inside a .txt file first **backup the .txt file** to something like `bak_0123456789ABCDEF.txt` (this will also prevent the backup to be loaded as a cheat). Next, in the .txt file, there will be sections, each with a name within `[ ]` brackets and filled with sequences of letters and numbers (the code of the cheat), for instance: This will bring up Ryujinx's *Cheat Manager*, from where you can enable/disable cheats by checking the box next to their name.\
![image](https://github.com/user-attachments/assets/6623bcf0-7b32-4f60-bc72-ac80777a0db6)\
``` Next, click **Save** to save which cheats you enabled/disabled.
[New Super Mario Bros. U Deluxe]
[Start with 99 Lives]
58000000 00CC9860
78000000 0002A1C0
61000000 00000000 00000063
[Time = 999]
58000000 00C88A70
78001000 00000090
64000000 00000000 003E6F00
[Start as Penguin]
58000000 00CC9860
78000000 0002A1C4
61000000 00000000 00000005
```
To disable the time cheat, just remove its section and the code:
```
[New Super Mario Bros. U Deluxe]
[Start with 99 Lives]
58000000 00CC9860
78000000 0002A1C0
61000000 00000000 00000063
[Start as Penguin]
58000000 00CC9860
78000000 0002A1C4
61000000 00000000 00000005
```
Managing User Profiles Managing User Profiles
===================== =====================
@ -384,48 +434,52 @@ Managing User Profiles
Ryujinx offers the ability to use multiple, customizable user profiles. **WARNING:** Save data is specific to each user profile so if you delete a profile, the save data under that profile is also deleted. Ryujinx offers the ability to use multiple, customizable user profiles. **WARNING:** Save data is specific to each user profile so if you delete a profile, the save data under that profile is also deleted.
### To edit a user profile: ### To edit a user profile:
1. With Ryujinx open, but no game running, click on Options > Manage User Profiles 1. With Ryujinx open, but no game running, click on Options > Manage User Profiles\
![image](https://user-images.githubusercontent.com/62343878/115936775-62b1ea80-a453-11eb-9df8-5d39cf414057.png) ![image](https://github.com/user-attachments/assets/75689cb0-a05f-4483-872d-a966bd2300dd)
Now in the Manage User Profiles window, you will see the default RyuPlayer profile. This is the default profile that comes with Ryujinx and **cannot be deleted** as it contains all of the original save data for your games. You may, however, rename it and change the picture to something else, if you like. Now in the Manage User Profiles window, you will see the default RyuPlayer profile. This is the default profile that comes with Ryujinx and **cannot be deleted** as it contains all of the original save data for your games. You may, however, rename it and change the picture to something else, if you like.\
![image](https://user-images.githubusercontent.com/62343878/115936853-98ef6a00-a453-11eb-9bdb-2b2076ff529d.png) ![image](https://github.com/user-attachments/assets/598a9b0c-bd1a-42c0-a690-b20e2bcbb7ae)
2. To rename a profile, simply select it and type in the new text. 2. To rename a profile, hover over the profile and click the editing icon.\
![image](https://user-images.githubusercontent.com/62343878/115936950-e1a72300-a453-11eb-9d5d-027826457759.png) ![image](https://github.com/user-attachments/assets/c03df82a-9030-4cd4-9448-fba3e14757c4)
3. To change the profile image, select the profile in the list and click **Change Profile Image**. You can then edit the name of the profile.
![image](https://user-images.githubusercontent.com/62343878/115937027-10bd9480-a454-11eb-977a-2afdec837dab.png)
You will then be prompted to select from either a custom image, or from one of the many avatars provided in the firmware. ![image](https://github.com/user-attachments/assets/9076842e-7ffc-4982-8877-715c69a998ac)
![image](https://user-images.githubusercontent.com/62343878/115937083-2df26300-a454-11eb-95de-7db4a12aaa45.png)
3. To change the profile image, hover over the profile and click the editing icon.\
![image](https://github.com/user-attachments/assets/c03df82a-9030-4cd4-9448-fba3e14757c4)
Then, click on "Change Profile Image".\
![image](https://github.com/user-attachments/assets/bbaf17ab-db77-4b91-94c7-f3134b51e0f5)
You will then be prompted to select from either a custom image, or from one of the many avatars provided in the firmware.\
![image](https://github.com/user-attachments/assets/3f9c0a6f-4dbf-49e3-80ad-626b1501210a)
If you choose to import an image: supported formats are `png`, `bmp`, and `jpg`. You can use the image you want, but it will be resized to 256x256 pixels, so using a square image is recommended. If you choose to import an image: supported formats are `png`, `bmp`, and `jpg`. You can use the image you want, but it will be resized to 256x256 pixels, so using a square image is recommended.
If you choose to use a built-in firmware avatar, click on **Select Firmware Avatar** If you choose to use a built-in firmware avatar, click on **Select Firmware Avatar**
In the Manage Accounts - Avatar window, select the avatar you want, and choose a background color. When finished, click **Choose** to make it the profile's image. In the Manage Accounts - Avatar window, select the avatar you want, and choose a background color. When finished, click **Choose** to make it the profile's image.
![image](https://user-images.githubusercontent.com/62343878/115937295-df919400-a454-11eb-90ac-f31263ec543e.png) ![image](https://github.com/user-attachments/assets/079f6a7c-9899-4f89-80f8-9d0e923ffffa)
![image](https://user-images.githubusercontent.com/62343878/115937710-b7566500-a455-11eb-905c-c748e8baeae8.png) ![image](https://github.com/user-attachments/assets/c0ce5fee-4d7c-4d10-b60d-07abb13b4383)
### To add a new profile: ### To add a new profile:
1. With Ryujinx open, but no game running, click on Options > Manage User Profiles 1. With Ryujinx open, but no game running, click on Options > Manage User Profiles
![image](https://user-images.githubusercontent.com/62343878/115936775-62b1ea80-a453-11eb-9df8-5d39cf414057.png) ![image](https://github.com/user-attachments/assets/83b608be-6421-4cda-b011-cf2b0067e8e6)
2. Click on the **Add New Profile** button at the bottom left corner of the window. 2. Click on the Plus sign next to the already existing Profile.\
![image](https://github.com/user-attachments/assets/61c33bae-c15d-4dc3-84ec-42b5620125aa)
![image](https://user-images.githubusercontent.com/62343878/115938010-8a568200-a456-11eb-8a1b-a610fd8f5c7e.png)
3. A window will pop up asking you to name the new Profile. Enter the desired name of the new profile, and click OK. 3. A window will pop up asking you to name the new Profile. Enter the desired name of the new profile, and click OK.
![image](https://user-images.githubusercontent.com/62343878/115938038-9e9a7f00-a456-11eb-8464-3855cde7241d.png) To set a profile picture, just click on Set Profile Image and follow Step 3 from the user profile editing instructions above.
4. You will now be prompted to choose the profile image. Follow step 3 from the user profile editing instructions above. ![image](https://github.com/user-attachments/assets/1aa8bba9-70c9-45a8-91ee-869a61fd0d50)
![image](https://user-images.githubusercontent.com/62343878/115938416-c9390780-a457-11eb-9761-eff2e0dd5efa.png) ![image](https://github.com/user-attachments/assets/efc1f938-c3ca-4666-93d1-fa140689bd61)
That's it!
Input Configuration Input Configuration
=================== ===================
@ -436,55 +490,44 @@ carefully!
1. Plug in the controller(s) that you will be using. 1. Plug in the controller(s) that you will be using.
2. Open *Ryujinx* and navigate to *Options \> Settings*\ 2. Open *Ryujinx* and navigate to *Options \> Settings*\
!![image](https://user-images.githubusercontent.com/62343878/86278975-7aec0c80-bb96-11ea-897f-9a4ed393f3b0.png) ![image](https://github.com/user-attachments/assets/e38d323d-cb8f-4c6e-9e87-db026586c788)
3. You will now see the *Ryujinx - Settings* window. Click on the 3. You will now see the *Ryujinx - Settings* window. Click on the
*Input* tab.\ *Input* tab.\
![image](https://user-images.githubusercontent.com/62343878/86278991-82abb100-bb96-11ea-9a00-adacae14b34c.png) ![image](https://github.com/user-attachments/assets/208282ce-853a-4301-ba68-b9353590bf81)
Before proceeding to configure anything, the options on the Input page Before proceeding to configure anything, the options on the Input page
need some explanation: need some explanation:
*Direct Keyboard Access*: checking this box emulates a real, physical Enable Docked Mode: checking this box emulates the Nintendo Switch being docked.
keyboard being directly connected to a Nintendo Switch via USB. ***Do Docked Mode enables higher resolution, higher FPS, and better graphical fidelity on games that support these features.
not check this box unless you have a specific reason*** **If you check this box, you will need to click configure under Player 1.**
**If you leave this box unchecked, you will need to click configure under Handheld.**
*Enable Docked Mode*: checking this box emulates the Nintendo Switch Direct Keyboard Access: checking this box emulates a real,
being docked. Docked Mode enables higher resolution, higher FPS, and physical keyboard being directly connected to a Nintendo Switch via USB.
better graphical fidelity on games that support these features.\ **Do not check this box unless you have a specific reason.**
**If you check this box, you will need to click configure under Player**
**1 (top left menu item)**\ Direct Mouse Access: checking this box emulates a real,
**If you leave this box unchecked, you will need to click configure under** physical mouse being directly connected to a Nintendo Switch via USB.
**Handheld (bottom right menu item)**\ **Do not check this box unless you have a specific reason.**\
![image](https://github.com/user-attachments/assets/cd6e5df4-ec39-4afb-8bd4-89e5e261e494)
4. If you have checked Docked Mode, select Player 1 under the "Player" Dropdown.
If you have unchecked Docked Mode, select Handheld under the "Player" Dropdown.\
![image](https://github.com/user-attachments/assets/3d26182b-79c8-4b10-aa94-9ed962d7ddb6)
5. Click on the Input Device dropdown and choose the controller you want.
If you have connected multiple controllers,
choose the one you want to be configured to be P1 in game.
**If you do not see any Xinput controllers in the list,
you will need to use an Xinput wrapper/translator such as** [x360ce](https://www.x360ce.com/).\
![image](https://github.com/user-attachments/assets/7bd09992-e8f6-41ce-abdc-94c7abf6426e)
6. After selecting your controller you should now see a full mapping UI.\
![image](https://github.com/user-attachments/assets/ab654318-16cc-4d3f-9627-b34891d15793)
4. Click *Configure* under *Player 1* if you have enabled *Docked
Mode*, or click configure *Handheld* if you have not enabled *Docked
Mode*.\
![image](https://user-images.githubusercontent.com/62343878/86279008-8d664600-bb96-11ea-9ed3-32034ad9f53a.png)
5. You should now be in the *Ryujinx -- Controller Settings* screen.
Click on the *Input Device* dropdown and choose the *Xinput
controller*. If you have connected multiple controllers, choose the
one you want to be configured to be P1 in game. **If you do not see**
**any Xinput controllers in the list, you will need to use an Xinput**
**wrapper/translator such as**
[x360ce](https://www.x360ce.com/).\
![image](https://user-images.githubusercontent.com/62343878/86279068-a969e780-bb96-11ea-913c-6da064e6d7a6.png)
6. After selecting your Xinput controller you should now see a full
mapping UI. If you want to map the buttons in a standard
Xinput-compatible fashion, there is no need to individually map the
buttons. Simply click on the empty *Profile* dropdown, select
*Default*, and click *Load*. This populates the buttons with preset
mappings for your Xinput-compatible (or Xinput wrapped/translated)
controller. Otherwise, click on "*Unbound*" for each button you want
to map, then press the actual button on your controller that you
want for the Nintendo Switch controller button you've
chosen.
![image](https://user-images.githubusercontent.com/62343878/86279165-d1f1e180-bb96-11ea-9d77-b9c029ce5b3a.png)
\
You may continue tweaking the settings to your liking, or binding You may continue tweaking the settings to your liking, or binding
each button from scratch if you want a fully custom button layout.\ each button from scratch if you want a fully custom button layout.\
**NOTE: while the default *Deadzones* are 0.10, we recommend **NOTE: while the default *Deadzones* are 0.10, we recommend
@ -494,57 +537,60 @@ better graphical fidelity on games that support these features.\
If you are in *Docked Mode* and have additional controllers to If you are in *Docked Mode* and have additional controllers to
configure, configure them now under Player 2, Player 3, and so on. configure, configure them now under Player 2, Player 3, and so on.
7. ***Click Save to save your configuration.*** 7. ***Click Apply and then OK to save your configuration.***
Alternately, you may skip the input UI and edit your config.json file
found in %appdata%\\ryujinx\\
Motion Controls Motion Controls
=============== ===============
### Motion Controls ### Motion Controls
Ryujinx offers the ability to use motion controls with motion-enabled controllers such as a Switch Pro Controller, Joycons, Playstation DS4, smartphones with motion support, Steam controller, and others. Ryujinx offers the ability to **natively** use motion controls with
motion-enabled controllers such as a Switch Pro Controller, DS4, DS5, DSE and others.
To use motion controls in Ryujinx: ## Native motion controls
1. Launch & configure your favorite cemuhook server application (Betterjoy, DS4Windows, Steam Gyro, etc.) with your bluetooth or wired motion-enabled controller. Leave the application running. Native motion controls should already be enabled and working by default.
If you want to change the sensitivity and deadzone, you can do so in the **Settings**.\
![image](https://github.com/user-attachments/assets/42a52f4f-bd3b-4ecd-8fa7-9da429cb755a)
2. In Ryujinx, navigate to Options > Settings > Input tab and select which controller you are configuring. Remember: if you are in docked mode, configure Player 1. If you are in Handheld mode, configure the Handheld controller. Then, go to the **Input** tab, make sure the box next to **"Motion"** is checked and click **Configure**.\
![image](https://github.com/user-attachments/assets/0a088973-3e84-477a-bfa1-df5a232954d4)
![image](https://user-images.githubusercontent.com/62343878/92328779-5c841080-f020-11ea-80a1-af54341c4deb.png) You will now see the *Motion Controls Settings*.
From here, feel free to modify the sensitivity and deadzone.
**Since you are natively using motion, you do not need to touch any cemuhook related settings.**\
![image](https://github.com/user-attachments/assets/81a5c48a-2aa6-46fb-b61b-dbaf52d4952c)\
Make sure to click on **Save** to save your configuration.
3. Select your motion controller from the dropdown. It will be listed as "Xinput controller". ## Cemuhook motion controls
![image](https://user-images.githubusercontent.com/62343878/92328812-9ead5200-f020-11ea-88f4-706c8f2bd5b6.png) Since Ryujinx uses SDL2 as it's input wrapper,
it means that not all controllers are supported,
and that not all the features of a controller are supported.
Meaning that sometimes, a controller that has motion controls may not be **natively** supported by Ryujinx.
4. Configuration options: Cemuhook is also needed to use a joycon pair, since it can group 2 controllers under 1.
- If you have already configured your controller's input buttons to your liking and only need to configure motion controls, check the "Enable Motion Controls" box and fill in the following information: To fix this, we can use cemuhook:
**Controller Slot:** the controller slot # your motion controller is configured as in your cemuhook server application. Default is "0" 1. Launch & configure your favorite cemuhook server application (Betterjoy, DS4Windows,etc.) with your Bluetooth or wired motion-capable controller. Leave the application running.
**Gyro Sensitivity:** 100% (you may adjust this to suit)
**Server Host:** the IP address of the computer being used to host the cemuhook server. 127.0.0.1 is localhost/the same computer running Ryujinx.
**Server Port:** 26760
![image](https://user-images.githubusercontent.com/62343878/92329071-542cd500-f022-11ea-9aff-9b1e22f29b61.png) 2. In Ryujinx, navigate to **Options > Settings > Input** tab and select which controller you are configuring. **Remember: if you are in docked mode, configure Player 1. If you are in Handheld mode, configure the Handheld controller.**\
![image](https://github.com/user-attachments/assets/3b2c5985-b868-4271-8fbb-d5e960688e88)
- Alternately, you can simply click on the empty Profile dropdown, select Default, and click Load. This populates the buttons with preset mappings and also fills in the motion control settings with recommended defaults. You may continue tweaking the settings to your liking, or binding each button from scratch if you want a fully custom button layout. 3. Select your motion controller from the dropdown. It will be listed as **"Xinput controller"**, **"Xbox 360 Controller"** or **"Xbox One Controller"**.\
![image](https://github.com/user-attachments/assets/750f1d6a-fdab-4977-9df7-8aa19cc2a8b4)
**NOTE: while the default Deadzones are 0.10, we recommend increasing your Deadzones to at least 0.20 in order to avoid unwanted joystick drift.**
Make sure to check the "Enable Motion Controls" box!
![image](https://user-images.githubusercontent.com/62343878/92328941-740fc900-f021-11ea-9663-ee1eeee47cee.png) 4. Next up, make sure **Motion** is activated, and click **Configure** to bring up the *Motion Controls Settings*.\
![Capture d'écran 2024-10-27 152629](https://github.com/user-attachments/assets/c41823bb-b52d-4245-a979-9b092377432f)
- Paired Joycons extra options:
5. Once here, check the box named **Use CemuHook compatible motion**, then enter the IP and Port that your cemuhook application uses (usually 127.0.0.1 and 26760).\
![image](https://github.com/user-attachments/assets/455efa58-efda-45ac-95d3-0b3d6be6e2d1)\
If you set your controller type to Joycon Pair, an option called "Mirror Input" becomes available. This is useful for games in which both Joycons are connected to a Joycon grip and are moving together. If you enable this checkbox, the first Joycon's motion will be used for both Joycons. If you set your controller type to Joycon Pair, an option called "Mirror Input" becomes available. This is useful for games in which both Joycons are connected to a Joycon grip and are moving together. If you enable this checkbox, the first Joycon's motion will be used for both Joycons.
![image](https://user-images.githubusercontent.com/62343878/92338812-00e17380-f070-11ea-9090-e94abe4d1134.png) 6. Click **Save** to save your configurations.
Repeat steps 2 through 5 for any other motion controllers you wish to configure. If you have more than one, make sure to choose the respective slot # for each controller
5. Click Save to save your configuration.
Repeat steps 2 through 5 for any other motion controllers you wish to configure. If you have more than one, make sure to choose the respective slot # for each controller!
Amiibo Emulation Amiibo Emulation
================ ================
@ -553,10 +599,14 @@ All Amiibo are able to be virtually scanned within the emulator, as long as you
**To scan an Amiibo:** **To scan an Amiibo:**
1. While playing a game that supports Amiibo, either navigate to the area where Amiibo scanning is expected, or press/hold the correct button to enable the Amiibo scan prompt (this site has a basic list of supported games and what benefits are provided by each: https://amiibo.life/games 1. While playing a game that supports Amiibo, either navigate to the area where Amiibo scanning is expected, or press/hold the correct button to enable the Amiibo scan prompt (this site has a basic list of supported games and what benefits are provided by each: https://amiibo.life/games
2. Click the "Actions" menu header, then click "Scan an Amiibo"
![unknown1](https://user-images.githubusercontent.com/4905390/111011795-d82d9400-839a-11eb-8798-c426fe5bc973.png) 2. Click the "Actions" menu header, then click "Scan an Amiibo"\
3. Choose the Amiibo you want from the Amiibo Series and Character dropdowns. Note: only the Amiibo that have content for the game you are currently playing are shown in this window. All the same, if you'd like to see all Amiibo you may check the box that says "Show All Amiibo". ![image](https://github.com/user-attachments/assets/0962c14f-3cae-4a2d-b891-2bcf37b57034)
![unknown2](https://user-images.githubusercontent.com/4905390/111011810-e8de0a00-839a-11eb-8a5c-d03b0e094ec4.png)
3. Choose the Amiibo you want from the Amiibo Series and Character dropdowns. Note: only the Amiibo that have content for the game you are currently playing are shown in this window. All the same, if you'd like to see all Amiibo you may check the box that says "Show All Amiibo".
![image](https://github.com/user-attachments/assets/059518fb-2e1b-4f57-beea-9fbecb6a0a33)
**Addendum:** In The Legend of Zelda: Breath of the Wild, you may continually scan Amiibo as many times as you wish by checking the box labeled "Hack: Use Random Tag Uuid" box. **Addendum:** In The Legend of Zelda: Breath of the Wild, you may continually scan Amiibo as many times as you wish by checking the box labeled "Hack: Use Random Tag Uuid" box.
Profiled Persistent Translation Cache Profiled Persistent Translation Cache
@ -566,8 +616,8 @@ Speed up game loading times with PPTC
In a nutshell, this feature caches translated functions so that they do In a nutshell, this feature caches translated functions so that they do
not need to be translated every time the game loads. This results in a not need to be translated every time the game loads. This results in a
significant reduction of load times \--the amount of time between significant reduction of load times (the amount of time between
launching a game and arriving at the title screen\-- for nearly every launching a game and arriving at the title screen) for nearly every
game. game.
**NOTE: You must launch the game at least twice and let it load** **NOTE: You must launch the game at least twice and let it load**
@ -578,28 +628,27 @@ game.
PPTC (Profiled Persistent Translation Cache) is now enabled by default. To disable it: PPTC (Profiled Persistent Translation Cache) is now enabled by default. To disable it:
1. With *Ryujinx* open, click on *Options \> Settings*\ 1. With *Ryujinx* open, click on *Options \> Settings*\
![image](https://user-images.githubusercontent.com/62343878/86279303-082f6100-bb97-11ea-92bc-68f24612d7e2.png) ![image](https://github.com/user-attachments/assets/e950981a-c157-44a9-a356-5bcb06d34f63)
2. Then navigate to the *System* tab and **uncheck the box** marked 2. Then navigate to the CPU tab and uncheck the box marked "PPTC (Profiled Persistent Translation Cache)"\
*Enable Profiled Persistent Translation Cache*\ ![image](https://github.com/user-attachments/assets/b1e077fa-6b09-4325-8802-b7da6bf90459)
![image](https://user-images.githubusercontent.com/62343878/86279433-3b71f000-bb97-11ea-8bd2-0435ba8ece33.png)
From time to time you may wish to examine or purge your PPTC cache files if you are experiencing PPTC-related issues. From time to time you may wish to examine or purge your PPTC cache files if you are experiencing PPTC-related issues.
To open the PPTC cache file location: To open the PPTC cache file location:
1. With Ryujinx open, right-click the game in the game list whose PPTC cache files you wish to view. This will bring up a pop-up menu. 1. With Ryujinx open, right-click the game in the game list whose PPTC cache files you wish to view. This will bring up a pop-up menu.
2. Navigate to _Cache Management_ > _Open the PPTC directory_ 2. Navigate to _Cache Management_ > _Open the PPTC directory_\
![image](https://github.com/user-attachments/assets/51bc27ae-d1a0-4749-8ed5-a25bc680f7d9)
![image](https://user-images.githubusercontent.com/62343878/86624278-486c5600-bf80-11ea-9de5-47340af14a0c.png)
To purge the PPTC cache files: To purge the PPTC cache files:
1. With Ryujinx open, right-click the game in the game list whose PPTC cache files you wish to purge. This will bring up a pop-up menu. 1. With Ryujinx open, right-click the game in the game list whose PPTC cache files you wish to purge. This will bring up a pop-up menu.
2. Navigate to _Cache Management_ > _Purge the PPTC cache_ 2. Navigate to _Cache Management_ > _Open PPTC Directory_\
![image](https://github.com/user-attachments/assets/51bc27ae-d1a0-4749-8ed5-a25bc680f7d9)
![image](https://user-images.githubusercontent.com/62343878/86625047-ac434e80-bf81-11ea-9dd7-7f3465f8c0d2.png) 3. You can then select the folders and delete them.\
![image](https://github.com/user-attachments/assets/dad02a8f-4494-4959-8208-d0bbad0bfe56)
Graphics Enhancements Graphics Enhancements
===================== =====================
@ -625,11 +674,13 @@ _anti-aliased texture filtering._
**These settings may be changed in-game on the fly! On a standard 1080p display, 2x resolution scaling is recommended.** **These settings may be changed in-game on the fly! On a standard 1080p display, 2x resolution scaling is recommended.**
1. With *Ryujinx* open, click *Options \> Settings*\ 1. With *Ryujinx* open, click *Options \> Settings*\
![image](https://user-images.githubusercontent.com/62343878/86672580-078e3480-bfb4-11ea-8c01-86b05066a4dc.png) ![image](https://github.com/user-attachments/assets/f977e0a5-dc04-4e9a-ae33-302bbe847b69)
2. Navigate to the *Graphics* tab and click the dropdown next to Resolution Scale. Select your desired level of resolution scaling.\
![image](https://user-images.githubusercontent.com/62343878/86673437-e7ab4080-bfb4-11ea-86de-876d7563f6a2.png) 2. Navigate to the *Graphics* tab and click the dropdown next to Resolution Scale. Select your desired level of resolution scaling.
\
**Click *Save*** to save the enhancement setting. ![image](https://github.com/user-attachments/assets/f9cb6e7b-f4e5-4d6e-892c-905d974f49ad)
**Click *Apply* and then *OK* to save the enhancement setting.**
**To enable _Anisotropic Filtering_:** **To enable _Anisotropic Filtering_:**
@ -637,14 +688,14 @@ _anti-aliased texture filtering._
**games.** **games.**
1. With *Ryujinx* open, click on *Options \> Settings*\ 1. With *Ryujinx* open, click on *Options \> Settings*\
![image](https://user-images.githubusercontent.com/62343878/86279490-547aa100-bb97-11ea-97ad-549534e9d635.png) ![image](https://github.com/user-attachments/assets/f977e0a5-dc04-4e9a-ae33-302bbe847b69)
2. Navigate to the *Graphics* tab and click the dropdown next to 2. Navigate to the *Graphics* tab and click the dropdown next to
*Anisotropic Filtering*. Set it to your desired level.\ *Anisotropic Filtering*. Set it to your desired level.
![image](https://user-images.githubusercontent.com/62343878/86279552-6ceabb80-bb97-11ea-8b88-1e19983ed890.png)
\ ![image](https://github.com/user-attachments/assets/f977e0a5-dc04-4e9a-ae33-302bbe847b69)
**Click *Save*** to save the enhancement setting.
**Click *Apply* and then *OK* to save the settings.**
**To Manage _Shader Cache_:** **To Manage _Shader Cache_:**
**Shader Cache is enabled by default**. There are no good reasons to disable it other than for testing purposes. **Shader Cache is enabled by default**. There are no good reasons to disable it other than for testing purposes.
@ -656,27 +707,26 @@ Disabling this setting is strongly discouraged. However, if you absolutely must
In some rare cases, a shader cache might become corrupted and crash when compiling shaders on boot. To solve this you'll have to purge the shader cache for that particular game: In some rare cases, a shader cache might become corrupted and crash when compiling shaders on boot. To solve this you'll have to purge the shader cache for that particular game:
1. Right click on a game in the game list and navigate to Cache Management > Purge Shader Cache.
![image](https://user-images.githubusercontent.com/62343878/98551756-e76ccb80-225a-11eb-83b8-ce99b712e7d6.png)
Right click on a game in the game list and navigate to Cache Management > Purge Shader Cache.\
![image](https://github.com/user-attachments/assets/3b4a0d31-910f-4b8d-8079-db2e13de8a9a)
To view the shader cache directory for a particular game: To view the shader cache directory for a particular game:
1. Right click on a game in the game list and navigate to Cache Management > Open Shader Cache Directory.
![image](https://user-images.githubusercontent.com/62343878/98551866-0ec39880-225b-11eb-8380-967c97bfd97f.png) Right click on a game in the game list and navigate to Cache Management > Open Shader Cache Directory.\
![image](https://github.com/user-attachments/assets/1f89e0e2-bbe0-4669-bb38-39538f5d8aaf)
To adjust your aspect ratio: To adjust your aspect ratio:
**Option 1:** **Option 1:**
- With Ryujinx open, navigate to Options > Settings and click on the Graphics tab. Click on the Aspect Ratio dropdown and adjust the ratio to your liking. - With Ryujinx open, navigate to Options > Settings and click on the Graphics tab. Click on the Aspect Ratio dropdown and adjust the ratio to your liking.\
![image](https://user-images.githubusercontent.com/62343878/102350497-3f85a480-3f62-11eb-95b2-c9ef3d468315.png) ![image](https://github.com/user-attachments/assets/928ea39b-0f22-44fc-96b6-3e6124b289cc)
**Option 2:** **Option 2:**
- With your game running, click on the aspect ratio button in the status toolbar at the bottom of the Ryujinx window. - With your game running, click on the aspect ratio button in the status toolbar at the bottom of the Ryujinx window.\
![image](https://user-images.githubusercontent.com/62343878/102351140-3517da80-3f63-11eb-8d14-a2c1fc9bfd5d.png) ![image](https://github.com/user-attachments/assets/e7072a03-5b27-497f-a489-329349accefe)
**Option 3:** **Option 3 (NOT RECOMMENDED):**
1. Use Option 1 and select "Stretch to Fit Window" or Option 2 and select "Stretched". 1. Use Option 1 and select "Stretch to Fit Window" or Option 2 and select "Stretched".
2. Simply click and drag your window borders to the size you want! 2. Simply click and drag your window borders to the size you want!
@ -691,30 +741,26 @@ If you wish, you may use a custom folder location for all Ryujinx data (as oppos
To enable *Portable Mode* To enable *Portable Mode*
**Option 1: (Recommended)** Create a "portable" subfolder **Option 1: (Recommended)** Create a "portable" subfolder
1. Create a subfolder in the Ryujinx program base directory called "portable". This automatically enables portable mode and utilizes this "portable" folder for system folder contents (keys, firmware, PPTC/shader caches, etc.). 1. Create a subfolder in the Ryujinx program base directory called "portable". This automatically enables portable mode and utilizes this "portable" folder for system folder contents (keys, firmware, PPTC/shader caches, etc.).\
![image](https://user-images.githubusercontent.com/62343878/111225959-14811000-85a6-11eb-9ffa-a8d2f5d899cd.png) ![image](https://github.com/user-attachments/assets/6c3b0716-3fb1-436d-9903-dc094af63ece)
**Option 2:** Command-line **Option 2:** Command-line
1. Open a command prompt, navigate to the location of the Ryujinx executable and type the following command: ryujinx.exe -r d:\[folderpath]. For example, if your custom folder was d:\ryujinxdata, your command would be the following, without quotes (_THIS IS ONLY AN EXAMPLE. USE WHATEVER CUSTOM FOLDER NAME YOU PREFER_): 1. Open a command prompt, navigate to the location of the Ryujinx executable and type the following command: ryujinx.exe -r d:\[folderpath]. For example, if your custom folder was d:\ryujinxdata, your command would be the following, without quotes (_THIS IS ONLY AN EXAMPLE. USE WHATEVER CUSTOM FOLDER NAME YOU PREFER_):
"ryujinx.exe -r d:\ryujinxdata" "ryujinx.exe -r d:\ryujinxdata"\
![image](https://github.com/user-attachments/assets/74e4da85-78b9-4290-9783-455cd0803bd3)
![image](https://user-images.githubusercontent.com/62343878/91670371-0ec84f00-eada-11ea-9e0a-034ff6eee440.png)
The command prompt window will become the console window when Ryujinx launches. The command prompt window will become the console window when Ryujinx launches.
**Option 3:** Custom Shortcut **Option 3:** Custom Shortcut
1. Right-click on your Ryujinx executable and click Send To -> Desktop Shortcut 1. Right-click on your Ryujinx executable and click Send To -> Desktop Shortcut\
![image](https://github.com/user-attachments/assets/923822f1-bc59-40f4-85c1-872420dcfd87)
![image](https://user-images.githubusercontent.com/62343878/91670437-bf365300-eada-11ea-8bde-ce0b1cb7aa73.png) 2. Locate the new shortcut on your desktop and right-click on it, then click Properties\
![image](https://github.com/user-attachments/assets/4ebbc374-2334-4cfd-be12-09e0dc322e96)
2. Locate the new shortcut on your desktop and right-click on it, then click Properties 3. In the Properties window, click into the Target field and add a space onto the end of the existing command. Then add "-r [folderpath]" without quotes where [folderpath] is your own custom data folder full path, and click OK. For example, if your custom data folder was d:\ryujinxdata, the addition you would paste into the target field would be "-r d:\ryujinxdata" without the quotes.\
![image](https://github.com/user-attachments/assets/d68766e3-19c5-481c-82fd-bff86128fe15)
![image](https://user-images.githubusercontent.com/62343878/91670516-8fd41600-eadb-11ea-8eb3-acfb97d64c65.png)
3. In the Properties window, click into the Target field and add a space onto the end of the existing command. Then add "-r [folderpath]" without quotes where [folderpath] is your own custom data folder full path, and click OK. For example, if your custom data folder was d:\ryujinxdata, the addition you would paste into the target field would be "-r d:\ryujinxdata" without the quotes.
![image](https://user-images.githubusercontent.com/62343878/91670585-315b6780-eadc-11ea-8534-244a46eb1536.png)
Note: On MacOS, the command would be as follows, without the quotes: Note: On MacOS, the command would be as follows, without the quotes:
"/Applications/Ryujinx.app/Contents/MacOS/Ryujinx -r /path/to/custom/ryujinx/folder" "/Applications/Ryujinx.app/Contents/MacOS/Ryujinx -r /path/to/custom/ryujinx/folder"
@ -726,10 +772,9 @@ Launch in Fullscreen
Ryujinx can automatically launch games in fullscreen mode. You can enable this functionality in one of two ways: Ryujinx can automatically launch games in fullscreen mode. You can enable this functionality in one of two ways:
**Method One:** In Ryujinx, click on Options, then check the box marked "Start Games in Fullscreen Mode". **Method One:** In Ryujinx, click on Options, then check the box marked "Start Games in Fullscreen Mode".\
![image](https://github.com/user-attachments/assets/4e24d314-8b3e-4689-b7e1-2a896f1d5f1f)
![image](https://user-images.githubusercontent.com/62343878/100805553-173b6900-33ec-11eb-9702-71626f67f6e3.png)
**Method Two:** If you launch Ryujinx from the commandline, add a --fullscreen option. Like so: **Method Two:** If you launch Ryujinx from the commandline, add a --fullscreen option. Like so:\
![image](https://github.com/user-attachments/assets/efe26e20-b8af-4433-91de-bae98433dacd)
![image](https://user-images.githubusercontent.com/62343878/100806049-03dccd80-33ed-11eb-88a4-d5a56ada8bb0.png)