Skip to content

ItemsMatcherPlugin es ES

ArchiBot edited this page Dec 12, 2022 · 23 revisions

Note

This page is work-in-progress. For translators: you may want to wait a bit (until stable release), as the page is still being written and corrected.


Plugin

ItemsMatcherPlugin is official ASF plugin that extends ASF with ASF STM listing features. In particular, this includes PublicListing in RemoteCommunication and MatchActively in TradingPreferences.


PublicListing

Nuestra lista pública ASF STM está ubicada en nuestro sitio web y es usada como un servicio público tanto para usuarios de ASF que usan MatchActively, así como para usuarios y no usuarios de ASF para emparejamiento manual.

Ten en cuenta que no serás mostrado en el sitio web si no cumples con todos los requisitos. En este caso ASF ni siquiera se tomará la molestia de comunicarse con nuestro servidor, por lo que esta sección se omite completamente si intencionalmente no habilitaste SteamTradeMatcher para ayudarte a emparejar duplicados. Además, la lista pública es compatible solo con la última versión estable de ASF y puede negarse a mostrar bots desactualizados, especialmente si les falta alguna funcionalidad crucial que solo se puede encontrar 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.

Esto permite a nuestro sitio web registrar qué cuentas pueden ser usadas para emparejamiento, así como para registrar si todavía están activas. Gracias a eso, nuestro sitio web puede mostrar todas las cuentas ASF 2FA+STM que estaban activas en los últimos 15 minutos.

Los usuarios se ordenan de acuerdo a sus inventarios (en orden descendente) - bots con MatchEverything con la etiqueta Any que aceptan todos los intercambios 1:1, luego por cantidad de juegos únicos MatchableTypes, y finalmente por cantidad de artículos MatchableTypes.

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 asegurarnos de que cumplen con nuestra lógica de intercambio).

If you're looking for easy way to access our listing in programmatic way, we have a very simple /Api/Listing/Bots endpoint that you can use. Este es también el endpoint que ASF usa internamente para los usuarios de MatchActively.

Política de privacidad

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

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

  • Tu identificador de Steam (en forma de 64 bits, para generar enlaces)
  • Tu nombre de usuario (para efectos de visualización)
  • Tu avatar (para efectos de visualización)

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

  • Your inventory limited to item types that you've picked in MatchableTypes (so people can use MatchActively against your items).
  • Tu token de intercambio (para que las personas fuera de tu lista de amigos puedan enviarte intercambios)
  • Tu MaxTradeHoldDuration (para que otras personas sepan si estás dispuesto a aceptar sus intercambios)
  • Tus MatchableTypes (para efectos de visualización y emparejamiento)
  • Total number of Steam items in your inventory (for display purposes and matching)

MatchActively

MatchActively setting is active version of SteamTradeMatcher which includes interactive matching in which the bot will send trades to other people. Puede funcionar solo, o junto con el ajuste SteamTradeMatcher. This feature requires LicenseID to be set, as it uses third-party server.

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 requisitos anteriores, ASF se comunicará periódicamente con nuestra lista pública de ASF STM para emparejar activamente con los bots que estén disponibles.

  • En cada ronda ASF analizará nuestro inventario y el inventario de los bots seleccionados que estén listados para encontrar artículos MatchableTypes que puedan ser emparejados. Si se encuentra una coincidencia, ASF enviará y confirmará automáticamente la oferta de intercambio.
  • 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 acaban los bots Any, ASF pasará a los de intercambio justo con la misma regla de diversidad, con aquellos que tengan un número excesivo de artículos con menos prioridad debido a que tienen una mayor probabilidad de presentar problemas relacionados con el inventario en comparación con otros bots. Independientemente de eso, ASF intentará emparejar cada bot disponible al menos una vez, para asegurar que no perdemos el posible progreso de un set.

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.


Why do I need a LicenseID to use the plugin? Wasn't MatchActively free before?

ASF is, and remains, free and open-source, as it was established at the start of the project back in October 2015. Our program is also entirely non-commercial, we do not earn anything from contributions to it, building or publishing. Over those past 7+ years ASF has received tremendous amount of development, and it's still being improved and enhanced with every monthly stable release mostly by a single person, JustArchi - with no strings attached. The only funding we receive is from non-obligatory donations that come from our users.

For a very long time, until October 2022, MatchActively feature was part of ASF core and available for everyone to use. In October 2022, Valve, the company behind Steam, has put very severe rate limits that rendered previous functionality entirely broken, with no solution available. The feature therefore has been removed from ASF core in version 5.4.1.0.

MatchActively was resurrected as part of official ItemsMatcher plugin that further enhances ASF with active cards matching functionality. Resurrecting MatchActively feature required from us extraordinary amount of work to create ASF backend, entirely new service hosted on a server, with more than a thousand of proxies attached for resolving inventories, all exclusively to allow ASF clients to make use of MatchActively like before. Due to the amount of work involved, as well as resources that are not free and require to be paid on monthly basis by us (domain, server, proxies), we've decided to offer this plugin to our sponsors, that is, people that already support ASF project on monthly basis. Our goal isn't to profit from it, but rather, cover the monthly costs that are exclusively linked with offering this functionality - that's why we offer it basically for nothing, but we do have to charge a little for it as we can't pay hundreds of dollars from our own pockets just to make it available for you. We hope that you understand.


How can I get an access?

ItemsMatcher is offered as part of $5+ sponsor tier on JustArchi's GitHub. Simply become a sponsor of $5 tier (or higher), then click here to obtain your LicenseID. You'll need to sign in with GitHub for confirming your identity.

The license allows you to send limited amount of requests to the server. $5 tier allows you to use MatchActively for one account, which should be suitable for majority of people. $10 tier allows you to use it on three accounts. If you require more resources, let us know.

LicenseID is made out of 32 hexadecimal characters, such as f6a0529813f74d119982eb4fe43a9a24. Simply put it in LicenseID property of ASF global config.

Clone this wiki locally