成就(Achievement)模組允許開發者讓用戶解鎖成就,清除成就,以及判斷某個成就是否已經解鎖。也允許根據根據進度獲得成就。
默認情況下,成就在持久化文件中存儲訊息。如果Steam平台支持可用並且被啟用,成就訊息會自動與Steam同步。
achievement.
Sync
() link調用achievement.sync()函數的行為。只有當成就未同步的情況下才可用。
achievement.
clear
(name) link清除名為 name 的成就。
achievement.
clear_all
() link清除所有成就。
achievement.
grant
(name) link解鎖名為 name 的成就,前提是該成就尚未解鎖。
achievement.
has
(name) link如果用戶已經解鎖成就 name 就返回True。
achievement.
progress
(name, complete) link報告成就 name 的完成進度,前提是該成就未解鎖。成就 name 必須先定義各完成度。
achievement.
register
(name, **kwargs) link註冊一個成就。成就並不強制需要註冊,但這樣做可以將成就訊息傳給後端。
下列關鍵字參數是可選的。
achievement.
sync
() link同步本地存儲和其他後端(例如,Steam)的註冊成就。
控制成就的配置項包括:
achievement.steam_position
= None link若值不是None,該配置項設置steam彈出通知的位置。該值必須是一個字串,可使用的內容包括“top left”,“top right”,“bottom left”和“bottom right”。
config.steam_appid
= None link若非None,該項應是Steam appid。Ren’Py會在啟動時自動設置此appid。需要使用define語句設置該項。
define config.steam_appid = 12345