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.

ASF unterstützt die interaktive Konsole, solange Sie nicht ASF im Headless-Modus ausführen. Drücken Sie einfach c um den Befehlsmodus zu aktivieren; geben Sie Ihren Befehl ein und bestätigen Sie mit dem Eintrag.

Sie können den Befehl zum angegebenen ASF-Bot auch über den Steam-Chat ausführen. Natürlich können Sie nicht direkt mit sich selbst sprechen, deshalb brauchen Sie mindestens ein weiteres Bot-Konto, wenn Sie Befehle ausführen möchten, die auf Ihr Haupt-Konto abzielen.

In ähnlicher Weise können Sie auch den Gruppen-Chat einer bestimmten Steam-Gruppe verwenden. Beachte, dass diese Option die korrekt eingestellte Variable 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-Variable 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 (Sie) der Gruppe bei und chattet mit der ausgewählten Gruppe und hört auf die Befehle von Ihrem eigenen Konto. Sie können dem gleichen Gruppen-Chatroom beitreten, um sich 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 Ihr 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 Sie möchten, und stattdessen sollten Sie 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 erläuterte ASF-Verhalten vollständig und Sie möchten tatsächlich den gleichen Befehl an jeden einzelnen Bot weitergeben, der auf Sie hört.

Sogar in diesem Fall sollten Sie stattdessen den privaten Chat mit der Syntax [Bots] verwenden.

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.

Argumente folgen der UNIX-Philosophie; eckige Klammern [Optional] zeigen an, dass das angegebene Argument optional ist, während der Winkel-Klammern <Mandatory> zeigt an, dass das angegebene Argument erforderlich ist. Sie sollten die Argumente, die Sie deklarieren möchten, ersetzen. Zum Beispiel [Bots] oder <Nickname> mit den tatsächlichen Werten, mit denen Sie den Befehl ausgeben möchten (weglassen der Klammern).

Das [Bots] Argument, wie von den Klammern angegeben, ist in allen Befehlen optional. Wenn verwendet, wird der Befehl auf den angegebenen Bots ausgeführt. Falls weggelassen, wird der Befehl auf dem aktuellen Bot ausgeführt, der den Befehl empfängt (Steam Chat), oder gemäß der konfigurierte Variable DefaultBot (für IPC und interaktive Konsole).

Als Beispiel status A an den Bot B ist das Gleiche wie das Senden von status zum Boten A, Bot B fungiert in diesem Fall nur als Proxy. Dies kann auch zum Senden von Befehlen an Bots verwendet werden, die andernfalls nicht verfügbar sind. Etwa zum Starten angehaltener Bots oder die Ausführung von Aktionen auf ihrem Hauptkonto (welches Sie für die Ausführung der Befehle verwenden).

Zugriff des Befehls definiert mindestens EPermission von SteamUserPermissions die benötigt werden, um den Befehl zu verwenden, mit Ausnahme von Owner, welche SteamOwnerID in der globalen Konfigurationsdatei definiert ist (und höchste verfügbare Berechtigung).

Plurale Argumente wie [Bots], <Keys> oder <AppIDs> bedeutet, dass der Befehl mehrere Argumente des angegebenen Typs unterstützt, durch Komma getrennt. Der Befehl status [Bots] kann zum Beispiel als status MeinBot,MeinAndererBot,Primärer verwendet werden. Dies führt dazu, dass der angegebene Befehl auf alle Ziel-Bots auf die gleiche Weise ausgeführt wird, als ob Sie status an jeden Bot in einem separaten Chat-Fenster senden würden. Es gilt zu beachten, dass nach , kein Leerzeichen steht.

ASF behandelt alle Leerraumzeichen als mögliche Trennzeichen für einen Befehl (etwa Leerzeichen und Zeilenumbrüche). Das bedeutet, dass Sie zur Eingrenzung der Argumente kein Leerzeichen verwenden müssen; stattdessen kann auch jedes andere Leerraumzeichen (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 dir 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 du oben gelesen hast, 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 du tatsächlich ein Leerzeichen in Argumenten verwenden kannst, 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 kannst du Namen, die Leerzeichen enthalten, im Befehl owns überprüfen.

Einige Befehle sind auch mit Ihrem jeweiligen Alias verfügbar, hauptsächlich um Sie beim Tippen oder Konto für verschiedene Dialekte zu unterstützen:

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

Das [Bots]-Argument unterstützt vordefinierte "Botgruppen", die folgendermaßen definiert sind:

Beispielsweise ist der Befehl status ASF gleichbedeutend mit status all,deine,bots,hier,aufgelistet. Dies kann auch verwendet werden, um die Bots zu identifizieren, auf die du Zugriff hast, da das ASF Schlüsselwort, trotz der Ausrichtung auf alle Bots, nur von den Bots eine Antwort generiert, an die du den Befehl tatsächlich senden kannst. Andere Gruppen sind auch verfügbar, um die Ausführung des gegebenen Befehls einfacher nur auf bestimmten Bots durchzuführen, die die Bedingung erfüllen.

Das [Bots]-Argument unterstützt außerdem eine spezielle "Reichweiten"-Syntax, die es dir vereinfacht, eine Reihe an spezifischen Bots zu selektieren. Die allgemeine Syntax für [Bots] in diesem Fall ist [FirstBot]..[LastBot]. Mindestens eines der Argumente muss definiert werden. Bei <FirstBot>..sind alle Bots von FirstBot betroffen. Bei der Verwendung von ..<LastBot>sind alle Bots bis LastBot betroffen. Bei <FirstBot>..<LastBot>sind alle Bots im Bereich von FirstBot bis LastBot betroffen. Wenn du zum Beispiel Bots mit den Namen A, B, C, D, E, F hast, kannst du 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 dir angegebenen Bereich befinden. Argumente müssen gültige Bot-Namen sein, die von ASF erkannt werden, sonst wird die Bereichssyntax komplett übersprungen.

Zusätzlich zur obigen Bereichssyntax unterstützt [Bots] Argument auch regex Übereinstimmung. Sie können regex-Muster aktivieren, indem Sie r!<Pattern> als Bot-Namen verwenden, wobei r! ist ASF-Aktivierer für Regex-Matching, und <Pattern> ist Ihr Regex-Muster. Ein Beispiel für einen regex-basierten Bot-Befehl wäre Status r! \d{3}, der den Status an Bots sendet, die einen Namen bestehend aus 3 Ziffern (z. B. 123 und 981) haben. Werfen Sie einen Blick auf die Dokumentation für weitere Erläuterungen und weitere Beispiele verfügbarer Regex-Patterns.

<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 obigen Felder besuchen Sie bitte Steam Privacy Einstellungen.

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

Du kannst 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 Kind und Eltern von oben genannten Argumenten zu beachten, da das Kind nie mehr offene Berechtigung haben kann als sein Elternteil. Zum Beispiel können Sie nicht über Öffentliche Spiele im Besitz haben, während Sie Private Profileinstellungen haben.

Wenn Sie alle Privatsphäre-Einstellungen Ihres Bots namens Main auf Private setzen möchten, können Sie jede der folgenden Optionen verwenden:

privacy Main 1
privacy Main Private

Dies liegt daran, dass ASF automatisch alle anderen Einstellungen als Private ansieht, so dass es nicht notwendig ist, sie anzugeben. Wenn du dagegen alle Privatsphäre-Einstellungen auf Public setzen möchtest, dann musst du eine der folgenden Optionen verwenden:

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

Auf diese Weise kannst du auch einzelne Einstellungen so vornehmen, wie du willst:

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.

addlicense und rmlicense Befehle unterstützen zwei verschiedene Lizenztypen, die sind:

Die Unterscheidung ist wichtig, da ASF die Steam-Netzwerk-Methode für Apps und die Steam-Store-Methode für Pakete verwenden wird. Diese beiden sind nicht miteinander kompatibel.

Wenn du neue Lizenzen aktivierst, solltest du normalerweise die App für kostenlose Wochenende/dauerhaft F2P-Spiele angeben und anderweitig Pakete angeben.

Für das Entfernen bestehender Lizenzen werden beide Methoden funktionieren, obwohl wir empfehlen, Pakete zu entfernen, um deterministische und explizite Anfrage zu haben andernfalls könnte Steam Pakete entfernen, die du nicht entfernt hast, insbesondere, wenn Ihr Konto mehr als ein Paket hat, das Zugriff auf die angegebene App gewährt.

Wir empfehlen, die Art jedes Eintrags explizit zu definieren, um zweideutige Ergebnisse zu vermeiden, aber für die Abwärtskompatibilität, wenn Sie den Typ vollständig weglassen, wird ASF in diesem Fall davon ausgehen, dass Sie sub beantragen. Sie können auch eine oder mehrere Lizenzen gleichzeitig abfragen, indem Sie das standarmäßige ASF-Trennzeichen (,) verwenden.

Vollständige Befehlsbeispiele:

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

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 dir, die Modi zu optimieren, die für ein einzelnes Einlöse-Szenario verwendet werden. Dies funktioniert als temporäre Überschreibung von Einlösen Einstellungen Bot config Eigenschaft.

<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 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 zwangsläufig eine deaktivierte. Sie können selbst entscheiden, ob die deaktivierte mit der aktivierten überschrieben werden soll oder umgekehrt.

encrypt erlaubt es Ihnen beliebige Strings mit ASF-Verschlüsselungsmethoden zu verschlüsseln. <encryptionMethod> muss eine der in angegebenen und erklärten Verschlüsselungsmethoden sein. 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).

Der Befehl hash erlaubt Ihnen Hashes beliebiger Zeichenketten mit ASF’s hash-Methoden zu generieren. <hashingMethod> muss eine der Hashing-Methoden sein, die in Security angegeben und erklärt werden. 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).

Eingabe Befehl kann nur im Kopflosen Modus verwendet werden, für die Eingabe von Daten über IPC oder Steam Chat wenn ASF ohne Unterstützung für Benutzerinteraktion läuft.

Allgemeine Syntax ist Eingabe [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 ein Wert für den angegebenen Typ. Derzeit sind alle Werte Zeichenketten.

Lass uns annehmen, dass wir einen Bot haben, der durch SteamGuard (nicht im Zwei-Faktor-Modus) geschützt wird. Wir möchten diesen Bot starten während das Konfigurationsfeld Headless auf true gesetzt ist.

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

start MySteamGuardBot -> Bot wird versuchen sich anzumelden; dies schlägt jedoch fehl, da AuthCode benötigt; schließlich wird der Vorgang gestoppt, da dieser im Headless-Modus ausgeführt wird. 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 -> Wir setzen die SteamGuard Eingabe vom MySteamGuardBot Bot auf ABCDE. Natürlich sollte ABCDE der Code sein, den du in deiner E-Mail erhalten hast.

start MySteamGuardBot -> Wir starten erneut unseren (gestoppten) Bot dieses Mal verwendet es automatisch den Auth-Code, den wir im vorherigen Befehl gesetzt haben, ordnungsgemäß einloggen und dann löschen.

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.

ASF erkennt folgende Raritäten:

Nicht von ASF-Raritäten erkannt (außer oben definiert) werden als Unbekannte definiert.