ASF supporta diversi comandi, utilizzabili per controllare il comportamento delle istanze di processo e dei bot.

I comandi sotto sono inviabili al bot tramite vari diversi metodi:

• Tramite la console ASF interattiva
• Tramite la chat di gruppo/privata di Steam
• Tramite la nostra interfaccia IPC

Tieni a mente che l'interazione di ASF ti richiede di essere idoneo per il comando in base ai permessi di ASF. Dai un'occhiata alle proprietà di configurazione SteamUserPermissions e SteamOwnerID per ulteriori dettagli.

I comandi eseguiti tramite la chat di Steam sono influenzati da CommandPrefix, la proprietà di configurazione globale, ! di default. Questo significa che per eseguire ad es. il comando status, dovresti in realtà scrivere !status (o il CommandPrefix personalizzato di tua scelta che hai invece impostato). CommandPrefix non è obbligatorio usando la console o l'IPC e può esser emesso.

ASF ha il supporto per la console interattiva, finché non stai eseguendo ASF in modalità Headless. Basta premere il pulsante c per abilitare la modalità di comando, digitare il comando e confermare con invio.

Puoi eseguire il comando al bot dato di ASF tramite la chat di Steam. Ovviamente non puoi parlare direttamente da solo, dunque dorai almeno avere un altro profilo del bot se vuoi eseguire comandi diretti al tuo profilo principale.

In modo simile, puoi anche usare la chat di gruppo o il gruppo dato di Steam. Tieni a mente che quest'opzione richiede la proprietà SteamMasterClanID propriamente impostata, nel qual caso il bot ascolterà i comandi anche sulla chat del gruppo (e unisciti se necessario). Questo è anche utilizzabile per "parlare da soli" poiché non richiede un profilo del bot dedicato, al contrario della chat privata. Puoi semplicemente impostare la proprietà SteamMasterClanID al tuo gruppo appena creato, per poi concederti l'accesso al tuo bot tramite SteamOwnerID o SteamUserPermissions. In questo modo il bot ASF (tu) si unirà al gruppo e alla chat del gruppo selezionato, e ascolterà i comandi provenienti dal tuo account. Puoi unirti alla stessa chat di gruppo per inviare comandi a te stesso (in quanto invierai un comando alla chat del gruppo, e l'istanza di ASF presente nella stessa li riceverà, anche se ti sembra che solo il tuo account sia presente).

Considera che l'invio di un comando alla chat di gruppo agisce come un relè. Se stai scrivendo redeem X a 3 bot presenti assieme a te nella chat di gruppo, risulterà lo stesso che scrivere redeem X a ognuno di loro privatamente. Nella maggior parte dei casi questo non è quello che vuoi, e invece dovresti usare il comando dato bot che viene inviato a un singolo bot nella finestra privata. ASF supporta la chat di gruppo, poiché in molti casi può essere fonte utile per la comunicazione con il tuo solo bot, ma non si dovrebbe quasi mai eseguire alcun comando sulla chat di gruppo se ci sono 2 o più bot ASF seduti lì, a meno che non si capisca completamente il comportamento di ASF scritto qui e si vuole infatti trasmettere lo stesso comando a ogni singolo bot che ti sta ascoltando.

E anche in questo caso dovresti usare la chat privata con la sintassi [Bots].

Il modo più avanzato e flessibile di eseguire i comandi, perfetto per l'interazione utente (ASF-ui) e strumenti di terze parti o script (ASF API), richiede che ASF sia eseguito in modalità IPC , e un client che esegue il comando tramite l'interfaccia IPC.

Tutti i comandi non sono sensibili all'uso di maiuscole e minuscole, ma i loro argomenti (come i nomi del robot) sono solitamente sensibili all'uso di maiuscole e minuscole.

Gli argomenti seguono la filosofia UNIX, le parentesi quadre [Optional] indicano che un dato argomento è opzionale, mentre le parentesi angolari <Mandatory> indicano che un dato argomento è obbligatorio. Dovresti sostituire gli argomenti che vuoi dichiarare, come [Bots] o <Nickname> con i valori effettivi con cui si desidera emettere il comando, omettendo le bretelle.

L'argomento [Bots] , come indicato dalle parentesi, è facoltativo in tutti i comandi. Quando specificato, il comando viene eseguito sui bot forniti. Quando omesso, il comando viene eseguito sul bot corrente che riceve il comando (chat di Steam), o in accordo alla proprietà configurata DefaultBot (IPC e console interattiva).

Ad esempio, stato A inviato al bot B è lo stesso che inviare lo stato `` al bot A, bot `B` in questo caso agisce solo come proxy. Questo può anche essere usato per inviare comandi a bot che non sono disponibili altrimenti, per esempio avviare bot fermati, o eseguendo azioni sul tuo account principale (che stai usando per eseguire i comandi).

Access del comando definisce minimum EPermission di SteamUserPermissions che è necessario per utilizzare il comando, ad eccezione di Proprietario che è SteamOwnerID definito nel file di configurazione globale (e il più alto permesso disponibile).

Argomenti plurali, come [Bots], <Keys> o <AppIDs> significa che il comando supporta più argomenti di un dato tipo, separati da una virgola. Ad esempio, stato [Bots] può essere usato come stato MyBot,MyOtherBot,Primary. Questo causerà che il comando dato venga eseguito su tutti i bot di destinazione nello stesso modo in cui invii stato a ogni bot in una finestra di chat separata. Si prega di notare che non c'è spazio dopo la virgola ,.

ASF utilizza tutti i caratteri dello spazio bianco come delimitatori possibili per un comando, come lo spazio e i caratteri a riga recente. Ciò significa che non devi usare lo spazio per delimitare i tuoi argomenti, è anche possibile utilizzare qualsiasi altro carattere di spazio bianco (come scheda o nuova riga).

ASF "unirà" argomenti extra fuori gamma al tipo plurale dell'ultimo argomento in-range. Ciò significa che riscatta il bot key1 key2 key3 per riscattare [Bots] <Keys> funzionerà esattamente come riscattare la chiave bot 1, ey2,key3. Insieme ad accettare newline come delimitatore di comando, questo ti permette di scrivere il bot di riscattare quindi incollare una lista di chiavi separate da qualsiasi carattere delimitatore accettabile (come newline), o delimitatore ASF standard ,. Tieni presente che questo trucco può essere usato solo per la variante di comando che utilizza la maggior parte degli argomenti (quindi specificare [Bots] è obbligatorio in questo caso, altrimenti la tua prima chiave sarebbe interpretata come il bot di destinazione su cui eseguire il comando).

Come hai letto sopra, un carattere spazio viene usato come delimitatore per un comando, quindi non può essere usato negli argomenti. Tuttavia, anche come indicato in precedenza, la ASF può unirsi a argomenti fuori banda, il che significa che in realtà sei in grado di usare un carattere spazio nell'argomento che è definito come un ultimo per un determinato comando. Ad esempio, nickname bob Great Bob imposterà correttamente il nickname del bot bob su "Great Bob". In modo simile puoi controllare i nomi contenenti spazi in possiede il comando.

Anche i comandi in attesa di AppID o SubID sono abbastanza intelligenti da estrarre tali informazioni dai link store.steampowered.com.

Alcuni comandi sono disponibili anche con i loro alias, per lo più per salvarti sulla digitazione o account per diversi dialetti:

[Bots] argomento è una variante speciale di argomento plurale, in quanto oltre ad accettare più valori offre anche funzionalità extra.

Innanzitutto, l'argomento [Bots] supporta "bot groups" predefiniti, che sono definiti come di seguito:

Ad esempio, il comando di stato ASF è uguale allo stato tutto,tuo,bots,elencato,qui. Questo può anche essere utilizzato per identificare facilmente i bot a cui hai accesso, come parola chiave ASF , nonostante di targeting tutti i bot, si tradurrà in risposta solo da quei bot a cui si può effettivamente inviare il comando. Altri gruppi sono disponibili anche per eseguire più facilmente il comando dato solo su bot specifici che soddisfano la condizione.

L'argomento [Bots] supporta anche la sintassi speciale "range", che ti permette di scegliere una gamma di bot più facilmente. La sintassi generale per [Bots] in questo caso è [FirstBot]..[LastBot]. Almeno uno degli argomenti deve essere definito. Quando si utilizza <FirstBot>.., tutti i bot a partire da FirstBot sono interessati. Quando si utilizza ..<LastBot>, tutti i bot fino a quando LastBot non saranno interessati. Quando si utilizza <FirstBot>..<LastBot>, tutti i bot all'interno dell'intervallo da FirstBot fino a LastBot sono interessati. Ad esempio, se hai bot di nome A, B, C, D, E, F, puoi eseguire lo stato B. E, che è uguale allo stato B,C,D,E in questo caso. Quando si utilizza questa sintassi, ASF userà l'ordinamento alfabetico per determinare quali bot sono nell'intervallo specificato. Gli argomenti devono essere nomi bot validi riconosciuti da ASF, altrimenti la sintassi di intervallo è completamente saltata.

Oltre alla sintassi di intervallo sopra, l'argomento [Bots] supporta anche la corrispondenza regex. Puoi attivare la sequenza regex usando r!<Pattern> come nome del bot, dove r! è attivatore ASF per il regex e <Pattern> è il tuo modello regex. Un esempio di un comando bot basato su regex sarebbe lo stato r! \d{3} che invierà il comando stato ai bot che hanno un nome composto da 3 cifre (e. . 123 e 981). Sentitevi liberi di dare un'occhiata alla docs per ulteriori spiegazioni e ulteriori esempi di modelli regex disponibili.

<Settings> argomento accetta fino a 7 diverse opzioni, separate come al solito con delimitatore ASF di virgola standard. Questi sono, in ordine:

Per la descrizione dei campi sopra riportati, visita Impostazioni privacy Steam.

Mentre i valori validi per tutti loro sono:

È possibile utilizzare un nome insensibile o un valore numerico. Gli argomenti che sono stati omessi saranno di default per essere impostati su Private. È importante notare le dipendenze specificate sopra, poiché la proprietà data voce dipende da specifica il permesso più aperto che la voce può avere.

Ad esempio, tu non puoi avere Public impostazione del tempo di gioco mentre hai Private impostazione dei giochi, ma è possibile avere totalmente Private di proprietà di gioco impostando il profilo Pubblico.

Se si desidera impostare all privacy settings of your bot named Main to Private, è possibile utilizzare uno dei seguenti:

privacy Main 1
privacy Main Private

Questo perché ASF assumerà automaticamente tutte le altre impostazioni per essere Private, quindi non c'è bisogno di inserirle. D'altra parte, se si desidera impostare tutte le impostazioni sulla privacy su Public, allora si dovrebbe utilizzare uno qualsiasi dei seguenti:

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

In questo modo puoi anche impostare le opzioni indipendenti come preferisci:

privacy Pubblico principale,Amici solamente,Privato,Pubblico,Privato,Pubblico

Quanto sopra imposterà il profilo a pubblico, giochi di proprietà solo agli amici, tempo di gioco a privato, elenco di amici a pubblico, inventario a pubblico, regali di inventario a privati e commenti di profilo a pubblico. È possibile ottenere lo stesso con valori numerici se si desidera.

I comandi addlicense e rmlicense supportano due diversi tipi di licenza, che sono:

La distinzione è importante, in quanto ASF utilizzerà il metodo di rete Steam per le app, e il metodo Steam store per i pacchetti. Questi due non sono compatibili tra loro.

Quando si attivano nuove licenze, in genere si desidera specificare l'app per i fine settimana gratis/permanentemente i giochi F2P e pacchetti altrimenti.

Per la rimozione della licenza esistente, entrambi i metodi funzioneranno, anche se si consiglia di rimuovere i pacchetti al fine di avere una richiesta deterministica ed esplicita, altrimenti Steam potrebbe rimuovere i pacchetti che non intendi essere rimossi, specialmente se il tuo account ha più di un pacchetto che consente l'accesso a una data app. Questo perché sotto il cofano, la licenza è sempre identificata dal pacchetto a cui concede l'accesso, quindi se decidi di rimuovere da appID, poi Steam decide quale subID sta per rimuovere.

Si consiglia di definire esplicitamente il tipo di ogni voce al fine di evitare risultati ambigui, ma per la compatibilità all'indietro, se ometti del tutto, ASF supporrà che in questo caso chiedi sub. Puoi anche interrogare una o più licenze allo stesso tempo, utilizzando il delimitatore standard ASF ,.

Esempi di comando completi:

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

possiede il comando supporta diversi tipi di gioco per l'argomento <games> che può essere utilizzato, sono:

Si consiglia di definire esplicitamente il tipo di ogni voce al fine di evitare risultati ambigui, ma per la compatibilità all'indietro, se si fornisce un tipo non valido o omettere completamente, ASF supporrà che chiedi app se il tuo input è un numero, e nome altrimenti. Puoi anche interrogare uno o più giochi allo stesso tempo, utilizzando il delimitatore standard ASF ,.

Esempio di comando completo:

possiede ASF app/292030,name/Witcher

Il comando redeem^ ti permette di perfezionare le modalità che verranno utilizzate per un singolo scenario di redimenza. Questo funziona come scavalcamento temporaneo di RedeemingPreferences bot config property.

<Modes> argomento accetta più valori di modalità, separati come al solito da una virgola. I valori della modalità disponibile sono specificati di seguito:

Ad esempio, vorremmo riscattare 3 chiavi su uno qualsiasi dei nostri bot che non possiedono ancora giochi, ma non il nostro bot primario. Per raggiungere questo obiettivo possiamo utilizzare:

riscatta^ chiave primaria FF,SI key1,key2,key3

È importante notare che il riscatto avanzato sovrascrive solo le preferenze Riscattamento che specifichi nel comando. Ad esempio, se hai abilitato Distributing nella tua RedeemingPreferences allora non ci sarà alcuna differenza se usi o meno la modalità FD , perché la distribuzione sarà già attiva, a causa di RedeemingPreferenze che utilizzi. Questo è il motivo per cui ogni scavalcamento abilitato forzatamente ha anche uno disabilitato forzatamente, si può decidere se si preferisce sovrascrivere disabilitato con abilitato, o viceversa.

Il comando crittografa consente di crittografare le stringhe arbitrarie utilizzando i metodi di crittografia di ASF. <encryptionMethod> deve essere uno dei metodi di crittografia specificati e spiegati nella sezione security. Si consiglia di utilizzare questo comando attraverso canali sicuri (console ASF o interfaccia IPC, che ha anche un endpoint API dedicato per esso), come altrimenti i dettagli sensibili potrebbero ottenere registrati da varie terze parti (come i messaggi di chat che vengono registrati dai server di Steam).

Il comando hash consente di generare hash di stringhe arbitrarie utilizzando i metodi di hashing di ASF. <hashingMethod> deve essere uno dei metodi di hashing specificati e spiegati nella sezione security. Si consiglia di utilizzare questo comando attraverso canali sicuri (console ASF o interfaccia IPC, che ha anche un endpoint API dedicato per esso), come altrimenti i dettagli sensibili potrebbero ottenere registrati da varie terze parti (come i messaggi di chat che vengono registrati dai server di Steam).

Il comando input può essere utilizzato solo in modalità Headless , per inserire dati tramite IPC o chat di Steam quando ASF è in esecuzione senza supporto per l'interazione utente.

La sintassi generale è input [Bots] <Type> <Value>.

<Type> è insensibile alle maiuscole e definisce il tipo di input riconosciuto da ASF. Attualmente ASF riconosce i seguenti tipi:

<Value> è il valore impostato per il tipo specificato. Attualmente tutti i valori sono stringhe.

Diciamo che abbiamo un bot che è protetto da SteamGuard in modalità non-2FA. Vogliamo lanciare quel bot con Headless impostato su true.

Per farlo, dobbiamo eseguire i seguenti comandi:

avvia MySteamGuardBot -> Il bot tenterà di accedere, fallito a causa di AuthCode necessario, quindi fermarsi a causa di esecuzione in modalità Headless. Abbiamo bisogno di questo per fare in modo che la rete di Steam ci invii codice di autenticazione sulla nostra e-mail - se non c'era bisogno di questo, salteremmo completamente questo passaggio.

input MySteamGuardBot SteamGuard ABCDE -> Abbiamo impostato SteamGuard input di MySteamGuardBot bot su ABCDE. Naturalmente, ABCDE in questo caso è codice di autenticazione che abbiamo ricevuto sulla nostra e-mail.

avvia MySteamGuardBot -> Iniziamo nuovamente il nostro (fermato) bot, questa volta utilizza automaticamente il codice di autenticazione che abbiamo impostato nel comando precedente, accedendo correttamente, quindi cancellandolo.

Allo stesso modo possiamo accedere ai bot protetti da 2FA (se non usano ASF 2FA), così come impostare altre proprietà richieste durante il runtime.

ASF riconosce le seguenti rarità:

Non riconosciuto dalle rarità di ASF (diverse da quelle sopra definite) sarà definito come Sconosciuto.