Skip to content

Using RAIntegration

Jump to bottom
Connor McLaughlin edited this page Apr 9, 2025 · 3 revisions

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:

  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.
  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.

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.

Clone this wiki locally