GameMaker Studio · GML
Conquistas
Conquistas que você define no painel e desbloqueia a partir do jogo. Cada uma tem uma chave; as ocultas permanecem mascaradas até o jogador as desbloquear.
Defina Conquistas
Crie conquistas no painel, cada uma com uma chave, nome, descrição, ícone, pontos e uma flag opcional de oculta.
Guarde a chave de cada conquista; você a passa para as chamadas de verificação e desbloqueio.
Listando Conquistas
Obtenha o catálogo completo com o estado de desbloqueio do jogador atual e leia 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
}Desbloqueando
Desbloqueie uma conquista para o jogador atual e leia 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 lockedDesbloquear uma conquista já desbloqueada é seguro; o evento reporta already_unlocked.
Verificando Uma
Verifique o estado de uma única conquista, ou obtenha sua definição do painel.
gmda_checkAchievement("first_blood"); // -> achievement_checked (e.response.unlocked)
gmda_getAchievementInfo("first_blood"); // -> achievement_info_loaded