ASF支援各種命令，這些命令可用於控制進程和機械人實例的行為。

以下命令可以通過各種不同的方式發送到機械人：

• 通過互動式 ASF 主控台
• 通過 Steam 私人聊天/群組聊天
• 通過我們的 IPC 介面

請注意，與 ASF 交互需要您擁有相關命令的許可權。 查看 SteamUserPermissions 和 SteamOwnerID 配置屬性了解更多。

所有通過 Steam 聊天發送的命令都受 CommandPrefix 全域配置屬性​影響，該屬性的預設值為!。 這意味著，當您要執行 status 命令時，實際應該發送 !status（或者使用您自訂的 CommandPrefix）。 CommandPrefix 不是強制性的，當您使用主控台或 IPC 時可以省略。

ASF has support for interactive console, as long as you're not running ASF in Headless mode. Simply press c button in order to enable command mode, type your command and confirm with enter.

您也可以通過 Steam 聊天向給定的 ASF 機械人發送命令。 顯然，您不能自言自語，因此，如果您想執行針對自己的命令，您至少需要另一個機械人帳戶。

同樣，您也可以使用給定Steam組的群聊。 請注意，此選項需要您正確設置 SteamMasterClanID 屬性，使機械人同樣監聽（並加入）指定的群組聊天。 這也可以用於「與自己交談」，因為它與私人聊天相反，不需要專用的機械人帳戶。 您只需將SteamMasterClanID屬性設置為新創建的群組，然後通過機械人的SteamOwnerID或SteamUserPermissions為您自己授予訪問權限。 這樣，ASF 機械人（即您自己的帳戶）將會加入這個群組和群組聊天室，並且開始監聽您發送的命令。 您可以加入同一個群組聊天室，以便向自己發送命令（因為在您向聊天室發送命令時，同樣在聊天室內的 ASF 實例將會收到命令，即使界面上顯示只有您自己在聊天室內）。

請注意，向群聊發送命令的行為類似于中繼。 如果您向一個含有 3 個機械人的群組聊天發送 redeem X ，其效果等同於分別在私人聊天中向每個機械人發送 redeem X。 在大多數情況下，這不是您想要的效果，您應該像之前與單個機械人交談時一樣，向特定機械人發送命令。 ASF 支持群組聊天，當且僅當您有唯一的機械人時，它是一種有效的通信方式，但如果您的群組中有多個 ASF 機械人，就最好不要在這裏執行命令，除非您完全理解 ASF 的相關行為，並且您確實想要讓所有的機械人執行相同的命令。

And even in this case you should use private chat with [Bots] syntax instead.

這是最先進、靈活的執行命令方式，非常適合用戶集成（ASF-ui）或者第三方工具腳本（ASF API）。這種方式需要 ASF 運行在 IPC 模式下，並且客戶端需要通過 IPC 介面來執行命令。

所有的命令都不區分大小寫，但它們的參數（例如機械人名稱）通常是區分大小寫的。

Arguments follow UNIX philosophy, square brackets [Optional] indicate that given argument is optional, while angle brackets <Mandatory> indicate that given argument is mandatory. You should replace the arguments that you want to declare, such as [Bots] or <Nickname> with actual values that you want to issue the command with, omitting the braces.

[Bots] argument, as indicated by the brackets, is optional in all commands. 當指定該參數時，指令會在指定的機械人上執行。 When omitted, command is executed on current bot that receives the command (Steam chat), or in according to DefaultBot configured property (IPC and interactive console).

As an example, status A sent to bot B is the same as sending status to bot A, bot B in this case acts only as a proxy. This can also be used for sending commands to bots that are unavailable otherwise, for example starting stopped bots, or executing actions on your main account (that you're using for executing the commands).

Access of the command defines minimum EPermission of SteamUserPermissions that is required to use the command, with an exception of Owner which is SteamOwnerID defined in global configuration file (and highest permission available).

Plural arguments, such as [Bots], <Keys> or <AppIDs> mean that command supports multiple arguments of given type, separated by a comma. For example, status [Bots] can be used as status MyBot,MyOtherBot,Primary. 這樣，該命令會在所有目標機械人上執行，效果等同分別向所有機械人單獨發送 status命令。 Please note that there is no space after the comma ,.

ASF 使用所有空白字元作為命令的分隔符號，例如空格和換行符。 這意味著您不僅可以使用空格來分隔參數，還可以使用任何其他空白字元（如選項卡或換行符號）。

ASF 會將命令末尾超出規定範圍的多餘參數「聯接」到符合語法規定的最後一個參數上。 This means that redeem bot key1 key2 key3 for redeem [Bots] <Keys> will work exactly the same as redeem bot key1,key2,key3. 當您同時使用換行作為命令分隔符號，就可編寫redeem bot，然後粘貼由任何可接受的分隔符號 (如分行符號) 或標準 ， ASF分隔符號分隔的序號清單。 Keep in mind that this trick can be used only for command variant that uses the most amount of arguments (so specifying [Bots] is mandatory in this case, otherwise your first key would be interpreted as the target bot to execute command on).

如上所述，空白字元被用作命令的分隔符號，因此它不能在參數中使用。 但是，如上所述，ASF可以聯接超出範圍的參數, 這意味著您實際上能夠在參數中使用空白字元，該字元被定義為給定命令的最後一個字元。 例如，nickname bob Great Bob 將正確地將機械人 bob 的昵稱設置為「Great Bob」。 與此類似，您可以使用owns 命令檢查含有空格的名稱。

Commands expecting AppID or SubID are also smart enough to extract that information out of store.steampowered.com links.

Some commands are also available with their aliases, mostly to save you on typing or account for different dialects:

[Bots] argument is a special variant of plural argument, as in addition to accepting multiple values it also offers extra functionality.

First and foremost, [Bots] argument supports predefined "bot groups", which are defined as below:

For example, status ASF command is equal to status all,your,bots,listed,here. 這也可用於輕鬆識別您有權訪問的機械人，因為儘管 ASF 關鍵字的目標是所有機械人，但只有您能夠實際發送指令的機械人才會作出響應。 Other groups are also available in order to more easily execute given command only on specific bots meeting the condition.

[Bots] argument also supports special "range" syntax, which allows you to choose a range of bots more easily. The general syntax for [Bots] in this case is [FirstBot]..[LastBot]. At least one of the arguments must be defined. When using <FirstBot>.., all bots starting from FirstBot are affected. When using ..<LastBot>, all bots until LastBot are affected. When using <FirstBot>..<LastBot>, all bots within range from FirstBot until LastBot are affected. 例如，如果您有名為 A, B, C, D, E, F的機械人，在這種情況下，执行 status B..E的效果等於执行 status B,C,D,E 。 使用此語法時，ASF將使用字母排序，以决定哪些機械人在指定的範圍內。 Arguments must be valid bot names recognized by ASF, otherwise range syntax is entirely skipped.

In addition to range syntax above, [Bots] argument also supports regex matching. You can activate regex pattern by using r!<Pattern> as a bot name, where r! is ASF activator for regex matching, and <Pattern> is your regex pattern. An example of a regex-based bot command would be status r!^\d{3} which will send status command to bots that have a name made out of 3 digits (e.g. 123 and 981). Feel free to take a look at the docs for further explanation and more examples of available regex patterns.

<Settings>參數擁有多至 7 個不同的選項，使用逗號分隔。 這些選項，按順序分別是：

For description of above fields, please visit Steam privacy settings.

每個選項的有效值可以是：

您可以使用它們的名稱（不區分大小寫）或者數值。 省略的參數將會被設置為預設值 Private。 It's important to note dependencies specified above, as the property given entry depends on specifies the most open permission that entry can have.

For example, you can't have Public playtime setting while having Private owned games setting, but you can totally have Private owned games setting while having Public profile.

如果您希望將機械人 Main 的所有隱私設置都設置為 Private，可以使用以下任一命令：

privacy Main 1
privacy Main Private

這是因為 ASF 會預設所有未賦值選項為 Private，所以您不需要全部寫出它們。 另一方面，如果您希望設置所有選項為 Public，可以使用以下任一命令：

privacy Main 3,3,3,3,3,3,3
privacy Main Public,Public,Public,Public,Public,Public,Public

也可以為每個選項設置不同的值：

privacy Main Public,FriendsOnly,Private,Public,Public,Private,Public

上述命令將會設置個人資料為公開、遊戲詳情為僅限好友、遊戲時間為私密、好友列表為公開、物品庫為公開、物品庫禮物為私密、留言為公開。 若有需要，您也可以使用數字值來實現相同效果。

addlicense and rmlicense commands support two different license types, those are:

The distinction is important, as ASF will use Steam network method for apps, and Steam store method for packages. Those two are not compatible with each other.

When activating new licenses, typically you'll want to specify app for free weekends/permanently F2P games, and package otherwise.

For removal of existing license, both methods will work, although we recommend to remove packages in order to have deterministic and explicit request, as otherwise Steam might remove packages you didn't intend to be removed, especially if your account has more than one package granting access to given app. This is because under the hood, license is always identified by the package it grants access to, so if you decide to remove by appID, then Steam decides which subID it's going to remove.

We recommend to explicitly define the type of each entry in order to avoid ambiguous results, but for the backwards compatibility, if you omit type entirely, ASF will assume that you ask for sub in this case. You can also query one or more of the licenses at the same time, using standard ASF , delimiter.

Complete command examples:

addlicense ASF app/292030
addlicense ASF sub/303386
rmlicense ASF app/292030,sub/303386

owns command supports several different game types for <games> argument that can be used, those are:

We recommend to explicitly define the type of each entry in order to avoid ambiguous results, but for the backwards compatibility, if you supply invalid type or omit it entirely, ASF will assume that you ask for app if your input is a number, and name otherwise. You can also query one or more of the games at the same time, using standard ASF , delimiter.

Complete command example:

owns ASF app/292030,name/Witcher

redeem^ 命令允許您微調用於單個兌換場景的模式。 This works as temporary override of RedeemingPreferences bot config property.

<Modes> 參數接受多個模式值，通常用逗號分隔。 可用的模式值如下所示：

例如，我們打算為尚未擁有遊戲的機械人兌換 3 個金鑰，但不包括 primary 機械人。 為此我們需要執行命令：

redeem^ primary FF,SI key1,key2,key3

需要注意的是，進階激活模式只會覆蓋您在命令中使用的RedeemingPreferences選項。 舉例來說，如果您在 RedeemingPreferences 中啟用了 Distributing，則無論是否使用 FD 模式，都不會有任何區別，因為您已激活了RedeemingPreferences。 這就是為什麼每個可強制啟用的重寫也有一個可強制禁用的選項，若有需要，您可以決定在啟用的情況下強制覆蓋，反之亦然。

encrypt command allows you to encrypt arbitrary strings using ASF's encryption methods. <encryptionMethod> must be one of the encryption methods specified and explained in security section. We recommend to use this command through secure channels (ASF console or IPC interface, which also has a dedicated API endpoint for it), as otherwise sensitive details might get logged by various third-parties (such as chat messages being logged by Steam servers).

hash command allows you to generate hashes of arbitrary strings using ASF's hashing methods. <hashingMethod> must be one of the hashing methods specified and explained in security section. We recommend to use this command through secure channels (ASF console or IPC interface, which also has a dedicated API endpoint for it), as otherwise sensitive details might get logged by various third-parties (such as chat messages being logged by Steam servers).

input command can be used only in Headless mode, for inputting given data via IPC or Steam chat when ASF is running without support for user interaction.

General syntax is input [Bots] <Type> <Value>.

<Type> 不區分大小寫，並定義由ASF識別的輸入類型。 當前，ASF可識別以下類型：

<Value> is value set for given type. 當前，所有值都是字串。

假設我們有一個未啟用2FA，僅由 SteamGuard保護的機械人。 We want to launch that bot with Headless set to true.

為此，我們需要執行以下命令：

start MySteamGuardBot -> Bot will attempt to log in, fail due to AuthCode needed, then stop due to running in Headless mode. 我們需要這樣做的目的是使Steam網絡通過電子郵件向我們發送驗證代碼──如果不需要這樣做，我們將完全跳過這一步。

input MySteamGuardBot SteamGuard ABCDE -> We set SteamGuard input of MySteamGuardBot bot to ABCDE. 當然，在這種情況下，ABCDE是我們在電子郵件中獲得的驗證代碼。

start MySteamGuardBot -> We start our (stopped) bot again, this time it automatically uses auth code that we set in previous command, properly logging in, then clearing it.

同樣，我們可以訪問受2FA 保護的機械人 (如果它們不使用 ASF 2FA)，只需在運行時設置其他必需的屬性。

ASF recognizes following rarities:

Not recognized by ASF rarities (other than defined above) will be defined as Unknown.