Skip to content

ItemsMatcherPlugin es ES

ArchiBot edited this page Dec 18, 2022 · 23 revisions

ItemsMatcherPlugin

ItemsMatcherPlugin es un plugin oficial de ASF que lo amplía con las funciones del listado ASF STM. En particular, esto incluye PublicListing en RemoteCommunication y MatchActively en TradingPreferences. ASF viene con ItemsMatcherPlugin integrado, por lo tanto está listo para usarlo inmediatamente.


PublicListing

La lista pública, como su nombre implica , es un listado de los bots ASF STM disponibles actualmente. Se ubica en nuestro sitio web, es administrada automáticamente y usada como un servicio público tanto para usuarios de ASF que hacen uso de MatchActively, así como para usuarios y no usuarios de ASF para emparejamiento manual.

Mientras que PublicListing está habilitado por defecto, ten en cuenta que no serás mostrado en el sitio web si no cumples todos los requisitos, especialmente SteamTradeMatcher, el cual no está habilitado por defecto. Para las personas que no cumplen los criterios, incluso si mantienen PublicListing habilitado, ASF no se comunica con el servidor de ninguna manera. Además, la lista pública solo es compatible con la última versión estable de ASF y podría negarse a mostrar bots desactualizados, especialmente si carecen de alguna funcionalidad crucial que solo se encuentra en las versiones más recientes.

Cómo funciona exactamente

ASF envía información inicial después de iniciar sesión, que contiene todas las propiedades de las que hace uso la lista pública. Luego, cada 10 minutos ASF envía una pequeña solicitud "latido" que notifica a nuestro servidor que el bot todavía está funcionando. Si por alguna razón el latido no llega, por ejemplo debido a problemas de red, entonces ASF intentará enviarlo cada minuto, hasta que el servidor lo registre. De esta manera nuestro servidor sabe con precisión qué bots se están ejecutando todavía y están listos para aceptar ofertas de intercambio. ASF también enviará un anuncio inicial según sea necesario, por ejemplo, si detecta que nuestro inventario ha cambiado desde la vez anterior.

Mostramos todas las cuentas ASF 2FA+STM que estaban activas en los últimos 15 minutos. Los usuarios se ordenan de acuerdo a su utilidad relativa - los bots con MatchEverything que se muestran con la etiqueta Any que aceptan todos los intercambios 1:1, luego por cantidad de juegos únicos, y finalmente por cantidad de artículos.

API

La lista ASF STM solo acepta bots de ASF por el momento. No hay forma de listar bots de terceros por ahora, ya que no podemos revisar fácilmente su código y asegurar que cumplen con nuestra lógica de intercambio. Por lo tanto, participar en la lista requiere la última versión estable de ASF, aunque puede ejecutarse con plugins. personalizados.

Para los consumidores de la lista, tenemos un endpoint /Api/Listing/Bots bastante sencillo que pueden usar. Incluye toda la información que tenemos, excepto los inventarios de los usuarios que son parte de la función MatchActively exclusivamente.

Política de privacidad

Si aceptas aparecer en nuestro listado, habilitando SteamTradeMatcher y no rechazando PublicListing, como se especificó anteriormente, almacenaremos temporalmente en nuestro servidor algunos detalles de tu cuenta de Steam para proporcionar la funcionalidad esperada.

La información pública (expuesta por Steam a todas las partes interesadas) incluye:

  • Tu identificador de Steam (en forma de 64 bits, para generar enlaces)
  • Tu nickname (para fines de visualización)
  • Tu avatar (para fines de visualización)

La información semipública (expuesta por Steam a todos los interesados si cumples los requisitos de listado) incluye:

  • Tu inventario (para que otros puedan usar MatchActively con tus artículos).

La información privada (datos seleccionados necesarios para proporcionar la funcionalidad) incluye:

  • Tu token de intercambio (para que las personas fuera de tu lista de amigos puedan enviarte intercambios)
  • Tu configuración de MatchableTypes (para fines de visualización y emparejamiento)
  • Tu configuración de MatchEverything (para fines de visualización y emparejamiento)
  • Tu configuración de MaxTradeHoldDuration (para que otros sepan si estás dispuesto a aceptar sus intercambios)

MatchActively

La configuración MatchActively es la versión activa de SteamTradeMatcher la cual incluye emparejamiento interactivo donde el bot enviará intercambios a otras personas. Puede funcionar solo, o junto con el ajuste SteamTradeMatcher. Esta función requiere que se configure LicenseID, ya que utiliza servidores de terceros y recursos de pago para funcionar.

Para usar esa opción, tienes que cumplir ciertos requisitos. Como mínimo debes tener una cuenta deslimitada, ASF 2FA activo y por lo menos un tipo válido en MatchableTypes, tal como los cromos.

Si cumples todos los requisitios mencionados anteriormente, ASF se comunicará periódicamente con nuestra lista pública ASF STM para emparejar activamente con los bots que estén disponibles actualmente.

  • En cada ronda ASF obtendrá nuestro inventario y el de todos los bots disponibles listados para encontrar artículos en MatchableTypes que puedan ser emparejados. Gracias a la comunicación directa con nuestro servidor, este proceso requiere una sola solicitud e inmediatamente tenemos información sobre si hay algún bot disponible que pueda proporcionar algo que nos interese - si se encuentra una coincidencia, ASF enviará y confirmará la oferta de intercambio automáticamente.
  • Cada set (compuesto de appID, tipo y rareza del artículo) puede ser emparejado solo una vez en cada ronda. Esto se implementa para minimizar el error que indica que "los artículos ya no están disponibles para intercambiar" y evitar la necesidad de esperar a que cada bot reaccione antes de enviar todos los intercambios. También es la razón principal por la que el emparejamiento se compone de rondas y no de un proceso continuo.
  • ASF no enviará más de 255 artículos en un solo intercambio, y no más de 5 intercambios al mismo usuario en una sola ronda. Esto es impuesto por los límites de Steam, así como por nuestro propio equilibrio de carga.

Este módulo debe ser transparente. El emparejamiento comenzará en aproximadamente 1 hora desde el inicio de ASF, y se repetirá cada 6 horas (si es necesario). La función MatchActively está diseñada para ser usada como una medida periódica a largo plazo, para asegurar que avanzamos activamente hacia completar sets, pero sin la presión a corto plazo de tiempo y recursos que surgiría si esto se ofreciera como un comando. Los usuarios objetivo de este módulo son cuentas principales y cuentas alternas usadas para "almacenar", aunque puede ser usado por cualquier bot que no esté configurado a MatchEverything.

ASF hace todo lo posible para minimizar la cantidad de solicitudes y presión generada por usar esta opción, al mismo tiempo que maximiza la eficiencia del emparejamiento. El algoritmo exacto para elegir los bots a emparejar y organizar todo el proceso, es un detalle de implementación de ASF y puede cambiar por la retroalimentación, la situación y posibles futuras ideas.

La versión actual del algoritmo hace que ASF dé prioridad a bots Any, especialmente aquellos con mejor diversidad de juegos de los que provienen sus artículos. Si se agotan los bots Any, ASF pasará a los Fair bajo la misma regla de diversidad. ASF intentará emparejar con todos los bots disponibles al menos una vez, para asegurar que no perdemos un posible progreso en algún set de cromos, emoticons, etc.

MatchActively toma en cuenta los bots que bloqueaste del intercambio a través del comando tbadd y no intentará emparejar activamente con ellos. Esto puede ser usado para decirle a ASF con qué bots nunca debería emparejar, incluso si tienen posibles duplicados que nos pudieran servir.


¿Por qué necesito un LicenseID para usar MatchActively? ¿Antes no era gratis?

ASF es, y sigue siendo gratuito y de código abierto, tal como se estableció al inicio del proyecto en octubre de 2015. Nuestro programa también es totalmente no comercial, no ganamos nada de las contribuciones hacia él, su compilación o publicación. En los últimos 7 años ASF ha recibido una increíble cantidad de desarrollo, y todavía sigue siendo mejorado con cada versión estable mensual mayormente por una sola persona, JustArchi - sin ningún tipo de compromiso. La única financiación que recibimos proviene de donaciones no obligatorias de nuestros usuarios.

Durante mucho tiempo, hasta octubre de 2022, la función MatchActively era parte del núcleo de ASF y estaba disponible para todos. En octubre de 2022, Valve, la compañía detrás de Steam, estableció un límite muy estricto a las solicitudes a sus servicios lo que rompió por completo dicha funcionalidad, sin ninguna solución disponible. Por lo tanto, dicha característica fue eliminada del núcleo de ASF en la versión 5.4.1.0.

MatchActively fue resucitado como parte del plugin oficial ItemsMatcher que mejora ASF aún más con la funcionalidad de emparejamiento activo de cromos. Traer de vuelta la función MatchActively requirió una extraordinaria cantidad de trabajo para crear el backend de ASF, un servicio completamente nuevo hospedado en un servidor, con más de mil proxies para analizar los inventarios, todo ello exclusivamente para permitir que los clientes de ASF puedan usar MatchActively como antes. Debido a la cantidad de trabajo involucrado, así como al uso de recursos que no son gratuitos y requieren ser pagados mensualmente(dominio, servidor, proxies), hemos decidido ofrecer esta funcionalidad a nuestros patrocinadores, es decir, las personas que ya apoyan el proyecto ASF de forma mensual. Nuestro objetivo no es beneficiarnos de ello, sino cubrir los costos mensuales vinculados exclusivamente con ofrecer esta opción - por eso la ofrecemos por básicamente nada, pero tenemos que cobrar un poco ya que no podemos pagar cientos de dólares de nuestros propios bolsillos solo para que la tengas disponible. Esperamos que lo entiendas.


¿Cómo puedo obtener acceso?

ItemsMatcher se ofrece como parte del nivel de patrocinio $5+ en el GitHub de JustArchi. Simplemente conviértete en patrocinador de nivel $5 (o superior), luego lee la sección de configuración para obtener y establecer LicenseID.

La licencia te permite enviar una cantidad limitada de solicitudes al servidor. El nivel $5 te permite usar MatchActively para una cuenta, lo que debería ser suficiente para la mayoría de personas. El nivel $10 te permite usarlo en tres cuentas. Si necesitas más recursos, háznoslo saber.

Clone this wiki locally