Skip to content

CatPoweredPlugins/ASFAchievementManager

Repository files navigation

ASF Achievement Manager

DISCLAIMER

This plugin is provided on AS-IS basis, without any guarantee at all. Author is not responsible for any harm, direct or indirect, that may be caused by using this plugin. You use this plugin at your own risk.

Introduction

This plugin for ASF allows you to view, set and reset achievements in steam games, similar to SAM. Works only with ASF v4.0+ (make sure to check actual required version in release notes).

Installation

  • download ASFAchievementManager.zip file from latest release.
  • create new folder (for example, ASFAchievementManager) in the plugins folder of your ASF installation
  • unpack downloaded .zip file to the folder you just created.
  • optionally, configure plugin properties in ASF.json file (see below).
  • (re)start ASF, you should get a message indicating that plugin loaded successfully.

Usage

After installation, you can use those commands (only for accounts with Master+ permissions):

alist <bots> <appids>

Displays current status of achievements in specified games on given bots. You can specify multiple bots and multiple appids.
Example of output:
alist output example
Unlocked achievements are marked as ✅, still locked as ❌. If achievement has mark ⚠️ next to it - it means this achievement is server-side, and can't be switched with this plugin.
Examples:
alist bot1 370910,730
alist bot1,bot2 370910

aset <bots> <appid> <achievements>

Sets (unlocks) achievements with specified numbers in provided appid on given bots. Please note that, unlike alist, you can provide only one appid here. Achievement numbers corresponds to the ones showed by alist command. You can provide * instead of achievements list to set all available achievements.
Examples:
aset bot1 370910 1,2,5
aset bot1,bot2 370910 1
aset bot1 370910 *

areset <bots> <appid> <achievements>

Resets (locks) achievements with specified numbers in provided appid on given bots. Please note that, unlike alist, you can provide only one appid here. Achievement numbers corresponds to the ones showed by alist command. You can provide * instead of achievements list to reset all available achievements.
Examples:
areset bot1 370910 1,2,5
areset bot1..bot3 370910 2
areset bot1 370910 *

Configuration

This plugins adds one additional property in global ASF config (ASF.json).

Rudokhvist.AchievementsCulture

Property of string type, with default value equal to null, that determines in what language you want to see achievement names, if available. If value is null, or invalid culture is provided, plugin will fallback to the global culture set in ASF (see CurrentCulture). Accepted values are the same as for CurrentCulture global ASF property, but please note that only languages actually provided in steam could be displayed, if there is no specified language provided in Steam - plugin will fallback to English names.

Example:

"Rudokhvist.AchievementsCulture":"uk-UA"

downloads PayPal donate Ko-Fi donate BTC donate LTC donate Steam donate