🏆 Playdate Achievements
An open achievement standard for the Playdate console.
- Play Playdate games!
- Earn achievements!
- View them in your Trophy Case!
Playdate Achievements is a community project establishing an open standard for achievements in Playdate™ games. Playdate is fun! Games on Playdate are fun! Achievements in games on Playdate are fun! Having a standard ensures a consistent experience for players, and makes it possible to view achievements earned across games in one place.
Everything On Display
Trophy Case is a dedicated viewer which displays the achievements you’ve earned across all Playdate games in one place. Trophy Case was designed in parallel with the Playdate Achievements standard, providing first-class support for its features and showcasing any games which choose to integrate with it.
Of course, games may also present their earned achievements themselves. Additionally, the open standard makes it possible for others to create dedicated achievement viewer apps in the future.
Show Me the Games!
It’s all about the games. Here’s a (non-comprehensive) list of games that award Playdate Achievements. Made your own? Add it to the list!
* These games are available to play now and will support Playdate Achievements in a future update.
Made a Game for Playdate?
The Playdate Achievements framework makes it quick and easy to add achievements to your game! Check out the Getting Started Guide in the pd-achievements repo, which provides simple instructions along with everything you need to:
- Grant achievements that integrate with Trophy Case.
- Notify players when they earn achievements. (optional)
- Display an in-game achievements viewer. (optional)
Don’t forget to add it to this page when you’re finished!
FAQ
What games support it?
You scrolled too fast! Check out the growing list of games that offer Playdate Achievements above.
How does it work?
Playdate Achievements takes advantage of the Shared/ folder that Playdate makes available to all games. By establishing an open standard for achievements, games can record available and earned achievements in dedicated subfolders which any other game or viewer app can read. This enables apps like Trophy Case to present an aggregated list of all achievements earned across games.
Does it support non-Catalog games?
Yes! Playdate Achievements is an open standard available to all games regardless of whether they’ve been accepted to Catalog or their distribution method. Games hosted on itch.io or your own site are absolutely welcome and fully supported.
Does it work with games made in Pulp?
Pulp games don't have access to the Shared/ folder or Lua code libraries, and therefore aren’t compatible with Playdate Achievements. However, you may be able to integrate the library after using Pulp Mill, a Pulp-to-Lua transpiler.
Can I add Playdate Achievements to my game?
You bet! Check out our getting started guide in the pd-achievements repo on GitHub.
Can I add my game to this page?
Yes! All games that integrate Playdate Achievements are welcome! Follow our game submission guidelines to open a pull request and a member of the community will review and merge the changes.
How do I report a bug?
All framework development occurs in the pd-achievements repo on GitHub. Please open an issue to report any bugs you find. If you find bugs in the Trophy Case viewer app, report them in the separate trophy-case repo.
What if I already implemented my own achievements?
That’s awesome! It’s up to you whether to add support for Playdate Achievements (but we urge you to consider it). The more games that support it, the better it is for the community and the more fun it is for players, who can view all the achievements they've earned together in one place. We've designed the open standard with the goal of supporting most types of achievements, and you can integrate support for Playdate Achievements in parallel with your own implementation, so the cost of migration is low.
Cool, but can it…?
We believe strongly in creating a shared open standard suitable for all Playdate games. The more games that support it, the better the experience for players and the better for the Playdate community as a whole. We need to strike a balance between simplicity (so it’s easy for anyone to integrate) and capability (so that it serves the needs of most games/devs).
If you have ideas for achievements which can’t be…ahem, achieved… using the current standard, join the discussion on Discord or open an issue (or a pull request) in GitHub. Be sure to include a summary of the idea and a clear explanation of the use case it serves. Ideas are more likely to be accepted when they are backwards compatible with the current standard, making them opt-in for those already using Playdate Achievements.
We can’t guarantee all ideas will be accepted, but we absolutely want to hear from you so we can make the standard as effective as possible for everyone in the community, developers and players alike.
How can I contribute?
Fix a bug? Have feature ideas? Want to help make this page awesome? Regardless of your background and skill set, we welcome members of the community to help us make Playdate Achievements the best it can be. Peruse the pd-achievements repo on GitHub and join the discussion in the Playdate Squad Discord to get involved.