Succès pour les jeux PlayDrop

{
  "achievements": [
    { "key": "first-win", "displayName": "First flag", "description": "Reach the flag once",
      "kind": "STANDARD", "icon": "achievements/first-win.png" },
    { "key": "collector", "displayName": "Collector", "description": "Collect 100 stars",
      "kind": "INCREMENTAL", "maxProgress": 100, "icon": "achievements/collector.png" },
    { "key": "secret-room", "displayName": "Secret room", "description": "Find the hidden room",
      "kind": "STANDARD", "hidden": true, "icon": "achievements/secret-room.png" }
  ]
}

• key suit le même format que les clés de classement.
• kind vaut STANDARD (débloqué une seule fois) ou INCREMENTAL (débloqué quand la progression atteint maxProgress, un entier positif).
• icon est un PNG inclus dans le paquet. Utilisez une image carrée et nette, lisible en petit format.
• hidden: true garde le nom et la description secrets jusqu’au déblocage.

Les clés publiées ne peuvent pas être supprimées, et kind, maxProgress et hidden ne peuvent pas changer. Retirez un succès avec "status": "RETIRED".

await sdk.achievements.unlock("first-win");
await sdk.achievements.setProgressAtLeast("collector", starsCollected);

const { achievements } = await sdk.achievements.list();
const { achievement } = await sdk.achievements.get("collector");

• setProgressAtLeast prend le total atteint jusqu’ici, jamais un incrément. La progression ne fait qu’augmenter, est plafonnée à maxProgress et débloque le succès à ce seuil.
• Les deux appels renvoient { accepted, changed, unlocked, progress, unlockedAt, achievement } ; changed vaut false quand rien de nouveau ne s’est produit, ce qui vous permet d’afficher votre propre notification une seule fois.
• list({ includeHiddenDefinitions: true, includeRetired: true }) inclut les définitions cachées et retirées.

Ne débloquez des succès que pendant une vraie partie, jamais dans les aperçus ni les captures. Sans aucune session de joueur, les appels aboutissent sans que rien soit enregistré.

Mélangez des succès précoces qui apprennent à jouer et des objectifs à long terme. Nommez l’action, pas la récompense : « Gagner sans subir de dégâts » dit quoi faire. Une douzaine de succès bien pensés valent mieux qu’une centaine de succès anodins.