Setting up uk UA

Налаштування

Якщо ви тут вперше, ласкаво просимо! Ми дуже раді бачити ще одного мандрівника, який цікавиться нашим проектом, але не забувайте що з великою силою приходить велика відповідальність - ASF здатен зробити багато речей пов'язаних зі Steam, але лише за умови що ви маєте бажання навчатися, як ним користуватися. Крива навчання досить крута, тому ми очікуємо від вас, що ви прочитаєте цю вікі, яка детально описує як усе працює.

Якщо ви ще не кинули читати це означає що ви витримали текст вище, і це добре. Хіба що ви просто пройшли повз нього, у цьому разі для вас незабаром настануть погані часи... У будь якому разі, ASF це консольна програма, тож вона не має дружного GUI до яких ви звикли. ASF в першу чергу призначений для запуску на серверах, тому працює як сервіс (демон), а не як настільна програма.

Однак це не означає що ви не в змозі користуватися ним на вашому ПК, чи користуватися ним у якийсь більш складний спосіб ніж звичайно, нічого такого. ASF це автономна програма, яка не потребує установки, та працює відразу з коробки, але потребує конфігурації перш ніж бути корисною. Конфігурація це спосіб сказати ASF що вона має робити після запуску. Якщо ви запустите її без конфігурації, ASF просто нічого не буде робити.

Налаштування для конкретної ОС

Взагалі, ось що нам з вами треба зробити за наступні кілька хвилин:

Встановити передумови для .NET Core.
Скачати останній випуск ASf у варіанті відповідному конкретній ОС.
Розпакувати архів до нового місця (та зробити chmod +x ArchiSteamFarm якщо ви під Linux/OS X).
Сконфігурувати ASF.
Запустити ASF та подивитися на її магію.

Звучить досить просто, чи не так? Нумо зробимо це.

Передумови для .NET Core

Перший крок це переконатися, що ваша ОС взагалі може коректно запустити ASF. ASF запрограмовано на C#, на основі .NET Core та може потребувати нативні бібліотеки, які ще недоступні для вашої платформи. Залежно від того, користуєтесь ви Windows, Linux чи OS X, у вас будуть різні вимоги, але усі вони приведені у документі .NET Core prerequisites, тож користуйтеся ним. Це наш довідковий матеріал, яким слід користуватися, але щоб зробити це простішим для вас ми також наводимо усі необхідні пакети нижче, тому вам немає необхідності читати повний документ.

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

Пам'ятайте, що вам не потрібно більше нічого для запуску пакетів ASF для конкретної ОС, особливо встановлювати .NET Core SDK чи навіть середовище виконання, оскільки пакет для конкретної ОС вже включає все це до свого складу. Вам потрібні лише передумови для .NET Core (залежності), щоб запустити середовище виконання включене до ASF.

Windows:

Microsoft Visual C++ 2015 Redistributable Update (x64 для 64-bit Windows, x86 для 32-bit Windows)
Наполегливо рекомендуємо переконатися, що усі оновлення Windows вже встановлені. Якнайменше вам потрібні пакети KB2533623 та KB2999226, але можуть бути потрібні й інші. Усі вони вже встановлені якщо ваша Windows цілком оновлена. Переконайтеся що виконали ці вимоги перш ніж встановлювати пакет Visual C++.

Linux:

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

libc6 (libc)
libgcc1 (libgcc)
libicu (icu-libs, latest version for your distribution, for example libicu67)
libgssapi-krb5-2 (libkrb5-3, krb5-libs)
libssl1.1 (libssl, openssl-libs, latest version for your distribution, 1.1.X or 1.0.X)
libstdc++6 (libstdc++, in version 5.0 or higher)
zlib1g (zlib)

At least a majority of those should be already natively available on your system. The minimal installation of Debian stable required only libicu63.

OS X:

На даний час додаткових передумов немає, але у вас має бути встановлена остання версія OS X, якнайменше 10.13+

Завантаження

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

Файли

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

Якщо ви користуєтесь Linux/OS X, не забудьте виконати у розпакованій директорії команду chmod +x ArchiSteamFarm, бо дозволи не встановлюються автоматично у zip-файлі. Це треба зробити лише один раз після початкового розпакування.

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

Приклад того, як може виглядати ця структура:

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

Конфігурація

Тепер ми готові зробити останній крок, конфігурацію. Це мабуть найскладніший крок, оскільки він включає в себе велику кількість нової інформації, тому ми спробуємо надати тут кілька простих для розуміння прикладів та спрощене пояснення.

Перше й найголовніше, у нас є сторінка присвячена конфігурації, яка описує геть усе зв'язане з конфігурацією, але це величезний обсяг нової інформації, більшість з якої вам не потрібна прямо зараз. Замість цього, ми навчимо вас, як отримати інформацію, яка вам зараз потрібна.

Конфігурацію ASF можна зробити двома шляхами - або за допомогою нашого веб генератора конфігурацій, або вручну. Це докладно пояснюється у розділі конфігурації, тому зверніться до нього якщо вам потрібна детальна інформація. Ми підемо шляхом використання веб генератора конфігурацій, бо це набагато простіше.

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

Після відкриття сторінки, перейдіть на вкладку "Бот". Ви маєте побачити сторінку схожу на приведену нижче:

Вкладка Bot

Якщо за якихось обставин завантажена вами версія ASF більш стара, ніж генератор конфігурацій використовує за замовчуванням, просто оберіть потрібну версію ASF з випадного меню. Це може статися тому, що генератор конфігурацій використовується для генерації конфігурацій новішої (підготовчої) версії, яка ще не позначена як стабільна. Ви завантажили останню стабільну версію ASF, яка перевірена щодо надійної роботи.

Почніть з введення імені боту до поля, яке виділено червоним. Це може бути будь яке ім'я, яким ви б хотіли користатися, наприклад нікнейм, ім'я акаунта, номер, чи щось інше. Є лише одно слово, яке ви не можете обрати, ASF, бо це є ключове слово, зарезервоване для файлу глобальної конфігурації. На додаток до цього, ім'я вашого бота не може починатися з крапки (ASF навмисно ігнорує такі файли). Ми також рекомендуємо уникати використання пробілів, якщо потрібно ви можете користуватися символом _ для розділення слів.

Після того, як ви обрали ім'я, ввімкніть перемикач Enabled, це визначає що ASF має автоматично запускати вашого бота після запуску (програми).

Тепер вам треба обрати один з варіантів:

Ви можете додати ваш логін до поля SteamLogin та ваш пароль до поля SteamPassword
Чи ви можете залишити їх порожніми

Перший варіант дасть змогу ASF автоматично використовувати ваші облікові дані під час запуску, щоб вам не довелося вводити їх вручну при кожному запуску ASF. Однак ви можете вирішити пропустити їх, у цьому разі вони не будуть збережені і ASF не зможе автоматично стартувати без вашої допомоги, а вам доведеться вводити їх протягом роботи.

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

Також ми можете вирішити залишити пустим лише одне поле, наприклад SteamPassword, у цьому разі ASF буде автоматично використовувати логін, але буде запитувати пароль (схоже на те, що робить офіційний клієнт Steam). Якщо ви користуєтесь сімейним режимом Steam щоб розблокувати акаунт, вам потрібно ввести код у поле SteamParentalCode.

Після прийняття рішень та додаткових даних, ваша веб-сторінка буде виглядати схоже на те, що показано нижче:

Вкладка Bot 2

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

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

Структура 2

Вітаємо! Ви тільки що завершили створення дуже простої конфігурації для бота ASF. Незабаром ми її розширимо, а поки що це все що вам потрібно.

Запуск ASF

Тепер ви готові до першого запуску програми. Просто клацніть двічі по виконуваному файлу ArchiSteamFarm у каталозі ASF.

Після цього, якщо ви встановили усі передумови на першому кроці, ASF має правильно стартувати, знайти вашого першого бота (якщо ви не забули покласти його конфігурацію до каталогу config), та спробувати увійти під його обліковим записом:

ASF

Якщо ви надали ASF для використання SteamLogin та SteamPassword, то у вас запитають лише код SteamGuard (з e-mail, 2ФА чи ніякого, в залежності від ваших налаштувань Steam). Якщо ж ні - у вас також спитають логін та пароль від Steam.

Зараз саме час подивитися нашу політику конфіденційності якщо ви переймаєтесь що буде далі, як це також зауважує ASF.

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

ASF 2

Це доводить що ASF тепер успішно працює з вашим обліковим записом, тому ви можете згорнути програму і зайнятися чимось іншим. Після достатнього часу (він залежить від продуктивності), ви побачите що повільно почали випадати колекційні картки Steam. Звичайно, щоб це сталося, вам потрібно мати ігри, з яких ще мають випасти картки, на це вказує напис "Ще може випасти карток: X" на сторінці значків - якщо там немає ігор для фарму, то ASF видасть повідомлення що йому нема чого робити, як описано у нашому розділі ЧаПи.

На цьому ми завершуємо наш дуже простий посібник з налаштування. Ви можете вирішити чи бажаєте ви конфігурувати ASF далі, чи просто дозволити йому робити свою роботу з налаштуваннями за замовчуванням. Ми охопимо ще кілька простих деталей, а потім залишимо вам усю Wiki для вивчання.

Додаткова конфігурація

Фарм декількох облікових записів водночас

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

Унікальне ім'я боту, якщо у вас уже є бот з ім'ям "MainAccount", ви не зможете створити ще одного з тим же ім'ям.
Вірні облікові дані, такі як SteamLogin, SteamPassword та SteamParentalCode (якщо ви користуєтесь налаштуваннями сімейного режиму)

Інакше кажучи, перейдіть знову до конфігурації і робіть те ж саме, тільки для другого або третього облікового запису. Не забувайте використовувати унікальні імена для всіх ваших ботів.

Зміна налаштувань

Щоб змінити налаштування ви робите те ж саме - генеруєте новий файл конфігурації. Якщо ви ще не закрили наш веб генератор конфігурацій, натисніть на "Відображення додаткових налаштувань" і подивіться, що ви там можете для себе знайти. Для прикладу мі змінимо налаштування CustomGamePlayedWhileFarming, яке дозволяє встановити обрану назву для відображення протягом фарму ASF, замість відображення поточної гри.

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

Steam

Змінимо це. Ввімкніть додаткові налаштування у веб генераторі конфігурацій та знайдіть там CustomGamePlayedWhileFarming. Як тільки знайдете - введіть туди свій обраний текст, який ви бажаєте відображувати, наприклад "Idling cards":

Вкладка Bot 3

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

Коли ви це зробите і запустите ASF знову, ви помітите що ASF тепер відображує обраний вами текст у попередньому місці:

Steam 2

Це підтверджує що ви успішно відредагували ваш файл конфігурації. Так само можна змінити й глобальні параметри ASF, для цього перейдіть на вкладку "ASF", скачайте згенерований файл конфігурації ASF.json й покладіть його до вашого каталогу config.

Використання ASF-ui

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

Для того щоб скористуватися ASF-ui, ви повинні переконатися що налаштували параметри IPC та SteamOwnerID у файлі глобальної конфігурації (вкладка ASF).

У параметр SteamOwnerID вам потрібно ввести унікальний ідентифікатор вашого облікового запису Steam у 64-бітній формі. Знайти цей ідентифікатор можна різними шляхами, ми для цього скористаємось сервісом SteamRep. Відкрийте сайт за посиланням, знайдіть кнопку входу за допомогою Steam у правому верхньому куті, та увійдіть. Після цього, у тому ж самому місці, клацніть на свій аватар та знайдіть поле steamID64 у вашому профілі.

SteamRep

Для мого облікового запису це число 76561198006963719. У вас буде щось схоже, яке також починається з 7656. Скопіюйте його.

Тепер знову перейдіть до нашого веб генератора конфігурацій та введіть це число у параметр SteamOwnerID. Lastly, you need to enable IPC option for the interface to activate.

IPC

Тепер ви можете скачати ваш файл глобальної конфігурації ASF та покласти його до вашого каталогу config, як звичайно. Після цього, запустіть ASF знову, ви маєте побачити що інтерфейс IPC було запущено:

IPC 2

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

ASF-ui

Будь ласка, пам'ятайте що ASF-ui ще й досі на етапі тестування, і не усе можу бути вже доступним чи працювати, але вже зараз його достатньо для нескладного користування ASF.

Підсумок

Ви успішно налаштували використання у ASF ваших облікових записів, і навіть трошки настроїли додаткові опції. Якщо ви дотримувалися усього нашого посібника, то ви навіть спромоглися відправити просту команду за допомогою нашого інтерфейсу ASF-ui. Тепер саме час прочитати увесь наш розділ "Конфігурація", щоб дізнатися що насправді роблять усі можливі налаштування, які ви бачили у генераторі конфігурацій, і які можливості вам надає ASF. Якщо ви зіткнулися з якоюсь проблемою, чи у вас виникли питання, прочитайте розділ ЧаПи, який має відповісти на всі, або хоча б на більшість питань, які ви можете мати. Якщо ви бажаєте дізнатися геть усе про ASF, і про те як воно може зробити ваше життя легшим, ознайомтеся й з рештою нашої wiki. Приємного користування!

Універсальне налаштування

Цей варіант налаштування призначений для досвідчених користувачів, які бажають запустити ASF у універсальному (generic) варіанті. Це не рекомендується для людей, які можуть використати налаштування для конкретної ОС.

You want to use generic variant mainly in those situations (but of course you can use it regardless):

Коли ви користуєтесь ОС, для якої ми не робимо пакунок під конкретну ОС (наприклад 32-розрядна Windows)
Коли у вас вже встановлено .NET Core Runtime/SDK, або ви плануєте його встановити й користуватися ним
Коли ви бажаєте мінімізувати розмір структури ASF й слідкувати за виконанням вимог середовища виконання самостійно
When you want to use a custom plugin which requires a generic setup of ASF to run properly (due to missing native dependencies)

Однак не забувайте, що у цьому разі ви відповідаєте за середовище виконання. Це означає, що якщо ваш .NET Core SDK (runtime) недоступний, застарілий чи зламаний - ASF не буде працювати. Саме тому ми не рекомендуємо це налаштування звичайним користувачам, оскільки вам потрібно буде забезпечити що ваш .NET Core SDK (runtime) відповідає потребам ASF й може запустити ASF, на відміну від ситуації коли ми забезпечуємо що .NET Core runtime у складі ASF може це зробити.

Для універсального пакунка, ви можете дотримуватися посібника для налаштувань для конкретної ОС, з двома невеличкими змінами. На додаток до встановлення передумов .NET Core, вам також треба встановити .NET Core SDK, та замість виконуваного файлу для конкретної ОС ArchiSteamFarm(.exe), ви матимете лише двійковий файл ArchiSteamFarm.dll. Усе решта точно те ж саме.

Тож, разом з додатковими кроками, вам треба:

Встановити передумови для .NET Core.
Встановити .NET Core SDK (чи принаймні runtime), відповідний до вашої ОС. Найвірогідніше ви схочете скористуватися інсталятором. Зверніться до розділу "Вимоги середовища виконання", якщо не впевнені яку версію вам потрібно встановити.
Скачати останній випуск ASf в універсальному варіанті.
Розпакувати архів до нового місця (та зробити chmod +x ArchiSteamFarm.sh якщо ви під Linux/OS X).
Сконфігурувати ASF.
Запустити ASF або за використавши допоміжний скрипт, або виконавши команду dotnet /path/to/ArchiSteamFarm.dll вручну з вашої улюбленої консолі.

Допоміжні скрипти (такі як ArchiSteamFarm.cmd для Windows та ArchiSteamFarm.sh для Linux/OS X) розміщені поруч з двійковим файлом ArchiSteamFarm.dll - вони присутні лише в універсальному варіанті. Ви можете скористуватися ними якщо не хочете виконувати команду dotnet вручну. Вочевидь, допоміжні скрипти не працюватимуть якщо ви не встановили .NET Core SDK і не маєте шляху до виконуваного файла dotnet у вашій змінній середовища PATH. Допоміжні скрипти необов'язкові до використання, ви завжди можете виконати dotnet /path/to/ArchiSteamFarm.dll вручну.