diff --git a/Ryujinx-Setup-&-Configuration-Guide.md b/Ryujinx-Setup-&-Configuration-Guide.md index 64819b2..eed4760 100644 --- a/Ryujinx-Setup-&-Configuration-Guide.md +++ b/Ryujinx-Setup-&-Configuration-Guide.md @@ -28,6 +28,8 @@ Ryujinx checks for updates automatically at startup. You can disable this featur [Managing Mods](#managing-mods) +[Managing Cheats](#managing-cheats) + [Input Configuration](#input-configuration) [Motion Controls](#motion-controls) @@ -294,6 +296,76 @@ This will open the `AppData\Roaming\Ryujinx\mods\contents\\` folder. ![image](https://user-images.githubusercontent.com/62343878/87071634-b3fc3080-c1d7-11ea-8a28-a1aa86009f5c.png) +Managing Cheats +=============== + +Ryujinx now has native cheats/runtime mods support! +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 + +Two good places to acquire Atmosphere cheats are: + +- https://github.com/WerWolv/EdiZon_CheatsConfigsAndScripts/tree/master/Cheats (general switch cheats) +- https://yuzu-emu.org/wiki/switch-mods/ (emulator-specific mods such as high FPS, ultrawide, etc...) + +Inside the cheat `zip`, `rar`, or other archive format, there is usually a file structure like this: + +``` +Cheat_Name\cheats\0123456789ABCDEF.txt +``` + +Where `0123456789ABCDEF` will vary according to the game and the cheat (this is the build id of the executable the cheat attaches itself to). A cheat can also contain several `txt` files. **Cheats are game-specific and version-specific, they will not work if transferred from one game to another or to an incompatible update of the game.** + +To install the cheat: + +- Open Ryujinx, right-click the game you wish to install the cheat and select to open its `Mod directory`; +- A directory like this will open: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\`, `XXXXXXXXXXXXXXXX` will be the id of the chosen game; +- Extract the cheat archive to the mod directory, keeping the cheat name: `Ryujinx\mods\contents\XXXXXXXXXXXXXXXX\Cheat_Name\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. + +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. + +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: + +``` +[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 +``` Input Configuration ===================