GameMaker Studio · GML
Succes
Les succes se definissent dans le panneau et se debloquent depuis le jeu. Chacun possede une cle ; les succes caches restent masques jusqu'a ce que le joueur les debloque.
Definir les Succes
Creez les succes dans le panneau, chacun avec une cle, un nom, une description, une icone, des points, et un indicateur optionnel cache.
Sauvegardez chaque cle de succes ; vous la passez aux appels de verification et de deblocage.
Lister les Succes
Recuperez le catalogue complet avec l'etat de deblocage du joueur actuel et lisez achievements_loaded.
gmda_listAchievements(); // -> achievements_loaded (e.response.achievements)# achievements_loaded -> achievements: Array, each:
{
"achievement_key": String,
"name": String,
"description": String,
"icon_url": String,
"points": int,
"is_hidden": bool,
"sort_order": int,
"unlocked": bool,
"unlocked_at": String # null while locked
}Debloquer
Debloquez un succes pour le joueur actuel et lisez achievement_unlocked.
gmda_unlockAchievement("first_blood"); // -> achievement_unlocked// achievement_unlocked -> e.response:
{ "success": true, "already_unlocked": false }
// achievement_checked -> e.response:
{ "unlocked": true, "unlocked_at": "2026-06-07T18:00:00.000Z" } // null while lockedDebloquer un succes deja debloque est sans risque ; l'evenement signale already_unlocked.
Verifier un Succes
Verifiez l'etat d'un seul succes, ou recuperez sa definition du panneau.
gmda_checkAchievement("first_blood"); // -> achievement_checked (e.response.unlocked)
gmda_getAchievementInfo("first_blood"); // -> achievement_info_loaded