ItemsMatcherPlugin pt BR

ItemsMatcherPlugin

ItemsMatcherPlugin é um plugin oficial que estende o ASF com recursos de listagem do ASF STM. Em particular, isso inclui PublicListing em RemoteCommunication e MatchActively em TradingPreferences. O ASF vem com o ItemsMatcherPlugin incluído junto com o lançamento, portanto está pronto para uso imediato.

`PublicListing`

A listagem pública, como o nome indica, é a listagem dos bots ASF STM atualmente disponíveis. A listagem pública está localizada em nosso site ela é gerenciada automaticamente e é usada como um serviço público tanto para os usuários do ASF que usam o MatchActively, bem como usuários e não-usuários do ASF para troca manual.

Para que seu inventário seja listado você tem um conjunto de requisitos a cumprir. No mínimo, você deve permitir a opção PublicListing em RemoteCommunication (configuração padrão), assim como ter a opção SteamTradeMatcher ativa em TradingPreferences, um inventário público uma conta não limitada e o ASF 2FA ativo. Requisitos adicionais incluem a autenticação 2FA ativa há pelo menos 15 dias, a última alteração de senha há mais de 5 dias, a falta de limitações de conta, como bloqueios, proibições económicas e proibições de troca. E claro, você também tem que ter ao menos um item do formato especificado em MatchableTypes, tais como cartas colecionáveis. Além disso, bots com mais de 500000 não são aceitos devido à sobrecarga, nesse caso recomendamos dividir seu inventário em várias contas.

Mesmo a PublicListing vindo ativada por padrão, por favor, note que você não será exibido no site se você não cumprir todos os requisitos, especialmente a configuração SteamTradeMatcher que não está habilitada por padrão. Para pessoas que não atendem aos critérios, o ASF não se comunicará com o servidor mesmo que elas mantenham a PublicListing habilitada. Além disso, a listagem pública é compatível somente com a última versão estável do ASF e pode se recusar a mostrar bots desatualizados, especialmente se faltar neles funcionalidades cruciais que só podem ser encontradas em novas versões.

Como exatamente isso funciona

O ASF envia os dados iniciais uma vez após o login, que contém todas as propriedades que a listagem pública utiliza. Em seguida, a cada 10 minutos o ASF envia uma solicitação muito pequena de "pulso" que notifica o nosso servidor de que o bot ainda está sendo executado. Se por algum motivo o pulso não chegar, por exemplo devido a problemas de rede, então o ASF vai tentar reenviá-lo a cada minuto, até o servidor registrá-lo. Desta forma, nosso servidor sabe precisamente quais bots ainda estão em execução e prontos para aceitar ofertas de troca. O ASF também enviará um anúncio inicial conforme necessário, por exemplo, se ele detectar que nosso inventário sofreu uma mudança.

Nós exibimos todas as contas ASF com 2FA+STM que estuiveram ativas nos últimos 15 minutos. Os usuários são classificados de acordo com sua utilidade relativa - bots configurados com MatchEverything com a tag Any que aceitem todas as trocas 1:1, depois pela quantidade de jogos únicos e finalmente os itens.

API

A listagem API do STM só aceita bots ASF no momento. Não há como inserir bots de terceiros em nossa listagem no momento, já que não podemos analisar seus códigos facilmente e assegurar que eles satisfazem nossa lógica de trocas. Portanto, para participar da listagem você precisa ter a última versão estável do ASF, embora ela possa rodar com plugins.

Para os usuários da listagem nós temos um endpoint muito simples /Api/Listing/Bots que pode ser usado. Ele inclui todos os dados que temos, além dos inventários dos usuários que fazem parte do recurso Matchativamente.

Política de privacidade

Se você concordar em aparecer na nossa listagem, ativando o SteamTradeMatcher e não recusando a PublicListing, conforme especificado acima, vamos armazenar temporariamente alguns dados da sua conta Steam em nosso servidor para fornecer as funcionalidades esperadas.

Informações públicas(expostas pela Steam para interessados) inclui:

Seu identificador Steam (na forma de 64-bit, para gerar ligações)
Seu apelido (para fins de exibição)
Seu avatar (hash, para fins de exibição)

As informações condicionalmente públicas (expostas pelo Steam a cada parte interessada se você atender aos requisitos da listagem) incluem:

Seu inventário (para que as pessoas possam usar MatchActively com os seus itens).

Informações privadas (dados selecionados necessários para fornecer as funcionalidades) incluem:

Seu token de trocas (para que pessoas fora da sua lista de amigos possam te enviar propostas de trocas)
Sua configuração MatchableTypes (para fins de exibição e correspondência)
Suca configuração MatchEverything (para fins de exibição e correspondência)
Sua configuração MaxTradeHoldDuration (para que outras pessoas saibam se você está disposto a aceitar as trocas)

Seus dados serão armazenados por, no máximo, duas semanas se você parar de usar (anunciar na) nossa listagem, e serão excluídos automaticamente após esse período.

`MatchActively`

A configuração MatchActively é a versão ativa de SteamTradeMatcher que inclui correspondência interativa onde o bot enviará negociações para outras pessoas. Isso pode funcionar em espera sozinho, ou junto com a configuração SteamTradeMatcher. Essa função requer que você configure sua LicenseID, pois ela usa servidores terceirizados e recursos pagos para operar.

Para usar essa opção há uma série de requisitos para serem atendidas. Você precisa, pelo menos, uma conta sem restrições, o ASF 2FA ativo e ao menos um tipo válido em MatchableTypes, como cartas colecionáveis, por exemplo. Requisitos adicionais incluem a autenticação 2FA ativa há pelo menos 15 dias, última alteração de senha há mais de 5 dias, falta de limitações de conta como bloqueios, proibições do mercado e proibições de troca.

Se você cumprir todos os requisitos acima o ASF vai se comunicar periodicamente com a nossa listagem STM pública do ASF para corresponder automaticamente com nossos bots que estiverem disponíveis.

Durante a correspondência o ASF vai pesquisar em seu inventário, então comunicar com nosso servidor para encontrar todos os possíveis MatchableTypes de outros bots que estejam disponíveis. Já que a comunicação é feita diretamente com nosso servidor o processo requer apenas uma simples requisição e já teremos informações se o bot oferece algo que nos interesse (se uma correspondencia for encontrada o ASF vai enviar e confirmar a troca automaticamente).

Esse módulo deve ser transparente. As correspondências devem começar em aproximadamente 1 hora desde a ativação do ASF, e repetirá automaticamente a cada 6 horas (caso necessário). MatchActively feature is aimed to be used as a long-run, periodical measure to ensure that we're actively heading towards sets completion, however, people that are not running ASF 24/7 may also consider using a match command. Os usuários alvos desse módulo são principalmente contas principais e contas alternativas "ocultas", embora ele possa ser usado em qualquer bot que não foi configurado para MatchEverything. In addition to that, bots with more than 500000 items are not accepted for matching due to excessive overhead, we recommend to split your inventory across several accounts in this case.

O ASF faz o seu melhor para minimizar a quantidade de solicitações e a pressão gerada por usar esta opção, enquanto maximiza a eficiência das correspondências até o limite possível. O algoritmo exato de escolha dos bots para combinar e organizar todo o processo é um detalhe de implementação do ASF e pode mudar de acordo com os feedbacks, situações e possíveis ideias futuras.

A versão atual do algoritmo faz com que o ASF priorize os bots Any, especialmente aqueles que têm uma maior diversidade de jogos dos quais seus itens provêm. When running out of Any bots, ASF will move on to the Fair ones upon same diversity rule. ASF will try to match every available bot at least once, to ensure that we're not missing on a possible set progress.

O MatchActively leva em conta os bots que você pôs na lista negra de trocas através do comando tbadd e não vai tentar trocas com eles. Pode ser usado para dizer ao ASF quais bots nunca devem ser combinados, mesmo se eles tiverem potenciais duplicatas que poderíamos usar.

ASF will also do its best to ensure that the trade offers are going through. On the next run, which normally happens in 6 hours, ASF will cancel any pending trade offers that still weren't accepted, and deprioritize steamIDs taking part in them to hopefully prefer more active bots first. Still, if deprioritized bots are the last ones that have the match we need, we'll still attempt to match them (again).

Why do I need a `LicenseID` to use `MatchActively`? Não era de graça anteriormente?

ASF é, e continua de graça, com o código aberto, Como foi definido no começo do projeto em outubro de 2015. Source code of ItemsMatcher plugin and therefore MatchActively feature is available in our repository, while ASF program is 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 on fetching inventories of other bots - which rendered previous functionality entirely broken, with no possibility of a solution to resolve this problem. Therefore, due to the fact that the feature has became entirely defunct with no chance of being fixed, it had to be removed from ASF core as obsolete.

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 hundred of paid 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 functionality to our sponsors, that is, people that already support ASF project on monthly basis, thanks to whom we can make those paid resources available.

Our goal isn't to profit from it, but rather, cover the monthly costs that are exclusively linked with offering this option - 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 each month, just to make it available for you. We're not really in a position to discuss the price either, it's Valve that forced those costs upon us, and the alternative is to not have such feature available at all, which of course applies if you decide, for whatever reason, that you can't justify using our plugin on those terms.

In any case, we understand that MatchActively is not for everybody, and we hope that you also understand why we can't offer it for free.

Como posso conseguir acesso?

ItemsMatcher is offered as part of monthly $5+ sponsor tier on JustArchi's GitHub. It's also possible to become one-time sponsor, although in this case the license will be valid only for a month (with possibility of extension in the same way). Once you become a sponsor of $5 tier (or higher), read configuration section to obtain and fill LicenseID. Afterwards, you only need to enable MatchActively in TradingPreferences of your chosen bot.

The license allows you to send limited amount of requests to the server. O nível $5 permite usar o MatchActively para uma conta bot (4 solicitações diárias), e cada $5 adicional adiciona mais duas contas bot (8 solicitações diariamente). For example, if you want to run it on three accounts, that'll be covered by $10 tier and higher.