diff --git a/Using-RAIntegration.md b/Using-RAIntegration.md new file mode 100644 index 0000000..4b65a3d --- /dev/null +++ b/Using-RAIntegration.md @@ -0,0 +1,17 @@ +DuckStation now supports using RAIntegration for cheevos instead of its own internal handler, which is useful for developing achievement sets. + +To use RAIntegration, you must be: + - Using the Qt frontend. + - Using the x64 DuckStation build (there's no RAIntegration binaries for ARM64). + - Using the Windows build (there's no RAIntegration for other platforms). + +To enable: + +1. Download `RA_Integration-x64.dll` from retroachievements.org. We have specifically disabled the auto-downloading in RAInterface, because it doesn't use TLS, and is therefore not safe to download and execute code since it's vulnerable to MITM attacks. Link: https://retroachievements.org/bin/RA_Integration-x64.dll +2. Rename `RA_Integration-x64.dll` to `RA_Integration.dll`, and move it into the DuckStation binary directory (same place with the other exes). +3. Open `settings.ini` in the [User Directory](https://github.com/stenzek/duckstation#user-directories). +4. Find the `[Cheevos]` section, and change `UseRAIntegration` to `true` (`UseRAIntegration = true`). If you're not using a new install, this line won't exist, and you'll have to add it. +5. Start DuckStation as normal. You will be prompted to log in to RetroAchivements the first time you start. +6. Enable the debug menu (`Advanced Settings -> Show Debug Menu`), and there will be a `RAIntegration` submenu at the top which you can use to interact with RAIntegration. + +