mirror of
https://github.com/stenzek/duckstation.git
synced 2025-11-23 06:59:30 +00:00
3
Using RAIntegration
Connor McLaughlin edited this page 2025-04-10 02:26:34 +10:00
DuckStation now supports using RAIntegration for cheevos instead of its own internal handler, which is useful for developing achievement sets.
The RAIntegration support is intended as a developer tool, and users should use the much more user-friendly internal achievement support instead.
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:
- Download
RA_Integration-x64.dllfrom 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 - Rename
RA_Integration-x64.dlltoRA_Integration.dll, and move it into the DuckStation binary directory (same place with the other exes). - Open
settings.iniin the User Directory. - Find the
[Cheevos]section, and changeUseRAIntegrationtotrue(UseRAIntegration = true). If you're not using a new install, this line won't exist, and you'll have to add it. - Start DuckStation as normal. You will be prompted to log in to RetroAchivements the first time you start.
- Enable the debug menu (
Advanced Settings -> Show Debug Menu), and there will be aRAIntegrationsubmenu at the top which you can use to interact with RAIntegration.
As of the preview build released on 2025/04/10, RAIntegration is enabled through rc_client. You can enable it by simply checking the "Enable RAIntegration" option under Achievements settings, steps 2 through 6 are not necessary. You still need to download the DLL, the option will be disabled if it does not exist.