ASF soporta una variedad de comandos, que pueden ser utilizados para controlar el comportamiento del proceso y las instancias de bot.

Los comandos pueden ser enviados al bot de diferentes formas:

• A través de la consola interactiva de ASF
• A través de Steam por chat privado/grupal
• A través de la interfaz IPC

Ten en cuenta que la interacción con ASF requiere que seas elegible para el comando de acuerdo a los permisos de ASF. Para más detalles, revisa las propiedades de configuración SteamUserPermissions y SteamOwnerID.

Los comandos ejecutados por medio del chat de Steam son afectados por la propiedad de configuración global CommandPrefix, que por defecto es !. Esto significa que para ejecutar, por ejemplo, el comando status, debes escribir !status (o en su caso, el CommandPrefix de tu elección que hayas establecido). CommandPrefix no es obligatorio cuando se usa la consola interactiva o IPC y puede ser omitido en esos casos.

ASF tiene soporte para consola interactiva, siempre y cuando no lo estés ejecutando en modo Headless Simplemente pulsa el botón c para habilitar el modo de comandos, escribe tu comando y confirma con Enter

También puedes ejecutar comandos en un bot determinado a través del chat de Steam. Obviamente no puedes hablar contigo mismo directamente, por lo tanto necesitarás al menos otra cuenta bot para ejecutar comandos dirigidos a tu cuenta principal.

De la misma manera, también puedes usar el chat grupal de un grupo de Steam determinado. Ten en cuenta que esta opción requiere establecer correctamente la propiedad SteamMasterClanID, en cuyo caso el bot también escuchará comandos en el chat grupal (y se unirá si es necesario). Esto también puede usarse para "hablar contigo mismo" ya que no requiere una cuenta bot dedicada, contrario al chat privado. Puedes simplemente establecer la propiedad SteamMasterClanID de tu grupo recién creado, luego darte acceso a ti mismo ya sea con SteamOwnerID o SteamUserPermissions de tu bot. De esta manera, el bot (tú) se unirá al grupo seleccionado y a su chat, y escuchará comandos de tu propia cuenta. Puedes unirte al mismo chat de grupo para enviarte comandos a ti mismo (ya que estarás enviando comandos a un chat de grupo, y la instancia de ASF en ese mismo chat los recibirá, incluso si se muestra como si solo tu cuenta estuviese ahí).

Por favor, ten en cuenta que enviar un comando al chat de grupo funciona como un relé. Si envías redeem X a 3 de tus bots que están junto contigo en el chat de grupo, el resultado será igual que si enviaras redeem X a cada uno de ellos en privado. En la mayoría de los casos esto no es lo que quieres, y en cambio deberías usar un comando a un given bot bot determinado que sea enviado a un solo bot en una ventana privada. ASF soporta el chat de grupo, ya que en muchos casos puede ser útil para la comunicación con tu único bot, pero casi nunca deberías ejecutar ningún comando en el chat de grupo si hay 2 o más bots unidos, a menos que entiendas completamente el comportamiento de ASF descrito aquí y que de hecho quieres enviar el mismo comando a cada bot que esté escuchando.

E incluso en este caso deberías usar el chat privado con la sintaxis [Bots].

La forma más avanzada y flexible de ejecutar comandos, perfecta para la interacción con el usuario (ASF-ui) así como con herramientas de terceros o con scripting (ASF API), requiere que ASF se ejecute en modo IPC, y un cliente que ejecute comandos a través de la interfaz IPC.

Ningún comando es sensible a mayúsculas y minúsculas, pero sus argumentos (como nombres de bots) sí suelen diferenciarlas.

Los argumentos siguen la filosofía UNIX, los corchetes [Optional] indican que un argumento determinado es opcional, mientras que los corchetes angulares <Mandatory> indican que el argumento es obligatorio. Debes reemplazar los argumentos que quieres declarar, tal como [Bots] o <Nickname> con los valores reales con los que quieres enviar el comando, omitiendo los corchetes.

El argumento [Bots], como indican los corchetes, es opcional en todos los comandos. Cuando se especifica, el comando se ejecuta en los bots indicados. Cuando se omite, el comando se ejecuta en el bot actual que recibe el comando (chat de Steam), o de acuerdo a la propiedad DefaultBot previamente configurada (IPC y consola interactiva).

Como ejemplo, status A enviado al bot B es lo mismo que enviar status al bot A, en este caso el bot B solo actúa como intermediario. Esto también se puede usar para enviar comandos a bots que de otro modo no están disponibles, por ejemplo, iniciar bots detenidos, o ejecutar acciones en tu cuenta principal (que estás usando para ejecutar comandos).

El acceso del comando define el EPermission permiso mínimo de SteamUserPermissions que se requiere para usar el comando, con la excepción de Owner (propietario) que se define en SteamOwnerID en el archivo de configuración global (y que es el permiso más alto disponible).

Los argumentos plurales, como [Bots], <Keys> o <AppIDs> significan que el comando soporta múltiples argumentos de un tipo dado, separados por una coma. Por ejemplo, status [Bots] puede ser usado como status MyBot,MyOtherBot,Primary. Esto causará que el comando se ejecute en todos los bots objetivo de la misma forma que si enviaras status a cada bot en una ventana de chat separada. Ten en cuenta que no hay espacio después de la coma ,.

ASF usa todos los caracteres en blanco como posibles delimitadores para un comando, tal como espacio y caracteres de nueva línea. Esto significa que no tienes que usar espacio para delimitar tus argumentos, puedes usar cualquier otro carácter en blanco (como tabulador o nueva línea).

ASF "unirá" argumentos adicionales fuera de rango a tipo plural del último argumento en rango. Esto significa que redeem bot key1 key2 key3 para redeem [Bots] <Keys> funcionará exactamente igual que redeem bot key1,key2,key3. Junto con el hecho de aceptar una nueva línea como delimitador de comandos, esto hace posible que escribas redeem bot y luego pegues una lista de claves separadas por cualquier delimitador aceptable (tal como nueva línea), o el delimitador estándar , de ASF. Ten en cuenta que este truco solo se puede usar para variantes de comandos que utilicen la mayor cantidad de argumentos (así que especificar [Bots] es obligatorio en este caso, de lo contrario tu primera clave sería interpretada como el bot objetivo en el que ejecutar el comando).

Como leíste arriba, se usa un carácter de espacio como delimitador para un comando, por lo tanto no puede ser usado en los argumentos. Sin embargo, como se ha dicho anteriormente, ASF puede unir argumentos fuera de rango, esto significa que realmente puedes usar un carácter de espacio en el último argumento definido para un comando especificado. Por ejemplo, nickname bob Great Bob establecerá correctamente el nombre de perfil del bot bob a "Great Bob". De la misma manera puedes comprobar nombres que contengan espacios en el comando owns.

Algunos comandos también están disponibles con sus alias, principalmente para ahorrarte la escritura o para considerar la escritura en diferentes dialectos:

El argumento [Bots] es una variante especial de los argumentos plurales, ya que además de aceptar múltiples valores también ofrece funcionalidad adicional.

Primero que nada, el argumento [Bots] soporta "grupos de bots" predefinidos, descritos a continuación:

Por ejemplo, el comando status ASF equivale a status todos,tus,bots,listados,aquí. Esto también puede utilizarse para identificar fácilmente los bots a los que tienes acceso, ya que la palabra clave ASF, a pesar de dirigirse a todos los bots, solo tendrá respuesta de aquellos bots a los que realmente puedes enviar el comando. Otros grupos también están disponibles para ejecutar más fácilmente un comando determinado en bots específicos que cumplan la condición.

El argumento [Bots] también soporta una sintaxis de "rango", que permite elegir un rango de bots más fácilmente. La sintaxis general para [Bots] en este caso es [FirstBot]..[LastBot] (PrimerBot..ÚltimoBot). Al menos uno de los argumentos debe ser definido. Al usar <FirstBot>.., todos los bots empezando desde FirstBot se ven afectados. Al usar ..<LastBot>, todos los bots hasta LastBot se ven afectados. Al usar <FirstBot>..<LastBot> todos los bots dentro del rango desde FirstBot hasta LastBot se ven afectados. Por ejemplo, si tienes bots llamados A, B, C, D, E, F, puedes ejecutar status B..E, lo que es igual a status B,C,D,E en este caso. Al usar esta sintaxis, ASF usará el orden alfabético para determinar qué bots están en tu rango especificado. Los argumentos deben ser nombres de bots válidos reconocidos por ASF, de lo contrario la sintaxis de rango es omitida.

Además de la sintaxis de rango anterior, el argumento [Bots] también soporta coincidencias de expresión regular. Puedes activar el patrón de expresión regular usando r!<Pattern> como nombre de bot, donde r! es el activador de ASF para la coincidencia de expresión regular, y <Pattern> es tu patrón de expresión regular. Un ejemplo de comando basado en expresión regular sería status r!^\d{3} que enviará el comando status a los bots que tengan un nombre formado por 3 dígitos (por ejemplo 123 y 981). Siéntete libre de revisar la documentación para mayor explicación y más ejemplos de los patrones de expresión regular disponibles.

Los argumentos <Settings> aceptan hasta 7 opciones diferentes, separadas como es habitual por una coma, que es el delimitador estándar de ASF. Esas son, en orden:

Para una descripción de los campos anteriores, visita los ajustes de privacidad de Steam.

Mientras que los valores válidos para todos ellos son:

Puedes usar un nombre, sin distinción de mayúsculas y minúsculas, o un valor numérico. Los argumentos omitidos por defecto se establecerán a Private privado. Es importante tener en cuenta las dependencias especificadas anteriormente, ya que la propiedad de la que depende una entrada determinada especifica el permiso más abierto que esa entrada puede tener.

Por ejemplo, no puedes tener el ajuste tiempo de juego en Public y al mismo tiempo tener los juegos poseídos en Private, pero puedes tener juegos poseídos en Private mientras tienes el perfil en Public.

Si quieres establecer todos los ajustes de privacidad de tu bot llamado Main a Private privado, puedes usar cualquiera de los siguientes:

privacy Main 1
privacy Main Private

Esto es porque ASF asumirá automáticamente que todos los demás ajustes son Private privados, así que no hay necesidad de especificarlos. Por otra parte, si quieres establecer todos los ajustes de privacidad a Public público, entonces deberías usar cualquiera de los siguientes:

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

De esta manera también puedes establecer opciones independientes de la forma que quieras:

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

Lo anterior establecerá el perfil a público, los juegos poseídos a solo amigos, el tiempo de juego a privado, la lista de amigos a público, el inventario a público, el inventario de regalos a privado y los comentarios en el perfil a público. Puedes lograr lo mismo con valores numéricos si así lo quieres.

Los comandos addlicense y rmlicense soportan dos tipos diferentes de licencias, estos son:

La diferencia es importante, ya que ASF usará el método de la red de Steam para las apps, y el método de la tienda de Steam para los paquetes. Estos no son compatibles entre sí.

Al activar nuevas licencias, normalmente querrás especificar la app para los fines de semana gratuitos/juegos permanentemente F2P, y los paquetes en los demás casos.

Para eliminar licencias existentes, ambos métodos funcionarán, aunque recomendamos eliminar los paquetes para tener una solicitud determinista y explícita, ya que de lo contrario Steam podría eliminar paquetes que no querías eliminar, especialmente si tu cuenta tiene más de un paquete que otorga acceso a determinada app. Esto se debe a que por debajo, la licencia siempre es identificada por el paquete al que concede acceso, así que si decides eliminar por appID, entonces Steam decide qué subID `va a eliminar.

Recomendamos definir explícitamente el tipo de cada entrada para evitar resultados ambiguos, pero por retrocompatibilidad, si omites especificar el tipo, ASF asumirá que te refieres a sub` en este caso. También puedes consultar una o más de las licencias al mismo tiempo, usando la coma `,` que es el el delimitador estándar de ASF.

Ejemplos del comando completo:

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

owns ASF app/292030,name/Witcher