Difference between revisions of "SetSteamAchievement"

From The Official Visionaire Studio: Adventure Game Engine Wiki
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="toccolours mw-collapsible mw-collapsed" style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%">
+
==setSteamAchievement==
<b>Command History</b>
 
<div class="mw-collapsible-content">
 
<div style="background:#ebebeb" width="100%">Available since <span style="color:orange">v3.7</span></div>
 
</div></div>
 
  
 +
<div class="command-min-version-info">Available since: <span class="command-min-version">v3.6</span></div>
  
Gets current state of a steam achievement!
+
<div class="command-doc">Sets an achievement to done.
<div class="toccolours mw-collapsible mw-collapsed" style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%">
 
<b>Additional Info</b>
 
<div class="mw-collapsible-content">
 
<div>This command will only work if the steam_api library was included (& successfully loaded) & if a steam account for your game exists!</div>
 
</div></div>
 
  
 +
Note: this command only works if the steam_api library was loaded and if a steam account for your game exists.</div>
  
Syntax:
+
Lua Syntax:
<syntaxhighlight>
+
<pre class="command-syntax">setSteamAchievement(apiName, {flags=1,  
setSteamAchievement(apiName, {flags=1, clear = true|false})
+
    clear = true|false})</pre>
</syntaxhighlight>
+
===Arguments===
 +
====apiName====
 +
:'''"string"''' - The name of the achievement to set. This is the API name specified in the steam account.
 +
===Flags===
 +
====clr/clear====
  
 
+
:If true the achievement will be cleared. Default value is false.
Example:
+
===Return Values===
<syntaxhighlight>
+
;success
n/a
+
:True if the achievement was set successfully, false if the operation failed.
</syntaxhighlight>
+
===Examples===
 
+
None.
 
 
 
 
<b><u>Arguments</u></b>
 
 
 
apiName: "string" <br/>
 
The name of the requested achievement (this is the API name specified in the steam account for your game)
 
 
 
Flags: clr/clear <br/>
 
If true the achievement will be cleared. Default value is false!
 
 
 
Return: success <br/>
 
True if the achievement was set successfully, false if the operation failed!
 
{{i18n|SetSteamAchievement}}
 

Latest revision as of 22:28, 30 September 2014

setSteamAchievement

Available since: v3.6
Sets an achievement to done. Note: this command only works if the steam_api library was loaded and if a steam account for your game exists.

Lua Syntax:

setSteamAchievement(apiName, {flags=1, 
    clear = true|false})

Arguments

apiName

"string" - The name of the achievement to set. This is the API name specified in the steam account.

Flags

clr/clear

If true the achievement will be cleared. Default value is false.

Return Values

success
True if the achievement was set successfully, false if the operation failed.

Examples

None.