ASF unterstützt eine Vielzahl von Befehlen, mit denen das Verhalten der Prozess- und Bot-Instanzen gesteuert werden kann.

Die folgenden Befehle können auf verschiedene Weise an den Bot gesendet werden:

• Durch die interaktive ASF-Konsole
• Durch den privaten Steam-Chat / Gruppen-Chat
• Durch unsere IPC Schnittstelle

Bedenken Sie, dass die ASF-Interaktion von Ihnen verlangt, dass Sie für den Befehl gemäß den ASF-Berechtigungen berechtigt sind. Weitere Informationen finden Sie in den Konfigurationseigenschaften SteamUserPermissions und SteamOwnerID.

Befehle die über den Steam-Chat ausgeführt werden, sind von der globalen Konfigurationseigenschaft CommandPrefix betroffen, welche standardmäßig ! ist. Das bedeutet, dass Sie beispielsweise für die Ausführung von dem Befehl status tatsächlich !status (oder einen benutzerdefinierten CommandPrefix Ihrer Wahl) verwenden müssen. CommandPrefix ist bei Verwendung von IPC oder der Konsole nicht zwingend erforderlich und kann weggelassen werden.

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

Du kannst den Befehl zum angegebenen ASF-Bot auch über den Steam-Chat ausführen. Natürlich kannst du nicht direkt mit dir selbst sprechen, deshalb brauchst du mindestens ein weiteres Bot-Konto, wenn du Befehle ausführen willst, die auf dein Haupt-Konto abzielen.

In ähnlicher Weise kannst du auch den Gruppen-Chat einer bestimmten Steam-Gruppe verwenden. Beachte, dass diese Option die korrekt eingestellte Eigenschaft SteamMasterClanID erfordert. In diesem Fall wird der Bot auch im Gruppen-Chat auf Befehle warten (und sich bei Bedarf diesem anschließen). Dies kann auch für "Selbstgespräche" genutzt werden, da diese Variante kein dediziertes Bot-Konto erfordert, im Gegensatz zum privaten Chat. Sie können einfach die SteamMasterClanID-Eigenschaft auf die neu erstellte Gruppe setzen und sich dann entweder über SteamOwnerID oder SteamUserPermissions Zugriff auf Ihren eigenen Bot gewähren. Auf diese Weise tritt der ASF-Bot (Du) der Gruppe bei und chattet mit der ausgewählten Gruppe und hört auf die Befehle von deinem eigenen Konto. Du kannst dem gleichen Gruppen-Chatroom beitreten, um dir selbst Befehle zu erteilen (Achtung: Wenn eine ASF-Instanz diesem Chatroom beigetreten ist wird diese ebenfalls sämtliche Befehle empfangen, die an diesen Chat gesendet werden, selbst wenn dieser anzeigt, dass nur dein Konto im Chat ist).

Bitte bedenken Sie, dass das Senden eines Befehls an den Gruppen-Chat wie ein Relais funktioniert. Wenn Sie redeem X zu drei Ihrer Bots senden, die zusammen mit Ihnen im Gruppen-Chat sind, wird es das gleiche Ergebnis haben, wie wenn Sie redeem X an jeden einzelnen von ihnen privat senden würden. In den meisten Fällen ist dies nicht das, was du willst, und stattdessen solltest du den Befehl given bot verwenden, der an einen einzelnen Bot im privaten Fenster gesendet wird. ASF unterstützt den Gruppen-Chat, da es in vielen Fällen eine nützliche Quelle für die Kommunikation mit einem einzigen Bot sein kann, aber Sie sollten fast nie einen Befehl im Gruppen-Chat ausführen, wenn dort zwei oder mehr ASF-Bots sitzen, es sei denn, Sie verstehen das hier beschriebene ASF-Verhalten vollständig und du wollen tatsächlich den gleichen Befehl an jeden einzelnen Bot weitergeben, der auf Sie hört.

Und selbst in diesem Fall sollten Sie stattdessen den privaten Chat mit dem Syntax [Bots] benutzen.

Die fortschrittlichste und flexibelste Art der Befehlsausführung. Perfekt geeignet für die Benutzerinteraktion (ASF-ui), für Drittanbieter-Programme oder Skripte (ASF-API). Diese Variante erfordert, dass ASF im IPC Modus ausgeführt wird und einen Client der Befehle über die IPC Schnittstelle ausführt.

Bei Befehlen selbst ist die Groß- und Kleinschreibung egal, aber bei deren Argumenten (wie zum Beispiel Bot-Namen) muss die Groß- und Kleinschreibung beachtet werden.

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. Wenn verwendet, wird der Befehl auf den angegebenen Bots ausgeführt. Ohne diese Angabe wird der Befehl auf dem Bot ausgeführt, der den Befehl erhält. Mit anderen Worten: Wenn status A an Bot B gesendet wird ist es dasselbe wie wenn status an Bot A gesendet wird. Bot B dient in diesem Fall nur als Proxy. Dies kann auch zum Senden von Befehlen an Bots verwendet werden, die andernfalls nicht verfügbar sind. Zum Beispiel das Starten angehaltener Bots oder die Ausführung von Aktionen auf Ihrem Hauptkonto (welches Sie für die Ausführung der Befehle verwenden).

Zugriff eines Befehls definiert die minimale EPermission von SteamUserPermissions, die für die Verwendung des Befehls erforderlich ist - mit Ausnahme von Owner der als SteamOwnerID in der globalen Konfigurationsdatei (und damit höchste verfügbare Berechtigung) definiert ist.

Mehrere Argumente, wie [Bots], <Keys> oder <AppIDs> bedeuten, dass der Befehl mehrere, mit Komma getrennte, Argumente eines gegebenen Typs unterstützt. status [Bots] kann zum Beispiel als status MyBot,MyOtherBot,Primär verwendet werden. Dies führt dazu, dass der angegebene Befehl auf alle Ziel-Bots auf die gleiche Weise ausgeführt wird, wie wenn du status an jeden Bot in einem separaten Chat-Fenster senden würdest. Bitte beachten Sie, dass nach , kein Leerzeichen steht.

ASF verwendet alle Whitespace-Zeichen als mögliche Trennzeichen für einen Befehl, wie Leerzeichen und Zeilenumbrüche. Das bedeutet, dass Sie zur Begrenzungen der Argumente keine Leerzeichen verwenden müssen. Sie können auch jedes andere Whitespace-Zeichen (z. B. Tabulator oder Zeilenumbruch) verwenden.

ASF wird zusätzliche "Out-of-Range"-Argumente mit dem Plural-Typ des letzten "In-Range"-Arguments "verbinden". Dies bedeutet, dass redeem bot key1 key2 key3 für redeem [Bots] <Keys> genauso funktionieren wird, wie redeem bot key1,key2,key3. Da ein Zeilenumbruch als Trennzeichen verwendet werden kann ermöglicht Ihnen dies, redeem bot zu schreiben und dann eine Liste von Produktschlüsseln einzufügen, die durch ein beliebiges zulässiges Trennzeichen (z. B. Zeilenumbruch) oder dem Standard , ASF-Trennzeichen getrennt sind. Bedenken Sie, dass dieser Trick nur für eine Befehlsvariante verwendet werden kann, die die meiste Anzahl von Argumenten verwendet (daher ist die Angabe von [Bots] in diesem Fall notwendig).

Wie Sie oben gelesen haben, wird ein Leerzeichen als Trennzeichen für einen Befehl verwendet, daher kann es nicht in Argumenten verwendet werden. Allerdings kann ASF auch, wie oben erwähnt, "Out-of-Range"-Argumente verbinden, was bedeutet, dass Sie tatsächlich ein Leerzeichen in Argumenten verwenden könnten, das als letztes für den angegebenen Befehl definiert ist. Zum Beispiel, nickname bob Great Bob wird den Benutzernamen des Bots bob richtig auf "Great Bob" setzen. Auf die gleiche Weise können Sie Namen, die Leerzeichen enthalten, im Befehl owns überprüfen.

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

[Bots] Argument ist eine spezielle Variante des Plural Arguments, da es neben der Annahme mehrerer Werte auch zusätzliche Funktionalität bietet.

Es gibt zunächst ein spezielles Schlüsselwort ASF, das als "alle Bots im Prozess" fungiert, sodass der Befehl status ASF gleich status all,your,bots,listed,here ist. Dies kann auch verwendet werden, um die Bots zu identifizieren, auf die Sie Zugriff haben, da das ASF-Schlüsselwort, trotz der Ausrichtung auf alle Bots, nur von den Bots eine Antwort generiert, an die Sie den Befehl tatsächlich senden können.

Das Argument [Bots] unterstützt eine speziellen "range"-Syntax, der es ermöglicht, einen Reihe von Bots einfacher auszuwählen. The general syntax for [Bots] in this case is <FirstBot>..<LastBot>. Wenn Sie zum Beispiel Bots mit den Namen A, B, C, D, E, F haben, können Sie status B..E ausführen, was in diesem Fall gleich status B,C,D,E ist. Bei Verwendung dieser Syntax verwendet ASF die alphabetische Sortierung, um festzustellen, welche Bots sich in dem von Ihnen angegebenen Bereich befinden. FirstBot and LastBot must be valid bot names recognized by ASF, otherwise range syntax is entirely skipped.

Zusätzlich zum obigen range-syntax unterstützt das [Bots] Argument auch regex Übereinstimmung. Du kannst Regex Muster aktivieren, indem du r!<Pattern> als Bot-Namen verwendest, wobei r! der ASF-Aktivator für den Regex Abgleich ist, und <Pattern> dein Regex-Muster ist. 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). Zögere nicht einen Blick auf die Dokumentation zu werfen, um weitere Erklärungen und Beispiele für verfügbare Regex-Muster zu erhalten.

<Settings> Argument akzeptiert bis zu 7 verschiedene Optionen, getrennt wie üblich durch das standard ASF-Trennzeichen, das Komma. Diese sind, in der Reihenfolge:

Für eine Beschreibung der oben genannten Felder besuche bitte die Steam Privatsphäre-Einstellungen.

Für alle Argumente sind folgende Werte gültig:

Sie können entweder den case-insensitiven Namen oder den numerischen Wert verwenden. Argumente, die weggelassen wurden, werden standardmäßig auf Private gesetzt. Es ist wichtig, die Beziehung zwischen Untergruppe (Kind) und Hauptgruppe (Eltern) von oben genannten Argumenten zu beachten, da das Kind nie mehr Berechtigung haben kann als sein Elternteil. Zum Beispiel kannst du Spiele im Besitz nicht auf Public haben, während dein Profil auf Private steht.

Wenn du alle Privatsphäre-Einstellungen deines Bots namens Main auf Private setzen möchtest, kannst du jede der folgenden Optionen verwenden:

privacy Main 1
privacy Main Private

Dies liegt daran, dass ASF automatisch alle anderen Einstellungen als Private ansieht, sodass es nicht notwendig ist, sie anzugeben. Wenn Sie stattdessen alle Privatsphäre-Einstellungen auf Public setzen möchten, dann muss eine der folgenden Optionen verwendet werden:

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

Auf diese Weise können Sie auch einzelne Einstellungen so vornehmen, wie Sie möchten:

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

Das oben genannte wird das Profil auf öffentlich setzen, eigene Spiele auf nur für Freunde, Spielzeit auf privat, Freundesliste auf öffentlich, Inventar auf öffentlich, Inventar Geschenke auf privat und Profil-Kommentare auf öffentlich. Das Gleiche kann man mit numerischen Werten erreichen, wenn man dies möchte.

Bedenken Sie, dass ein Kind nie mehr offene Berechtigungen haben kann als sein Elternteil. Schauen Sie sich hierzu die Argumentationsbeziehung für die verfügbaren Optionen an.

addlicense Befehl unterstützt zwei verschiedene Lizenztypen, diese sind:

Die Differenzierung ist wichtig, da ASF die Steam Netzwerk Aktivierung für Apps und die Steam Shop Aktivierung für Pakete verwenden wird. Diese beiden sind nicht miteinander kompatibel, normalerweise werden Apps für Spiele mit kostenlosen Wochenenden und dauerhaft kostenlose Spiele verwendet, und Packages für alles andere.

Wir empfehlen, die Art jedes Eintrags explizit zu definieren, um zweideutige Ergebnisse zu vermeiden, aber für die Abwärtskompatibilität, wird ASF, wenn Sie einen ungültigen Typ angeben oder ihn ganz weglassen, davon ausgehen, dass Sie sub anfordern. Sie können auch eine oder mehrere Lizenzen gleichzeitig abfragen, indem Sie die Standard ASF-Trennzeichen (,) verwenden.

Beispiel für einen vollständigen Befehl:

addlicense ASF app/292030,sub/47807

Der owns Befehl unterstützt verschiedene Spielarten die für das <games> Argument genutzt werden können, diese sind:

Wir empfehlen, die Art jedes Eintrags explizit zu definieren, um zweideutige Ergebnisse zu vermeiden, aber für die Abwärtskompatibilität, wird ASF wenn Sie einen ungültigen Typ angeben oder ihn komplett weglassen davon ausgehen, dass Sie app verlangen, wenn Ihre Eingabe eine Nummer ist, und name falls nicht. Sie können auch eine oder mehrere Lizenzen gleichzeitig abfragen, indem Sie die Standard ASF-Trennzeichen (,) verwenden.

Beispiel für einen vollständigen Befehl:

owns ASF app/292030,name/Witcher

Der Befehl redeem^ ermöglicht es Ihnen, die Modi zu optimieren, die für ein einzelnes Einlöse-Szenario verwendet werden. Dazu wird temporär die RedeemingPreferences Bot-Konfigurationseigenschaft überschrieben.

<Modes> Argument akzeptiert mehrere Modus-Werte, die, wie üblich, durch ein Komma getrennt werden. Die verfügbaren Modus-Werte sind im Folgenden aufgeführt:

Zum Beispiel möchten wir drei Produktschlüssel auf einem unserer Bots einlösen, der noch keine Spiele besitzt, aber nicht auf unserem primary Bot. Um das zu erreichen, können wir Folgendes nutzen:

redeem^ primary FF,SI key1,key2,key3

Es ist wichtig zu beachten, dass fortgeschrittenes Einlösen nur die RedeemingPreferences überschreibt, die Sie im Befehl haben angegeben haben. Wenn Sie zum Beispiel Distributing in Ihren RedeemingPreferences aktiviert haben, dann macht es keinen Unterschied, ob der FD Modus genutzt wird oder nicht, weil die Verteilung trotzdem bereits aktiv ist, aufgrund der RedeemingPreferences die Sie verwenden. Deshalb hat jede zwangsweise aktivierte Überschreibung auch eine zwangsweise deaktivierte. Sie können selbst entscheiden, ob deaktivierte mit aktiviert zu überschrieben werden soll oder umgekehrt.

encrypt command allows you to encrypt arbitrary strings using ASF's encryption methods. <encryptionMethod> muss eine der Verschlüsselungsmethoden sein, welche im Abschnitt Sicherheit angegeben und erklärt ist. Wir empfehlen, diesen Befehl über sichere Kanäle zu verwenden (ASF-Konsole oder IPC-Schnittstelle, für die es auch einen dedizierten API-Endpunkt gibt), da sonst sensible Details von verschiedenen Dritten protokolliert werden könnten (z. B. Chat-Nachrichten, die von Steam-Servern protokolliert werden).

hash command allows you to generate hashes of arbitrary strings using ASF's hashing methods. <hashingMethod> muss eine der Hashing-Methoden sein, welche im Abschnitt Sicherheit angegeben und erklärt ist. Wir empfehlen, diesen Befehl über sichere Kanäle zu verwenden (ASF-Konsole oder IPC-Schnittstelle, für die es auch einen dedizierten API-Endpunkt gibt), da sonst sensible Details von verschiedenen Dritten protokolliert werden könnten (z. B. Chat-Nachrichten, die von Steam-Servern protokolliert werden).

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.

Der Allgemeine Syntax ist Input [Bots] <Type> <Value>.

<Type> ist Groß-/Kleinschreibung unabhängig und definiert einen von ASF unterstützten Eingabetyp. Derzeit unterstützt ASF folgende Typen:

<Value> ist der Wert, der für einen angegebenen Typ gesetzt werden soll. Derzeit sind alle Werte Zeichenketten.

Nehmen wir an, dass wir einen Bot haben, der durch SteamGuard (nicht im Zwei-Faktor-Modus) geschützt wird. We want to launch that bot with Headless set to true.

Um das zu tun, müssen wir folgende Befehle ausführen:

start MySteamGuardBot -> Bot will attempt to log in, fail due to AuthCode needed, then stop due to running in Headless mode. Wir brauchen dies, damit das Steam-Netzwerk uns den Authentisierungscode an unsere E-Mail sendet - wenn es keinen Bedarf dafür gibt, würden wir diesen Schritt komplett überspringen.

input MySteamGuardBot SteamGuard ABCDE -> We set SteamGuard input of MySteamGuardBot bot to ABCDE. Natürlich sollte ABCDE der Code sein, den Sie in Ihrer E-Mail erhalten haben.

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.

Auf dem selben Weg können wir auf Bots, die durch Zwei-Faktor-Authentifizierung geschützt sind (und nicht die 2FA von ASF verwenden), zugreifen und andere Dinge während der Laufzeit tun.