Welcome to the RetroAchievements documentation project!

Newcomers, please start with the FAQ.

We encourage all community members to join our Discord chat server, we use this for most communication.

You can help to improve these docs editing/creating the pages at RetroAchievements wiki.

Developer docs

A brief description of each Achievement developer page you'll see here.

  1. Getting Started as an Achievement Developer: it's for the very first contact with cheevos development tools (Memory Inspector and other Achievements dialogs). IF YOU ARE A COMPLETE NEWBIE, START HERE!

  2. Achievement Logic Features: describes the available tools a developer have in order to improve the logic behind the achievements, such as delta values, hit counts, ResetIf, PauseIf, Alt groups, etc.

  3. Real Examples: showing real examples and breaking down the logic behind them. AWESOME LEARNING RESOURCE!

  4. Tips and Tricks: general tips and tricks about memory digging and achievement creation.

  5. Console Specific Tips: knowing the peculiarities of your favorite console can help you with memory digging.

  6. Achievement Templates: some generic templates to get inspiration.

  7. Difficulty Scale and Balance: guidelines/suggestions on how to balance the difficulty of your achievement set.

  8. Badge and Icon Creation: some guidelines and tips about badge/icon creation.

  9. Leaderboards: instructions on how to create Leaderboards for a game.

  10. Rich Presence: how to write Rich Presence Scripts.

  11. Set Development Roadmap: suggestions of steps to take in order to create a really neat achievement set.

  12. Achievement Design: a guide on how to think about and design good achievements, not the technical side but the conceptual.

  13. Bonus Set Guide: an advanced topic on creating special challenge sets and how to release them.

  14. Achievements for ROM Hacks: a detailed guide for developers on the proper inclusion (and approval) of ROM Hacks.