Skip to content

Setting up pt BR

Jump to bottom
ArchiBot edited this page Aug 6, 2024 · 88 revisions

Primeiros passos

Se você está aqui pela primeira vez, bem-vindo! Estamos felizes em saber que outro viajante está interessado em nosso projeto, no entanto tenha em mente que grandes poderes trazem grandes responsabilidades; o ASF é capaz de fazer muitas coisas relacionadas ao Steam, mas somente enquanto você se preocupar em aprender como usá-lo. Há uma curva de aprendizagem aqui e esperamos que você leia a wiki a este respeito, que explica detalhadamente como tudo funciona.

Se você ainda está aqui significa que você suportou o texto acima, o que é bom. A não ser que você tenha pulado ele, então você vai ter alguns problemas logo mais... De qualquer forma, o ASF é um aplicativo de console, o que significa que o programa não tem uma interface amigável que você geralmente está acostumado, ao menos não a princípio. O ASF foi projetado principalmente para ser executado em servidores e, portanto, funciona como um serviço (daemon) e não como um aplicativo da área de trabalho.

Isso não significa que você não possa usá-lo no seu computador ou que o uso é mais complicado que o normal, não é nada disso. O ASF é um programa autônomo que funciona imediatamente e não necessita de instalação, mas necessita de uma configuração para se tornar útil. É a configuração que vai dizer ao ASF o que ele deve fazer depois que você executá-lo. Se você o iniciar sem configurar antes ele simplesmente não fará nada.

Instalador para sistemas operacionais específicos

Em geral, é isso que vamos fazer nos próximos minutos:

Parece simples o bastante, certo? Então, vamos ver.

Pré-requisitos do .NET

O primeiro passo é garantir que seu sistema operacional pode mesmo executar o ASF corretamente. O ASF é escrito em C#, baseado na plataforma .NET e pode requerer bibliotecas nativas que ainda não estão disponíveis na sua plataforma. Os requisitos serão diferentes se você usa Windows, Linux ou OS X, embora todos estejam listados no documento pré-requisitos .NET Core que você deve seguir. Esse é nosso material de referência e ele deve ser usado, mas para simplificar nós detalhamos todos os pacotes necessários abaixo para que você não precise ler todo o documento.

É perfeitamente normal que algumas dependências (ou mesmo todas) já tenham sido instaladas no seu sistema por algum outro software que você use. Ainda assim, você deve garantir executando o instalador apropriado para seu sistema operacional - sem essas dependências o ASF não vai nem iniciar.

Lembre-se de que você não precisa fazer mais nada para builds específicos do sistema operacional, especialmente instalar o .NET SDK ou mesmo o runtime, pois o pacote específico do sistema operacional já inclui tudo isso. Você só precisa dos pre requisitos do .NET(dependencias) para rodar .NET runtime incluido no ASF.

Windows:

  • Atualização Redistributável do Microsoft Visual C ++ (x64 para 64-bit, x86 para 32-bit ou arm64 para 64 bits de ARM)
  • É altamente recomendado garantir que todas as atualizações do Windows estejam instaladas. Caso você não os tiver habilitados, então, pelo menos, você precisa das atualizações KB2533623 e KB2999226, mas outras atualizações podem ser necessárias. Você não precisa instalá-los se o seu Windows estiver atualizado.

Linux:

Os nomes dos pacotes dependem da distribuição do Linux que você esteja usando, nós listamos as mais comuns. Você pode obter todas elas com o gerenciador de pacotes nativo do seu SO (como apt para Debian ou yum por CentOS).

  • ca-certificates (certificados SSL padrão confiáveis para fazer conexões HTTPS)
  • libc6 (libc)
  • libgcc-s1 (libgcc1, libgcc)
  • libicu (icu-libs, versão mais recente para a sua distribuição, por exemplo, libicu72)
  • libgssapi-krb5-2 (libkrb5-3, krb5-libs)
  • libssl3 (libssl, openssl-libs, versão mais recente para a sua distribuição, pelo menos 1.1.X)
  • libstdc++6 (libstdc++, na versão 5.0 ou superior)
  • zlib1g (zlib)

Pelo menos a maioria deles já deve estar disponível nativamente no seu sistema. A instalação mínima do Debian estável requer apenas libicu72.

macOS:

  • Nenhum por enquanto, mas você deve ter a versão mais recente do macOS instalada, pelo menos 12.0+

Baixando

Uma vez que já tenhamos todas as dependências, o próximo passo é baixar a última versão do ASF. ASF está disponível em diversas variantes, mas você está interessado no pacote que corresponde ao seu sistema operacional e a arquitetura dele. Por exemplo, se você estiver usando o Windows 64-bit, então você vai baixar o pacote ASF-win-x64. Para obter mais informações sobre as variantes disponíveis, visite a seção **compatibilidade. O ASF é também capaz de rodar em SOs para os quais ele não tem um pacote específico, tal como o Windows 32-bit, vá até configuração genérica para saber mais.

Arquivos

Após o download, comece extraindo o arquivo zip para sua própria pasta. Se você precisar de uma ferramenta específica para isso, 7 zip fará isso, mas todos os utilitários padrão como unzip do Linux/macOS também devem funcionar sem problemas.

Certifique-se de descompactar o ASF para a sua própria pasta e não para outra existente que você esteja usando para outra coisa - as atualizações automáticas do ASF vão excluir todos os arquivos velhos e não relacionados, o que vao fazer você perder qualquer coisa não relacionada que esteja na mesma pasta. Se você tiver qualquer scripts ou arquivos extras que você quer usar com o ASF, coloque-os uma pasta acima.

Uma exemplo de extrutura seria assim:

C:\ASF (onde você coloca suas coisas)
    ├── ASF shortcut.lnk (opcional)
    ├── Config shortcut.lnk (opcional)
    ├── Commands.txt (opcional)
    ├── MyExtraScript.bat (opcional)
    ├── (...) (quaisquer outros arquivos que quiser, opcional)
    └── Core (dedicado apenas ao ASF, onde você extrai os arquivos)
         ├── ArchiSteamFarm(.exe)
         ├── config
         ├── logs
         ├── plugins
         └── (...)

Configuração

Agora estamos prontos para a última etapa, a configuração. Este é de longe o passo mais complicado, uma vez que envolve um monte de informações com as quais você ainda não está familiarizado, então vamos tentar fornecer alguns exemplos fáceis de entender e uma explicação simplificada.

Primeiro e mais importante, há uma página dedicada a configuração que explica tudo relacionado a isso, mas ela contém uma enorme quantidade de informações e a maioria não precisamos saber de imediato. Em vez disso, nós ensinaremos a você como obter as informações que você está procurando.

A configuração de ASF pode ser feita de três formas - usando nosso gerador de configuração web, o ASF-ui ou manualmente. Isto é explicado profundamente na seção configuração, consulte-a se você quer informações mais detalhadas. Nós vamos começar com o gerador de configuração web.

Navegue até a página do nosso gerador de configuração web com o seu navegador favorito, você precisará ter o javascript habilitado no caso de você tê-lo desativado manualmente. Recomendamos o Chrome ou o Firefox, mas ele deve funcionar em todos os navegadores mais populares.

Depois de abrir a página, vá até a guia "Bot". Você verá uma página semelhante a mostrada abaixo:

Aba bot

Se por acaso a versão do ASF que você acabou de baixar é mais velha que a versão que o gerador de configuração está definido para usar por padrão, escolha a sua versão ASF no menu suspenso. Isso acontece porque ele pode gerar configurações para as versões mais novas (pré-lançamentos) do ASF que ainda não foram marcadas como estáveis. Você certamente baixou a última versão estável do ASF, que é verificada para trabalhar de forma confiável.

Comece colocando o nome que você quer dar ao bot no campo marcado em vermelho. Pode ser qualquer nome que você quiser, tais como seu apelido, nome da conta, um número ou qualquer outra coisa. Há apenas uma palavra que você não pode usar: ASF, pois esse nome é reservado para o arquivo de configuração global. Além disso, o nome não pode começar com um ponto (o ASF ignora esses arquivos). Também recomendamos que você evite usar espaços, você pode usar _ como espaçamento, se necessário.

Depois que você escolheu um nome, ative o botão Enabled, ele define se o ASF deve iniciar seu bot automaticamente quando ele (o programa) for aberto.

Agora você pode decidir sobre duas coisas:

  • Você pode por seu login no campo SteamLogin e sua senha no campo SteamPassword
  • Ou pode deixá-los em branco

A primeira vai permitir que o ASF use suas credenciais de conta automaticamente durante a inicialização, então você não precisará colocá-las manualmente cada vez que ASF necessite. Você pode, no entanto, decidir omiti-las e nesse caso elas não serão salvas, mas assim o ASF não será capaz de iniciar automaticamente sem a sua ajuda e você precisará entrar com esses durante o tempo de execução.

O ASF precisa de suas credenciais porque inclui a sua própria implementação do cliente Steam e precisa dos mesmos dados que você usa para se conectar. Suas credenciais de login não são salvas em nenhum lugar além da pasta config do ASF no seu próprio PC, nosso gerador de configuração web é baseado no cliente, o que significa que seu código roda localmente no seu navegador para gerar as configurações válidas, sem que os dados que você entra deixem seu PC de forma alguma, então não precisa se preocupar com qualquer possibilidade de vazamento de dados. Ainda assim, se por qualquer motivo você não quer colocar seus dados lá, nós entendemos, você pode colocá-los manualmente mais tarde nos arquivos gerados ou omiti-los totalmente e colocá-los somente no prompt de comando do ASF. Mais informações sobre segurança podem ser encontradas na seção configuração.

Você também pode optar por deixar apenas um campo vazio, como SteamPassword por exemplo, o ASF então será capaz de usar seu login automaticamente, mas ainda vai pedir a senha (semelhante ao cliente Steam). Se você usa o PIN do modo família para desbloquear a conta você precisará ira para as configurações avançadas e colocá-lo no campo SteamParentalCode.

Depois que você fizer suas decisões sobre dados opcionais, sua página estará semelhante a abaixo:

Aba bot 2

Agora você pode clicar em "baixar" e o gerador de configuração web vai gerar um arquivo json com o nome que você escolheu. Salve o arquivo na pasta config que está localizado na pasta onde você extraiu nosso arquivo zip na etapa anterior.

Sua pasta config ficará assim:

Estrutura 2

Parabéns! Você acabou de terminar a configuração básica de um bot ASF. Nós vamos ampliar isso em breve, mas por enquanto isso é tudo o que você precisa saber.

Executando o ASF

Agora você está pronto para abrir o programa pela primeira vez. Simplesmente clique duas vezes no executável ArchiSteamFarm na pasta ASF. Você tambem pode iniciar-lo pelo console.

Depois disso, supondo que você instalou todas as dependências listadas na primeira etapa, o ASF deve iniciar corretamente, detectar seu primeiro bot (se você não se esqueceu de colocar o arquivo de configuração gerado na pasta config) e tentar se conectar:

ASF

Se você definiu o SteamLogin e o SteamPassword no arquivo de configuração, será solicitado apenas o seu token do SteamGuard (e-mail, 2FA ou nenhum, dependendo das configurações do Steam). Caso contrário o ASF também pedirá seu login e senha do Steam.

Agora seria um bom momento para revisar a nossa seção de comunicação remota caso você estiver preocupado com o que o ASF está programado para fazer, incluindo ações que ele realizará em seu nome, como entrar em nosso grupo Steam.

Após a etapa de conexão, supondo que seus dados estejam corretos, você vai entrar com êxito no Steam e o ASF começará a coleta automática, usando as configurações padrão que você ainda não alterou:

ASF 2

Isso prova que o ASF está fazendo seu trabalho na sua conta, então você pode minimizá-lo e fazer outra coisa. Depois de decorrido algum tempo (dependendo do desempenho) você verá as cartas aparecerem no seu inventário. Claro, para que isso aconteça, você deve ter jogos válidos para coletar, exibindo como "você pode obter mais X cartas ao jogar este jogo" na sua página de insígnias - se não houver jogos para coletar, então o ASF indicará que não há nada a fazer, como indicado em nosso FAQ.

Isso conclui nosso guia de configuração básica. Agora você pode decidir se deseja configurar o ASF ainda mais ou deixá-lo fazer seu trabalho com as configurações padrão. Vamos cobrir mais alguns detalhes básicos e, em seguida, deixar toda a wiki para você descobrir.

Configuração estendida

Coletando de várias contas ao mesmo tempo

O ASF suporta a coleta automática em mais de uma conta por vez, o que é sua principal função. Você pode adicionar mais contas ao ASF gerando mais arquivos de configuração de bot, exatamente da mesma forma que o primeiro foi gerado a poucos minutos atrás. Você precisa garantir apenas duas coisas:

  • Um nome exclusivo para cada bot, se o seu primeiro bot se chama "ContaPrincipal", você não pode ter outro com o mesmo nome.
  • Dados de login válidos, como SteamLogin, SteamPassword, e SteamParentalCode (se estiver usando o modo família do Steam)

Em outras palavras, simplesmente volte a configuração e faça exatamente a mesma coisa, só que dessa vez para a segunda ou terceira conta. Lembre-se de usar nomes exclusivos para todos os teus bots.

Alterando configurações

Você pode alterar as configurações existentes exatamente da mesma forma: gerando um novo arquivo de configuração. Se você não fechou o nosso gerador de configuração web ainda, clique em "Alternar configurações avançadas" e veja o que há para descobrir. Neste tutorial, vamos alterar a configuração CustomGamePlayedWhileFarming, que permite definir um nome personalizado para ser exibido enquanto o ASF está coletando, em vez de mostrar o jogo real.

Então, vamos fazer isso, caso você iniciar o ASF e a coleta de cartas for iniciada, nas configurações padrão você verá que sua conta Steam está no jogo agora:

Steam

Vamos mudar isso. Vá para as configurações avançada do gerador de configuração web e encontre CustomGamePlayedWhileFarming. Coloque no campo o texto que você quer mostrar, por exemplo: "Idling Cards":

Aba bot 3

Agora baixe o arquivo de configuração da mesma forma que antes e substitua o arquivo antigo por esse. Você também pode apagar o antigo e colocar esse novo no lugar.

Assim que fizer isso e abrir o ASF novamente você vai perceber que o Steam agora mostra seu texto:

Steam 2

Isso confirma que você editou sua configuração com êxito. Da mesma forma que você pode alterar as propriedades globais do ASF, mudando da aba de bots para a aba "ASF", baixando o arquivo de configuração gerado ASF.json e colocando-o no diretório config.

A edição das configurações do ASF pode ser feita de uma forma muito fácil usando nosso front-end ASF-ui, que será explicado abaixo.

Usando a ASF-ui

O ASF é um aplicativo de console e não inclui uma interface gráfica de usuário (GUI). No entanto, estamos trabalhando ativamente em nossa interface IPC, o ASF-ui que pode ser uma forma muito boa e amigável de acessar vários recursos do ASF.

Para usar o ASF-ui, você precisa ter o IPC habilitado, que é a opção padrão. Assim que você iniciar o ASF, deverá ser capaz de confirmar que a interface IPC foi iniciada automaticamente corretamente:

IPC

Você pode acessar a interface IPC do ASF por esse link, desde que o ASF esteja rodando no mesmo computador. Você pode usar a ASF-ui para muitas coisas como, por exemplo, editar os arquivos de configuração ou enviar comandos. Sinta-se a vontade para dar uma olhada e descobrir todas as funcionalidade da ASF-ui.

ASF-ui

Resumo

Você já configurou com sucesso o ASF para que ele use suas contas Steam e você já o customizou um pouco a seu gosto. Se você seguiu o guia inteiro, então você também conseguiu ajustar o ASF através da nossa interface ASF-ui e descobriu que o ASF, na verdade, tem um tipo de interface gráfica. Agora é uma boa hora para ler a seção completa de configuração para aprender sobre todos os outros parâmetros que você viu na guia de configuração avançada e ver o que o ASF pode oferecer. Se você de deparou com algum problema ou você tem alguma pergunta genérica, leia a seção de perguntas frequentes (FAQ) que deve cobrir tudo, ou pelo pelo menos a grande maioria das perguntas que você possa ter. Se você quer aprender tudo sobre o ASF e como le pode tornar sua vida mais fácil, visite o resto da nossa wiki. Se você achou nosso programa útil e aprecia o grande trabalho que foi feito, você também pode considerar uma doação para a nossa causa. De qualquer forma, divirta-se!

Configuração genérica

Esta configuração é para usuários avançados que desejam configurar a versão genérica do ASF. Embora sejam mais complicados de usar do que as versões específicas do sistema operacional, eles também oferecem benefícios adicionais.

Você deve preferir usar a variante generic (genérica) nessas situações (mas é claro você pode usá-la independentemente disso):

  • Quando você estiver usando um sistema operacional para o qual não temos um pacote específico (como o Windows 32-bit, por exemplo)
  • Quando você já tem o .NET Runtime/SDK ou deseja instalar e usar um
  • Quando você deseja minimizar o tamanho da estrutura do ASF e o uso de memória, gerenciando os requisitos de runtime por conta própria
  • Quando você deseja usar um plugin personalizado que requer uma configuração generic do ASF para ser executado corretamente (devido à falta de dependências nativas)

No entanto, lembre-se de que, nesse caso, você é responsável pelo runtime do .NET. Isso significa que, se o seu .NET SDK (runtime) estiver indisponível, desatualizado ou corrompido, o ASF não funcionará. Por isso, não recomendamos essa configuração para usuários casuais, já que agora você precisa garantir que o seu .NET SDK (runtime) atenda aos requisitos do ASF e consiga executá-lo, ao contrário de nós assegurarmos que o nosso runtime do .NET incluído com o ASF possa fazê-lo.

Para o pacote generic você pode acompanhar o guia de instalação para sistemas operacionais inteiro acima, com duas pequenas alterações. Além de instalar os pré-requisitos do .NET, você também deve instalar o .NET SDK, e, em vez de ter um arquivo executável ArchiSteamFarm(.exe) específico para o sistema operacional, você terá apenas um binário genérico ArchiSteamFarm.dll. Todo o resto permanece igual.

Com etapas extras:

Scripts de ajuda (como ArchiSteamFarm.cmd para Windows e ArchiSteamFarm.sh para Linux/macOS) estão juntos com o ArchiSteamFarm.dll - eles são inclusos apenas na variante generic. Você pode usá-los se você não quer executar o comando dotnet manualmente. Obviamente os scripts de ajuda não funcionarão se você não instalar o .NET SDK e não tenha o executável dotnet disponível em seu PATH. Os scripts de ajuda são inteiramente opcionais, você pode sempre usar o método manual dotnet /path/to/ArchiSteamFarm.dll.

en-US de-DE es-ES lol-US
pt-BR ru-RU zh-CN zh-TW

👨‍🏫 Básico

👨‍🎓 Principal

🧙 Avançado

👷 Desenvolvedores

Clone this wiki locally