README.en.md

ASFAchievementManagerEx

Based on Rudokhvist/ASF-Achievement-Manager secondary development

中文版本 | Русская Версия

EULA

Modifying statistics / achievements has risky, and modifying statistics / achievements of games protected by VAC may cause VAC banned

Consent to EULA is required to use this plug-in, see Plugin Configuration

Installation

First-Time Install / Manually Update

1. Download the plugin via GitHub Releases page
2. Unzip the ASFAchievementManagerEx.dll and copy it into the plugins folder in the ArchiSteamFarm's directory
3. Restart the ArchiSteamFarm and use ASFAchievementManagerEx or AAM command to check if the plugin is working

ASFEnhance Integration

It's recommended to install ASFEnhance, it can provide plugin update service

Changelog

ASFAchievementManagerEx Version	Depended ASF	Description
1.0.2.0	5.4.12.5	ASF->5.4.12.5, ASFEnhance Integration
1.0.1.2	5.4.10.3	First version

History Version

Plugin Configuration

Configuration key is change to ASFEnhance

ASF.json

{
  //ASF Configuration
  "CurrentCulture": "...",
  "IPCPassword": "...",
  "...": "...",
  //ASFAchievementManagerEx Configuration
  "ASFEnhance": {
    "EULA": true,
    "Statistic": true
  }
}

Configuration	Type	Default	Description
EULA	bool	true	If agree the EULA, if set to true, deemed to agree [EULA]
Statistic	bool	true	Allow send statistics data, it's used to count number of users, this will not send any other information

Commands Usage

Plugin Info

Command	Shorthand	Access	Description
ASFAchievementManagerEx	AAM	FamilySharing	Get the version of ASFAchievementManagerEx

Commands

Command	Shorthand	Access	Description
ALIST [Bots] <AppIds>	-	Operator	Get the bot's achievements list
ASTATS [Bots] <AppIds>	-	Operator	Get the bot's statistics list
AUNLOCK [Bots] AppId <AchievementIds>	-	Master	Unlock the bot's achievements, can't modify the protected achievements
ASET [Bots] AppId <AchievementIds>	-	Master	Same as AUNLOCK (Origin plugin's command)
ALOCK [Bots] AppId <AchievementIds>	-	Master	Lock the bot's achievements, can't modify the protected achievements
ARESET [Bots] AppId <AchievementIds>	-	Master	Same as ALOCK (Origin plugin's command)
AEDIT [Bots] AppId <KeyValues>	-	Master	Edit the bot's Statistics value, the syntax of keyValue is Id=Value, see Usage Example

Usage Example

• ALIST 获取成就列表

  >> ALIST 410110
  << <7> App/410110 的成就列表:
  - 1 ✅ 第一步
  - 2 ❌ 你想听听我的故事吗？
  - 3 ❌ 你真的有兴趣吗？
  - 4 ✅ 后面会更刺激！
  

• ASTATS 获取统计项列表

  >> ASTATS 410110
  << <7> App/410110 的统计数据列表:
    Id  [最小 当前 最大] 名称 | 🔒受保护🔼仅能增加⚠️最大修改量
  - 2   [- 0 99000] Killed enemies with a revolver
  - 3   [- 0 99999] Killed enemies with a gun
  - 4   [- 0 99999] Blowed up enemies
  - 5   [- 0 99999] Killed enemies with a knife
  

• AUNLOCK / ASET 解锁成就

  >> AUNLOCK 410110 1,3,0,a
  << <7> 多行结果:
  警告信息:
  1-第一步: 无需修改该项成就
  0: 找不到此ID的成就
  a: 无效参数, 需要为整数
  
  执行结果:
  设置成就成功, 受影响成就 1 个
  

  插件会自动识别指定 AchievementId 是否已经解锁, 或是被保护, 可以一次解锁多个成就

• ALOCK / ARESET 锁住成就

  >> ALOCK 410110 2,3,0,a
  << <7> 多行结果:
  警告信息:
  2-你想听听我的故事吗？: 无需修改该项成就
  0: 找不到此ID的成就
  a: 无效参数, 需要为整数
  
  执行结果:
  设置成就成功, 受影响成就 1 个
  

• AEDIT 修改统计项

  >> AEDIT 410110 2=5,3=0,4=max,5=default,6=min,7=ss
  << <7> 多行结果:
  警告信息:
  3-Killed enemies with a gun [- 0 99999]: 无需更改的统计项
  5-Killed enemies with a knife [- 0 99999]: 无需更改的统计项
  6-Finished quests [- 0 1000]: 无法设置为最小值, 最小值为Null
  7-Killed animals [- 0 1000]: 无法设置为ss, 参数需要为整数
  
  执行结果:
  设置统计项成功, 受影响统计项 4 个
  

  语法说明 Id=值, 值可为:

  整数: 例如 2=5, 设置 ID 为 2 的统计项为 5

  最小值 min(i): 例如 2=i 或 2=min, 设置 ID 为 2 的统计项为最小值, 如果该项最小值为 null 会设置失败

  最大值 man(a): 例如 2=a 或 2=max, 设置 ID 为 2 的统计项为最大值, 如果该项最大值为 null 会设置失败

  默认值 default(d): 例如 2=d 或 2=default, 设置 ID 为 2 的统计项为默认值, 如果该项默认值为 null 会设置失败

  如果统计项具有保护属性, 则无法由客户端修改

  如果统计项具有只允许递增属性, 则无法设置为低于当前值的值

  如果统计项具有最大修改量属性, 则无法设置差值超过属性的值

---

---

---