Setting up sr CS

Podešavanje

Ako ste ovdje prvi put, dobro došli! Srećni smo da vidimo još nekog ko je zainteresovan za naš projekat, ali zapamtite da sa velikom moći dolazi velika odgovornost - ASF ima mogućnost da kontroliše mnogo stvari na Steam-u, ali samo ako pazite kako da ga naučite. Strma je linija učenja, a mi očekujemo od vas da pročitate wiki-u zbog toga, koja objašnjava u detalju kako sve radi.

Ako ste još ovdje znači da ste izdržali tekst iznad, što je lijepo. Ako ste je preskočili, onda će vam uskoro biti loše... U svakom slučaju, ASF je konsolska aplikacija, što znači da program nema GUI interfejs na koji ste možda navikli. ASF je najviše namijenjen da se koristi na serveru, pa zbog toga izgleda kao servis (daemon) a ne kao desktop aplikacija.

Ovo ipak ne znači da ga ne možete koristiti na vašem PC-u ili na nečem više komplikovanom nego obično. ASF je zaseban program koji ne zahtijeva instalaciju, i odmah radi ali zahtijeva konfiguraciju da bi vam bio od koristi. Konfiguracija kazuje ASF-u šta u stvari treba da radi nakon što ga pokrenete. Ako ga pokrenete bez konfiguracije, ASF onda neće raditi ništa, tako jednostavno.

---

OS-specifično postavljanje

Opšte kazano, ovo ćete raditi u nekoliko sledećih minuta:

• Instalirati .NET Core prerequisites.
• Preuzmite poslednje ASF izdanje u odgovarajućoj OS-specifičnoj varijanti.
• ekstraktujte arhivu u novoj lokaciji (i chmod +x ArchiSteamFarm ako ste na Linux-u/OS X-u),
• Konfigurišete ASF.
• pokrenite ASF i vidite magiju.

Zvuči jednostavno, zar ne? Pa počnimo.

---

.NET Core prerequisites

Prvo morate biti sigurni da ASF može biti pokrenut na vašem OS-u. ASF je napisan u C#, baziran na .NET Core i možda će zahtijevati dodatne nativne biblioteke koje još nisu prisutne na vašoj platformi. Razlika postoji u tome da li koristite Windows, Linux ili OS X, i zbog toga će imati različite zahtjeve, ali u svakom slučaju, svi su navedeni u .NET Core prerequisites dokumentu kojeg trebate pratiti. Ovo je naš materijal za podsjećanje koji treba biti korišćen, ali zbog jednostavnosti mi smo naveli sve pakete ispod, pa ne morate čitati čitav dokument.

Normalno je da neki (ili svi) zahtjevi već postoje na vašem sistemu zbog toga što ih je neki treći softver, koji već koristite, instalirao. Ipak, budite sigurni da stvarno imate potrebne zahtjeve na vašem OS-u - bez tih zahtjeva ASF se uopšte neće pokrenuti.

Zapamtite da, osim ovog, ne morate ništa drugo raditi na vašem OS-u, posebno ne instalirati .NET Core SDK ili runtime, jer OS paket već sadrži to sve. Potrebni su vam samo .NET Core prerequisites (zahtjevi) da bi pokrenuli .NET Core runtime koje je u ASF-u.

Windows:

• Microsoft Visual C++ 2015 Redistributable Update (x64 za 64-bit Windows, x86 za 32-bit Windows)
• Veoma je preporučljivo da budete sigurni da su sva postojeća Windows ažurirana instalirana. Morate minimalno imati KB2533623 i KB2999226, ali možda i još neko ažuriranje ako bude potrebno. Sve su već instalirane ako je Windows ažuriran do kraja. Budite sigurni da ste sve ovo uradili prije nego što instalirate Visual C++.

Linux:

Imena paketa zavise od Linux distribucije koju koristite, mi smo naveli najčešće varijacije. Možete ih instalirati sa nativnim paket menađerom na vašoj distribuciji (kao što je apt za Debian ili yum za CentOS).

• libc6 (libc)
• libgcc1 (libgcc)
• libicu (icu-libs, poslednju verziju za vašu distribuciju, npr. libicu67)
• libgssapi-krb5-2 (libkrb5-3, krb5-libs)
• libssl1.1 (libssl, openssl-libs, poslednju verziju na vašoj distribuciji, 1.1.X or 1.0.X)
• libstdc++6 (libstdc++, u verziji 5.0 ili većoj)
• zlib1g (zlib)

Većina, ako ne i sve, bi trebalo da su već instalirane na vašem sistemi. Minimalna instalacija Debian stable zahtijeva samo libicu63 od svih ovih.

OS X:

• Ništa za sada, ali trebate imati poslednju verziju OS X instaliranu, najmanje 10.13+

---

Preuzimanje

Sada kada imate sve zahtjeve ispunjene, sledeći korak je da preuzmete poslednje ASF izdanje. ASF je dostupan u raznim varijantama, ali vama je potreban paket koji je isti kao vaš operativni sistem i vaša arhitektura. Npr. ako koristite 64-bit Windows, onda izaberite ASF-win-x64 paket. Za više informacija o dostupnim varijacijama, posjetite kompatabilnost sekciju. ASF je moguće pokrenuti i na OS-ovima za koje ne pravimo OS namijenjeni paket, kao što je 32-bit Windows, za njih izaberite opšta podešavanja.

Nakon preuzimanja, ekstraktujte zip fajl u novom folderu. Mi predlažemo koršćenje 7-zip, ali svi standardni programi kao unzip na Linux/OS X-u će takođe raditi bez problema.

Ako koristite Linux/OS X, ne zaboravite da date privilegije pokretanja pomoću chmod +x ArchiSteamFarm u folderu gdje je program ekstraktovan, pošto privilegije nije moguće podesiti u zip fajlu. Ovo je potrebno samo jednom uraditi prije prvog pokretanja.

ASF je potrebno ekstraktovati u svom novom direktorijumu a ne u nekom postojećem direktorijumu koji koristite za nešto drugo - ASF će izbrisati sve fajlove koje ne prepoznaje ili mu nisu više potrebni nakon ažuriranja, što može dovesti do brisanja vaših fajlova ako ih smjestite u istom ASF folderu. Ako imate neki script ili fajl koji želite da koristite sa ASF-om, stavite ih u folder iznad.

Primjer ove strukture treba da izgleda ovako:

C:\ASF (gdje stavljate vaše stvari)
    ├── ASF shortcut.lnk (opcionalno)
    ├── Config shortcut.lnk (opcionalno)
    ├── Commands.txt (opcionalno)
    ├── MyExtraScript.bat (opcionalno)
    ├── (...) (bilo koji fajl koji vi izaberete, opcionalno)
    └── Core (samo za ASF, ovdje ekstrakujete arhivu)
         ├── ArchiSteamFarm(.exe)
         ├── config
         ├── logs
         ├── plugins
         └── (...)

---

Konfiguracija

Sada smo na poslednjem koraku, konfiguraciji. Ovo je do sad najkomplikovaniji korak, pošto sadrži dosta novih informacija koje možda još ne poznajete, pa ćemo dati nekoliko lako-razumljivih primjera i jednostavnih objašnjenja ovdje.

Prvo i najvažnije, postoji stranica konfiguracija koja objašnjava sve što je povezano sa konfiguracijom, ali sadrži veliku količinu informacija, od kojih je većinu ne morate odmah znati. Umjesto toga, naučićemo vas kako da nađete informacije koje su vam potrebne.

ASF konfiguracija može biti napravljena pomoću dva načina - koristeći web generator konfiguracije ili ručno. Ovo je duboko objašnjena sekcija konfiguracije, pa se njom pozabavite ako želite detaljne informacije. Mi ćemo koristiti web generator konfiguracije, pošto je to mnogo lakši način.

Pođite na našu stranicu web generator konfiguracije pomoću vašeg pretraživača. Ovdje morate imati JavaScript omogućen ako ste ga ručno onemogućili. Mi predlažemo Chrome ili Firefox, ali će vjerovatno raditi na svim poznatim pretraživačima.

Nakon otvaranja ove stranice, pođite na "Bot" tab. Kada ste tu, trebalo bi da vidite stranicu sličnu ovoj ispod:

Ako je nikim slučajem vaša verzija ASF-a, koju ste preuzeli, starija od one kojom je web generator konfiguracije podešen, jednostavno izaberite vašu verziju ASF menia. Ovo se može desiti pošto generator konfiguracije može praviti konfiguracije za novije (pre-objavljene) ASF verzije koje još nisu stabilne za normalno izdanje. Vi ste preuzeli poslednju stabilnu verziju ASF-a koja je potvrđena da radi kako treba.

Počnite tako što ćete dati ime botu u predjelu označenom crvenom bojom. Ovo može biti bilo šta, kao što je nadimak, ime naloga, broj, ili bilo šta drugo. Postoji samo jedna riječ koju ne možete koristiti, a to je ASF, pošto je ova riječ rezervisana za fajl globalne konfiguracije. Pored toga imena botova ne mogu početi sa tačkom (ASF namjerno ignoriše ovakve fajlove). Mi takođe predlažemo da ne odvajate između riječi, umjesto odvajanja koristite _.

Kada ste odlučili koje ime ćete dati botu, stisnite Omogućeno, ovo kazuje ASF-u da li će vaš bot biti pokrenut ili ne nakon pokrenanja programa.

Sada možete odlučuti oko dvije stvari:

• Možete upisati vaše kredencijale za prijavu u SteamLogin polju i vašu lozinku u SteamPassword polju
• Ili ih možete ostaviti prazne

Ako unesete kredencijale to će omogućiti ASF-u da automatski koristi iste tokom pokretanju, i vi nećete morati da ih unosite svaki put kada želite da koristite ASF. Možete ih takođe izostaviti, a u tom slučaju oni neće biti sačuvani, i ASF će tražiti da ih unesete tokom svakog pokretanja.

ASF-u su potrebni kredencijali za prijavu zato što on posjeduje svoju inplementaciju Steam klienta i zato su mu potrebni iste stvari da bi se prijavio kao što vam i Steam klient traži kada se prijavljujete. Vaši kredencijali za prijavu su sačuvani samo na vašem PC-u u ASF config direktorijumu, naš web generator konfiguracije je klient-baziran što znači da je kod pokrenut lokalno u vašem pretraživaču, a detalji koje unesete ne šalju se nigdje van vašeg PC-a, pa se ne morate brinuti o curenju podataka negdje drugo. Ipak, ako zbog nekog razloga ne želite da unesete vaše podatke ovdje, mi to razumijemo, pa to možete uraditi u ručno napravljenim fajlovima, ili ih skroz maći pa ih svaki put unositi u ASF komandnoj liniji. Više o pitanjima sigurnosti možete pronaći u sekciji konfiguracija.

Takođe možete odlučiti da ostavite samo jedno polje prazno, kao što je SteamPassword, ASF će u tom slučaju automatski koristiti ime vašeg naloga, ali će tražiti vašu lozinku (slično kao što to radi Steam klient). Ako koristite roditeljska podešavanja na Steam-u da bi otključali vaš nalog, morate onda popuniti i polje SteamParentalCode.

Nakon vaših odluka i opcionih detalja, vaša web stranica bi trebala da izgleda slično ovoj ispod:

Sada možete pritisnuti "download" dugme i naš web generator konfiguracije će napraviti novi json fajl baziran na imenu vašeg bota. Sačuvajte taj fajl u config direktorijumu koji je lociran u folderu gdje ste ekstrakovali vaš zip fajl u prethodnom koraku.

Vaš config direktorijum bi trebao da izgleda slično ovom:

Čestitamo! Završili sve veoma jednostavnu konfiguraciju ASF bota. Ovo ćemo brzo dalje proširiti, ali za sad je to sve što vam je potrebno.

---

Pokretanje ASF-a

Sada ste spremni da pokrenete program prvi put. Jednostavno dvokliknite ArchiSteamFarm fajl u ASF direktorijumu.

Nakon toga, ako ste instalirali sve potrebno u prvom koraku, ASF bi trebao da se uspješno pokrene, zapamtite da će vaš prvi bot (ako niste zaboravili da stavite napravljenu konfiguraciju u config direktorijumu), pokušati da se prijavi:

Ako ste ispunili SteamLogin i SteamPassword polje koje ASF koristi, tražiće vam se SteamGuard token (e-mail, 2FA ili ništa, u zavisnosti od vaših Steam podešavanja). Ako niste dali Steam kredencijale, onda će vam se ovdje tražiti isti.

Ovo je dovro vrijeme da pregledate našu sekciju politiku privatnosti ako ste zabrinuti oko šta se sada dešava sa njima, kao što je kazano od ASF-a.

Nakon što je pošao proces prijave, ako su vaši kredencijali tačni, bićete uspješno prijavljeni, i ASF će početi da idluje koristeći opšta podešavanja ako ih niste promijenili:

Ovo pokazuje da ASF uspješno radi svoj posao na vašem nalogu, pa ga možete umanjiti i raditi nešto drugo. Nakon određenog vremena (u zavisnosti od performansi), polako ćete dobijati Steam kartice. Naravno, da bi se to desilo morate imati validne igrice za idlovanje, koje kažu "možete dobiti još X kartica igrajući ovu igricu" na vašoj bedž stranici - ako nema igrica za idlovanje, onda ASF neće ništa raditi kao što je kazano u našem FAQ.

Ovo je kraj našeg jednostavnog uputstva za podešavanje. Možete odlučiti da li želite da dalje konfigurišete ASF, ili da ga ostavite da radi pomoću opštih podešavanja. Proći ćemo kroz još nekoliko osnovnih stavki, a onda ćemo vam preputsiti da otkrijete ostatak wiki-e.

---

Šira konfiguracija

Idlovanje nekoliko naloga odjednom

ASF ima mogućnost da idluje više od jednog naloga odjednom, što je njegova primarna funkcija. Možete dodati više od jednog naloga u ASF pomoću generisanja više od jedne bot konfiguracije, na isti način na koji ste generisali prvu konfiguraciju prije nekoliko minuta. Morate biti sigururni o ove dvije stvari:

• Različita imena botova, ako je već ime prvog bota "GlavniNalog", ne možete napraviti drugog bota sa istim imenom.
• Pravilni detalji vašeg naloga, SteamLogin,<0 SteamPassword i SteamParentalCode (ako koristite Steam roditeljska podešavanja).

Drugim riječima, jednostavno ponovo idite na konfiguraciju i uradite istu stvar, za vaš drugi ili treći nalog. Zapamtite da morate koristiti različita imena za svakog bota.

---

Mijenjanje podešavanja

Možete promijeniti postojeća podešavanja na isti način - konfigurišući novi config fajl. Ako još niste zatvorili web generator konfiguracije, pritisnite "prikaži napredna podešavanja" da bi ste vidjeli šta je tu za vas da otkrijete. U ovod vodiču ćemo promijeniti podešavanje CustomGamePlayedWhileFarming, što omogućava da podesite ime koje će biti prikazano kada ASF idluje, umjesto prikazivanja stvarnog imena igrice.

Pa uradimo to, ako pokrenete ASF i počnete idlovati, na vašem Steam nalogu ćete vidjeti da ste u igrici i ime igrice će biti prikazano ovako:

Promijenimo to. Prikažite napredna podešavanja u vašem web generatoru konfiguracije i pronađite polje CustomGamePlayedWhileFarming. Kada to uradite, unesite tekst koji želite da bude prikazan, kao što je "Idlujem kartice":

Sada preuzmite novi konfiguracioni fajl na isti način, pa ga zamijenite sa vašim starim. Možete takođe izbrisati stari konfiguracioni fajl i dodati novi na njegovom mjesu.

Nakon što to uradite, pokrenite ASF ponovo, vidjećete da ASF sada prikazuje vaš uneseni tekst na prethodnom mjestu:

Ovo potvrđuje da ste uspješno uredili vašu konfiguraciju. Na isti način možete promijeniti globalna ASF podešavanja, pređite sa bot taba na "ASF" tab, konfigurišite i preuzmite napravljenu ASF.json konfiguraciju i sačuvajte je u config direktorijumu.

---

Korišćenje ASF-ui

ASF je aplikacija u konsoli i ne sadrži grafički korisnički interfejs. Ipak, mi aktivno radimo na ASF-ui interfejsu za naš IPC, koji je veoma lak za korišćenje i pristup raznim ASF mogućnostima.

Da bi koristili ASF-ui, morate omogućiti IPC i podesiti SteamOwnerID u globalnoj konfiguraciju (ASF tabu).

Za SteamOwnerId, morate unijeti vaš unikatni Steam identifikator u 64-bit-noj formi za vaš nalog. Možete ga pronaći na razne načine, mi ćemo koristiti SteamRep za ovaj način. Otvorite sajt, locirajte "sign in throgh Steam" dugme u gornjem desnom uglu, pa se prijavite. Nakon toga, na istom mjestu, pritisnite na vaš avatar, i pronađite polje steamID64 na vašem profilu.

Za moj nalog, to je broj 76561198006963719. Vi ćete imati sličan broj, koji takođe počine sa 7656. Kopirajte ga.

Sada se vratite na tab web generatora konfiguracije i unesite broj u SteamOwnerID.

Morate uraditi još jednu stvar, pokrenite napredna podešavanja, pronađite IPC opciju, i omogućite je.

Sada možete preuzeti vašu ASF konfiguraciju i sačuvati je u config direktorijumu, kao i obično. Nakon toga, pokrenite ASF ponovo, i tu bi trebalo da potvrdite da je IPC interfejs pokrenut pravilno:

Ako ste sve pravilno uradili, onda ćete imati pristup ASF-ovom IPC interfejsu na ovom linku, sve dok je ASF pokrenut. Možete koristiti ASF-ui za razne svrhe, npr. slanje komandi. Slobodno razgledajte okolo da bi pronašli razne ASF-ui funkcije.

Zapamtite da ASF-ui trenutno u preglednom stanju i da još sve nije dostupno/ili još ne radi, ali je više nego dovoljno za jednostavno korišćenje ASF-a.

---

Zaključak

Uspješno ste podesili ASF da koristi vaš Steam nalog i uspješno ste ga uredili onako kako vam odgovara. Ako ste pratili naš cijeli vodič, onda ste uspjeli da pošaljete i jednostavne komande pomoću našeg ASF-ui interfejsa. Sada je dobro vrijeme da pročitate cijelu sekciju konfiguracija da bi naučili razna podešavanja koja sve vidjeli u naprednom tabu, i sve ostalo što ASF ima u ponudi. Ako ste zapeli na nekom problemu ili imate neko opšte pitanje, pročitajte FAQ koji bi trebao skoro sve da pokrije, ili većinu pitanja koja možete imati. Ako želite da naučite sve što postoji u ASF-u i kako vam to može pomoći, posjetite ostatak naše wiki-e. Uživajte!

---

Opšta podešavanja

Ova podešavanja su za napredne korisnike koji žele da podese ASF za pokretanje na opštoj varijanti. Ovo nije preporučeno za ljude koji mogu da koriste OS-specifično podešavanje.

Vi možete da koristite opštu varijantu u tri situacije (ali ga možete koristiti i kako vi hoćete):

• Kada koristite OS za koji nema OS-specifičan paket (kao što je 32-bitni Windows)
• Kada već imate .NET Core Runtime/SDK, ili želite da ga instalirate i koristite
• Kada želite da smanjite veličinu ASF strukture tako što ćete podesite runtime zahtjeve ručno

Ipak, zapamtite da ćete u tom slučaju vi biti odgovorni za .NET Core runtime. Ovo znači da ako je .NET Core SDK (runtime) nedostupan, zastareo ili pokvaren, ASF neće raditi. Zbog ovog ne preporučujemo ovaj metod za obične korisnike, pošto morate biti sigurni da se vaš .NET Core SDK (runtime) poklapa sa ASF zahtjevima i da može da pokrene ASF, dok u normalnoj verziji mi provjeravamo da li .NET Core runtime koji je upakovan u ASF može da ga pokrene.

Za opšti paket, možete pratiti cijeli OS-specifični vodič iznad, sa dvije male promjene. U dodatku sa instaliranjem .NET Core prerequisites, isto trebate da instalirate .NET Core SDK, i umjesto što imate OS-specifični ArchiSteamFarm(.exe) eksekjucioni fajl, sada ćete imati opšti ArchiSteamFarm.dll binarni fajl. Sve ostalo je isto.

Sa dodatnim koracima:

• Instalirajte .NET Core prerequisites.
• Instalirajte .NET Core SDK (ili bar runtime) za vaš OS. Vjerovatno ćete željeti da koristite automatsku instalaciju. Pogledajte runtime zahtjeve ako niste sigurni koju verziju da instalirate.
• Preuzmite poslednje ASF izdanje za opštu varijantu.
• Ekstraktujte arhivu u novoj lokaciji (i chmod +x ArchiSteamFarm.sh ako ste na Linux-u/OS X-u),.
• Konfigurišete ASF.
• Pokrenite ASF koristeći pomoćni skript ili ručnom ekekjucijom dotnet /ruta/do/ArchiSteamFarm.dll iz vaše omiljene ljuske.

Pomoćni skript (kao što je ArchiSteamFarm.cmd za Windows i ArchiSteamFarm.sh za Linux/OS X) se nalaze pored ArchiSteamFarm.dll binarnog fajla - koji su sadržani samo u opštem izdanju. Njih možete koristiti ako ne želite da ručno ekekjutujete dotnet komande. Pomoćni skriptovi naravno neće raditi ako niste instalirali .NET Core SDK i ako nemate dotnet dostupan u vašem PATH-u. Pomoćni skriptovi su skroz opcionalni, uvijek možete ručno koristiti dotnet /ruta/do/ArchiSteamFarm.dll.