Setting up ru RU

Установка

Если вы пришли сюда впервые - Добро Пожаловать! Рады видеть что ещё один путник заинтересован в нашем проекте, но просим вас не забывать, что с большой силой приходит большая ответственность - ASF может сделать в Steam многое, но только если вам не лень учиться, как им пользоваться. Кривая обучения довольно крутая, и поэтому от вас ожидается что вы прочтёте эту wiki, которая подробно описывает как всё работает.

Если вы всё ещё читаете, значит вас не напугало вступление выше, и это радует. Конечно, если вы не пропустили его, в противном случае у вас скоро будут большие проблемы... В любом случае, ASF это консольное приложение, а это значит что у этой программы отсутствует дружественный графический интерфейс к которому большинство из вас привыкло, по крайней мере, из коробки. ASF разрабатывался в первую очередь для работы на серверах, и поэтому работает как служба (демон), а не как настольное приложение.

Однако это не означает что вы не можете пользоваться им на своём ПК, или пользоваться им каким-то более сложным способом, ничего такого. ASF это отдельная программа не требующая инсталляции, и работает сразу "из коробки", однако требует конфигурирования чтобы быть полезной. Конфигурирование это способ указать ASF, что нужно делать после запуска. Если вы запустите ASF без конфигурирования, оно просто ничего не будет делать.

---

Установка для конкретных ОС

В общем случае, вот что нам придётся сделать в следующие несколько минут:

• Установить предусловия для .NET.
• Скачать последнюю версию ASF в варианте для конкретной ОС.
• Распаковать архив в новое место.
• Сконфигурировать ASF.
• Запустить ASF и увидеть магию.

Звучит довольно просто, правда? Давайте займёмся этим.

---

.NET prerequisites

Первое что надо сделать - убедиться, что ваша ОС вообще может запустить ASF. ASF is written in C#, based on .NET platform and may require native libraries that are not available on your platform yet. Depending on whether you use Windows, Linux or OS X, you will have different requirements, although all of them are listed in .NET prerequisites document that you should follow. Это справочный материал, который вам следует использовать, но ради простоты мы также перечислили все необходимые пакеты ниже, так что вам нет нужды читать документ полностью.

Совершенно нормально, если некоторые (или деже все) зависимости уже присутствуют в вашей системе из-за стороннего программного обеспечения которым вы пользуетесь. Однако, вы должны убедиться что это действительно так, запустив соответствующий инсталлятор для своей ОС - без этих зависимостей ASF вообще не запустится.

Keep in mind that you don't need to do anything else for OS-specific builds, especially installing .NET SDK or even runtime, since OS-specific package includes all of that already. You need only .NET prerequisites (dependencies) to run .NET runtime included in ASF.

Windows:

• Microsoft Visual C++ Redistributable Update (x64 for 64-bit Windows, x86 for 32-bit Windows)
• Настоятельно рекомендуется убедиться, что у вас уже установлены все обновления Windows. At the very least you need KB2533623, KB2999226, but more updates may be needed. Все они уже должны быть установлены если ваша Windows полностью обновлена. Убедитесть что вы выполнили эти требования до того как устанавливать пакет Visual C++.
• If you're using Windows 7, you'll be forced to run generic variant as your OS is no longer supported by OS-specific package. We strongly recommend an update soon, as future versions of ASF are likely to stop working altogether with it, not to mention that the OS reached its end of life back in 2020.

Linux:

Имена пакетов зависят от того, каким дистрибутивом Linux вы пользуетесь, мы перечисляем наиболее распространённые. Вам можете получить их все с помощью встроенного менеджера пакетов для вашей ОС (таким как apt для Debian или yum для CentOS).

• ca-certificates (standard trusted SSL certificates to make HTTPS connections)
• libc6 (libc)
• libgcc1 (libgcc)
• libicu (icu-libs, последняя версия для вашего дистрибутива, например libicu67)
• libgssapi-krb5-2 (libkrb5-3, krb5-libs)
• libssl1.1 (libssl, openssl-libs, latest version for your distribution, at least 1.1.X as 1.0.X may no longer work)
• libstdc++6 (libstdc++, версии 5.0 или выше)
• zlib1g (zlib)

Если не все, то большинство этих пакетов должны изначально присутствовать в вашей системе. The minimal installation of Debian stable required only libicu67.

OS X:

• На данный момент никаких дополнительных требований нет, но у вас должна быть установлена последняя версия OS X, как минимум 10.15+

---

Скачивание

Теперь, раз у нас уже есть все необходимые зависимости, следующим шагом будет скачать последнюю версию ASF. ASF доступен в разных вариантах, вас интересует пакет, который подходит для вашей операционной системы и архитектуры. Например, если вы пользуетесь 64-битной Windows, вам нужен пакет ASF-win-x64. Чтобы получить подробную информацию обо всех доступных вариантах, ознакомьтесь с разделом совместимость. ASF так же можно запустить на ОС для которых мы не делаем пакетов под конкретную ОС, таких как 32-битная Windows, для этого перейдите в раздел универсальная установка.

После скачивания, начните с того чтобы распаковать zip-файл в отдельную папку. Мы рекомендуем использовать 7-zip, но все стандартные утилиты типа unzip в Linux/OS X тоже должны работать без проблем.

Рекомендуем распаковывать ASF в отдельную папку а не в какую-то папку которую вы используете для других целей - система авто-обновления ASF удалит все файлы не связанные с ASF при обновлении, и вы потеряете все свои файлы, находящиеся в папке ASF. Если у вас есть дополнительные скрипты или файлы, которые вы хотите использовать вместе с ASF, положите их на одну папку выше.

Cnруктура папок должна быть примерно такой:

C:\ASF (сюда вы сложите собственные файлы)
    ├── ASF - Ярлык.lnk (необязательно)
    ├── Config - Ярлык.lnk (необязательно)
    ├── Commands.txt (необязательно)
    ├── MyExtraScript.bat (необязательно)
    ├── (...) (любые другие файлы, которые вам нужны, необязательно)
    └── Core (выделеная папка для ASF, куда вы распаковываете архив)
         ├── ArchiSteamFarm(.exe)
         ├── config
         ├── logs
         ├── plugins
         └── (...)

---

Конфигурирование

Теперь мы готовы к последнему шагу, конфигурированию. Это пожалуй самый сложный шаг, поскольку включает в себя много новой информации с которой вы пока не знакомы, поэтому здесь мы предоставим несколько понятных примеров и упрощённое объяснение.

Первое и главное, у нас есть раздел "Конфигурация" в котором подробно разъясняется всё что связано с конфигурированием, но это огромный объём новой информации, значительная часть которой всё равно вам пока не потребуется. Вместо этого, мы научим вас, как получить ту информацию, которую вы ищете.

Конфигурацию ASF можно выполнить как минимум тремя способами - с помощью нашего генератора веб-конфигураций, ASF-ui или вручную. Это объяснено в деталях в разделе "Конфигурация", поэтому если вам нужна подробная информация - обращайтесь для справок к этому разделу. Мы будем использовать генератор веб-конфигураций в качестве отправной точки.

Перейдите на страницу сетевого генератора конфигураций в своём любимом браузере, вам понадобится включенный javascript (на случай если вы его отключили вручную). Мы рекомендуем Chrome или Firefox, но генератор должен работать в любом из современных популярных браузеров.

После того, как вы перешли на страницу генератора, переключитесь на закладку "Бот". Вы должны увидеть страницу, похожую на показанную ниже:

Если по каким-то причинам версия ASF, которую вы скачали, более старая чем та, которая используется генератором конфигураций по-умолчанию, просто выберите нужную вам версию ASF в выпадающем меню. Это может произойти из-за того, что генератор конфигруаций можно использовать для создания конфигураций для более новых (до-релизных) версий ASF, которые ещё отмечены как стабильные. А вы скачали последнюю стабильную версию ASF, которая проверена и надёжно работает.

Начните с ввода имени бота в поле, подсвеченное красным. Это может быть любое имя, такое как ваш никнейм, имя аккаунта, число, или что-то ещё. Есть только одно слово, которое нельзя использовать, ASF, поскольку это слово зарезервировано для файла глобальной конфигурации. Кроме того, имя вашего бота не может начинаться с точки (ASF намеренно игнорирует такие файлы). Мы так же рекомендуем не использовать пробелы, вы можете пользоваться символом _ для разделения слов, если надо.

После того, как вы определились с именем, включите переключатель Enabled, это определяет будет ли ASF автоматически запускать вашего бота после запуска программы.

Теперь вам надо выбрать один из двух вариантов:

• Вы можете указать свой логин в поле SteamLogin и свой пароль в поле SteamPassword
• Или вы можете оставить эти поля пустыми

Если вы их укажете - ASF сможет автоматически использовать ваши учетные данные при запуске, и вам не придётся вводить их каждый раз когда они нужны ASF. Однако вы можете решить не указывать их, чтобы они не сохранялись, ASF в этом случае не сможет запустится без вашей помощи, и вам придётся вводить их во время работы.

ASF требуются ваши учетные данные поскольку в нём используется собственная реализация клиента Steam, которому требуются те же данные для входа, что и официальному клиенту. Ваши учётные данные не сохраняются нигде, кроме папки config ASF на вашем ПК, наш генератор конфигураций тоже работает на стороне клиент, то есть вы можете запустить его локально в своём браузере чтобы сгенерировать валидные файлы конфигураций, и при этом ваши учётные данные не покидают вашего ПК, поэтому нет нужды беспокоится об утечке данных. Однако, если по какой-то причине вы не хотите вводить учётные данные в генероторе, мы относимся к этому с пониманием, вы можете вставить их в созданные файлы потом, или вообще опустить их, и вводить только по запросу ASF в командной строке. Узнать больше о мерах безопасности вы можете в разделе посвященном конфигурации.

Кроме того вы можете оставить пустым только одно поле, например SteamPassword, тогда ASF сможет автоматически подставить логин, но запросит пароль при старте (аналогично клиенту Steam). Если вы используете Семейный просмотр Steam, вам понадобиться ввести его ПИН-код в поле SteamParentalCode.

После принятия этих решений и ввода дополнительных данных, ваша страница будет выглядеть похоже на это:

Теперь вы можете нажать на кнопку "Скачать" и сетевой генератор конфигураций создаст новый json-файл с выбранным вами именем. Сохраните этот файл в папке config, которая расположена внутри папки куда вы распаковали zip-файл на предыдущем шаге.

Ваша папку config будет выглядить примерно так:

Поздравляем! Вы только что закончили очень простую конфигурацию бота для ASF. Вскоре мы её расширим, но пока это всё что вам нужно.

---

Запуск ASF

Теперь вы готовы к первому запуску программы. Просто дважды кликните на запускаемом файле ArchiSteamFarm в папке ASF. Вы также можете запустить это через консоль.

После этого, если вы установили все необходимые зависимости в самом начале, ASF должен успешно запуститься, обнаружить вашего первого бот (если вы не забыли положить сгенерированный файл конфигурации в папку config) и попытаться войти:

Если вы указали SteamLogin и SteamPassword для использования в ASF, у вас запросят только код SteamGuard (из e-mail, из приложения для аутентификации или вообще никакго, в зависимости от настроек вашего аккаунта в Steam). Если нет, вас попросят ввести логин и пароль Steam.

Сейчас самое время ознакомиться с разделом Политика конфиденциальности, если вас беспокоят вещи, на которые ASF запрограммирован, например, присоединение к определенной группе Steam при запуске.

После прохождения первоначального входа в систему, если ваши данные верны, вы успешно войдете в систему, и ASF начнет фарм, используя настройки по умолчанию, которые вы не меняли на данный момент:

Это показатель того, что ASF успешно выполняет свою работу на вашем аккаунте, теперь вы можете свернуть окно программы и заняться чем-то ещё. После некоторого времени (в зависимости от производительности), вы увидите что начали падать коллекционные карточки Steam. Конечно, это случится только если у вас есть игры которые можно фармить, для которых на странице значков указано "Выпадет ещё XX карточек" - если же игр для фарма нет, ASF сообщит, что ему нечем заняться, как описано в нашем FAQ.

Этим завершается наша очень простая инструкция по установке. Теперь вы можете решить, хотите ли вы настраивать ASF дальше, или позволить ему работать с настройками по-умолчанию. Мы упомянем ещё несколько простых подробностей, а затем оставим вас наедине с wiki.

---

Расширенное конфигурирование

Фарм на нескольких аккаунтах одновременно

ASF поддерживает фарм на нескольких аккаунтах одновременно, это его основная функция. Вы можете добавлять новые аккаунты к ASF создавая новые файлы конфигурации ботов, точно так же как вы создали для первого бота несколько минут назад. Вам нужно следить только за двумя вещами:

• Уникальное имя бота, если ваш первый бот назван "MainAccount" вы не можете создать ещё одного с таким же именем.
• Правильные учётные данные, такие как SteamLogin, SteamPassword и SteamParentalCode (если вы используете семейный просмотр Steam)

Другими словами, просто снова перейдите к конфигурированию, и сделайте всё точно так же, но для второго и третьего аккаунтов. Не забывайте давать уникальные имена всем вашим ботам.

---

Изменение настроек

Вы можете поменять существующие настройки точно так же - просто сгенерировав новый файл конфигурации. Если вы ещё не закрыли сетевой генератор, нажмите на кнопку "Отображение расширенных настроек" и посмотрите, что там ещё есть. С целью обучения мы поменяем параметр CustomGamePlayedWhileFarming, который позволяет указать произвольное название, которое ASF будет отображать в процессе фарма вместо настоящего названия запущенной игры.

Если вы просто запустите ASF и начнёте фарм, по умолчанию ваш аккаунт Steam получит статус "в игре":

Давайте это поменяем. Включите расширенные настройки в сетевом генераторе, и найдите параметр CustomGamePlayedWhileFarming. Когда найдёте, впишите туда произвольный текст, который вы хотите отобразить, например "Idling cards":

Теперь скачайте новый файл конфигурации так же как раньше, и замените ваш старый файл конфигурации новым. Конечно же, вы можете так же сначала удалить старый файл конфигурации а потом положить новый на его место.

Когда вы это сделаете - снова запустите ASF, и вы увидите что заданный вами текст выводится вместо названия игры:

Это указывает на то, что вы успешно изменили конфигурацию. Точно так же вы можете изменять и глобальные настройки ASF, переключившись с заклкдки "Бот" на закладку "ASF", скачав сгенерированный файл конфигурации ASF.json и поместив его в вашу директорию config.

Редактировать конфигурацию ASF намного проще, используя наш интерфейс ASF-ui, о котором будет объяснено ниже.

---

Использование ASF-ui

ASF - консольное приложение и не имеет графического интерфейса пользователя. Однако мы активно работаем над интерфейсом ASF-ui для нашего интерфейса IPC, и он может служить практичным и удобным способом доступа к различным возможностям ASF.

Чтобы использовать ASF-ui, вам необходимо включить IPC, что является параметром по умолчанию, начиная с ASF V5.1.0.0. После запуска ASF вы сможете убедиться, что он автоматически запустил интерфейс IPC:

Вы можете получить доступ к IPC-интерфейсу ASF по этой ссылке, пока ASF работает, с этого же компьютера. Вы можете использовать ASF-ui для различных целей, например редактирование файлов конфигурации на месте или отправка команд. Вы можете самостоятельно исследовать ASF-ui чтобы узнать все его возможности.

Обратите внимание, что для некоторых функций, таких как отправка команд, требуется правильно настроенное глобальное свойство конфигурации SteamOwnerID. Теперь, когда у вас есть ASF-ui, почему бы не попробовать и не установить его (SteamOwnerID) из самого интерфейса? Вам нужно будет ввести уникальный идентификатор Steam в 64-битной форме вашей учетной записи. Вы можете узнать его разными способами, например, через STEAMID I/O или SteamRep. Номер, который вы ищете, должен быть похож на 76561198006963719, который является идентификатором вашей учетной записи.

---

Резюме

Вы успешно установили и настроили ASF для ваших аккаунтов Steam, и даже немного поменяли настройки на свой вкус. Если вы следовали всему нашему руководству, то вам также удалось настроить ASF через наш интерфейс ASF-ui и обнаружить, что ASF на самом деле имеет какой-то графический интерфейс. Сейчас отличное время, чтобы прочитать весь раздел конфигурации, чтобы узнать, что на самом деле делают все эти различные настройки, которые вы видели, и что предлагает ASF. Если вы наткнулись на какую-то проблему или у вас есть общий вопрос, прочтите вместо него наш FAQ, который должен охватывать все, или по крайней мере, подавляющее большинство вопросов, которые могут у вас возникнуть. Если хотите узнать всё об ASF и о том, как оно может облегчить вам жизнь, прочтите оставшиеся разделы нашей wiki. Если вы узнали, что наша программа полезна для вас, и чувствуете щедрость, вы также можете подумать о пожертвовании нашему проекту. В любом случае, веселись!

---

Универсальная установка

Это установка для продвинутых пользователей, которые хотят запустить ASF в универсальном варианте. Этот вариант не рекомендуется для людей, которые могут воспользоваться пакетами под конкретную ОС.

Вы можете использовать вариант generic в основном в этих ситуациях (но, конечно, вы можете использовать его независимо):

• Если вы используете ОС, для которой мы не выпускаем пакета под конкретную ОС (например 32-битная Windows)
• When you already have .NET Runtime/SDK, or want to install and use one
• Если вы хотите минимизировать файловую структуру ASF вручную обеспечивая требования среды исполнения
• Если вы хотите использовать собственный плагин, который требует общей настройки ASF для правильной работы (из-за отсутствия собственных зависимостей)

However, keep in mind that you're in charge of .NET runtime in this case. This means that if your .NET SDK (runtime) is unavailable, outdated or broken, ASF won't work. This is why we don't recommend this setup for casual users, since you now need to ensure that your .NET SDK (runtime) matches ASF requirements and can run ASF, as opposed to us ensuring that our .NET runtime bundled with ASF can do so.

Для универсального пакета, вы можете следовать всему руководству по установке под конкретную ОС, приведенному выше, с двумя небольшими отличиями. In addition to installing .NET prerequisites, you also want to install .NET SDK, and instead of having OS-specific ArchiSteamFarm(.exe) executable file, you now have a generic ArchiSteamFarm.dll binary only. Всё остальное практически точно так же.

Вместе с дополнительными шагами, вы должны:

• Установить предусловия для .NET.
• Install .NET SDK (or at least ASP.NET Core runtime) appropriate for your OS. Скорее всего вы захотите использовать установщик. Обратитесь к разделу "Требования среды исполнения" если не уверены, какую версию вам надо установить.
• Скачать последнюю версию ASF в универсальном (generic) варианте.
• Распаковать архив в новое место.
• Сконфигурировать ASF.
• Запустить ASF либо с помощью предоставленного скрипта, либо вручную командой dotnet /path/to/ArchiSteamFarm.dll из вашей любимой оболочки командной строки.

Скрипты для запуска (такие как ArchiSteamFarm.cmd для Windows и ArchiSteamFarm.sh для Linux/OS X) расположены там же, где и запускаемый файл ArchiSteamFarm.dll, и включены только в универсальный пакет для установки. Вы можете воспользоваться ими если не хотите запускать команду dotnet вручную. Obviously helper scripts won't work if you didn't install .NET SDK and you don't have dotnet executable available in your PATH. Скрипты для запуска не обязательны к использованию, вы всегда можете вручную запустить команду dotnet /path/to/ArchiSteamFarm.dll.