steam_set_achievement


Description

With this function you can tell the Steam API to award ("set") an achievement for the player. These achievements should have been defined on the Steamworks control panel accounts page for your game and the string that is passed to the function should match that used as the API Name on the control panel. The Steam Game Overlay will display a notification panel to the user informing them of the achievement that they have received, unless the achievement has already been awarded, in which case nothing will happen.


Syntax:

steam_set_achievement(ach_name);

Argument Description
ach_name The name of the achievement to set (string).


Returns:

N/A


Example:

if hp <= 0
    {
    global.Deaths += 1;
    if global.Deaths == 10
        {
        if !steam_get_achievement("ach_Player_Dies_Ten_Times") steam_set_achievement("ach_Player_Dies_Ten_Times");
        }
    }

The above code will reward the player an achievement if the global variable "Deaths" is equal to 10 and if the achievement has not already been awarded.