Setting up de DE

Installation

Wenn Du hier zum ersten Mal angekommen bist, herzlich willkommen! Wir freuen uns sehr, einen weiteren Reisenden zu sehen, der sich für unser Projekt interessiert, obwohl wir berücksichtigen müssen, dass mit großer Macht eine große Verantwortung einhergeht – ASF ist in der Lage, viele verschiedene Dinge rund um Steam zu tun, aber nur, solange man sich genug kümmert, um zu lernen, wie man ihn benutzt. Es gibt hier eine steile Lernkurve, und wir erwarten von dir, dass Du das Wiki in dieser Hinsicht liest, das im Detail erklärt, wie alles funktioniert.

Wenn Du immer noch hier bist, heißt das, dass Du den Text oben überstanden hast, was toll ist. Außer Du hast ihn übersprungen, was heißt, dass Du bald schlechte Zeiten vor Ihren hast... Wie auch immer. ASF ist eine Konsolenanwendung, was bedeutet, dass das Programm standardmäßig selber keine Benutzeroberfläche hat, wie Du es eventuell gewohnt bist. ASF sollte hauptsächlich auf Servern laufen, sodass es als Dienst (Daemon) und nicht als Desktop-App fungiert.

Das bedeutet jedoch nicht, dass Du es nicht auf Ihrem PC benutzen kannst oder dass die Benutzung etwas komplizierter ist als sonst, nichts dergleichen. ASF ist ein eigenständiges Programm, das keine Installation benötigt und sofort einsatzbereit ist. Allerdings wird eine Konfiguration erfordert, bevor es nützlich wird. Die Konfiguration sagt ASF, was es nach dem Start tatsächlich tun soll. Wenn Du ASF ohne Konfiguration startest, dann wird es nichts tun. Ganz einfach.

---

Betriebssystemspezifisches Einrichtung

Folgendes werden wir in den nächsten paar Minuten machen:

• .NET Abhängigkeiten installieren.
• Die neueste ASF-Version in der entsprechenden betriebssystemspezifischen Variante herunterladen.
• Das Archiv an einen neuen Ort entpacken.
• ASF konfigurieren.
• ASF starten und der Magie Ihren Lauf lassen.

Hört sich einfach an, richtig? Dann lassen Sie uns beginnen.

---

.NET Abhängigkeiten

Der erste Schritt ist sicherzustellen, dass dein Betriebssystem ASF überhaupt richtig ausführen kann. ASF ist in C# basierend auf der .NET Plattform programmiert und benötigt eventuell native Bibliotheken, die auf deinem System bislang nicht verfügbar sind. Abhängig davon, ob Sie Windows, Linux oder macOS verwenden, haben Sie unterschiedliche Anforderungen, wenngleich alle in aufgelistet sind. ET Voraussetzungen Dokument, dem Sie folgen sollten. Dieses ist Referenzmaterial, das verwendet werden sollte, allerdings haben wir im Sinne der Einfachheit auch alle benötigten Pakete unten aufgelistet, damit Du nicht das gesamte Dokument lesen musst.

Es ist völlig normal, dass manche (oder sogar alle) Abhängigkeiten bereits in Ihrem System existieren, weil sie mit der Software Dritter, welche Du verwendest, mitinstalliert wurden. Trotzdem solltest Du sicherstellen, dass dies wirklich der Fall ist indem Du das entsprechende Installationsprogramm für dein Betriebssytem ausführst – Ohne diese Abhängigkeiten wird ASF nicht einmal starten.

Denken Sie daran, dass Sie für betriebssystemspezifische ASF-Versionen nichts Weiteres machen müssen. Insbesondere betrifft dies die Installation des .NET SDK oder der Runtime, da die betriebssystemspezifische Versionen das alles bereits beinhalten. Sie benötigen nur die .NET Core Prerequisites (Abhängigkeiten), um die .NET Runtime, die bereits in ASF enthalten sind, auszuführen.

Windows:

• Microsoft Visual C++ Redistributable Update (x64 für 64-Bit Windows, x86 für 32-Bit Windows)
• Es wird dringend empfohlen sicherzustellen, dass alle Windows-Updates bereits installiert sind. Du brauchst mindestens KB2533623 und KB2999226, aber evtl. benötigst du mehr Updates. Wenn dein Windows aktuell ist, sind diese bereits alle installiert. Versichere dich, dass Du diese Voraussetzungen erfüllst, bevor Du das Visual C++ Paket installierst.

Linux:

Paketnamen hängen von der Linux-Distribution, die Du verwendest, ab. Wir listen nur die Gebräuchlichsten auf. Sie können alle über den nativen Paketmanager für dein Betriebssystem (wie zum Beispiel apt unter Debian oder yum unter CentOS) installieren.

• ca-certificates (Standard SSL Zertifikate für HTTPS Verbindungen)
• libc6 (libc)
• libgcc-s1 (libgcc1, libgcc)
• libicu (icu-libs, neueste Version für ihre Distribution – z. B. libicu72)
• libgssapi-krb5-2 (libkrb5-3, krb5-libs)
• libssl1.1 (libssl, openssl-libs, neueste Version für Ihre Distribution, mindestens 1.1.X)
• libstdc++6 (libstdc++, Version 5.0 oder höher)
• zlib1g (zlib)

Zumindest ein Großteil davon sollte bereits nativ auf Ihrem System verfügbar sein. Die minimale Installation von Debian stable erforderte nur libicu72.

macOS:

• Keine Version von macOS, aber Sie sollten die neueste Version von macOS installiert haben; mindestens 10.15+

---

Herunterladen

Da wir nun alle benötigten Abhängigkeiten installiert haben, ist der nächste Schritt das Herunterladen der neuesten ASF-Version. ASF ist in mehreren Varianten verfügbar, aber Du bist nur am Paket interessiert, das Ihrem Betriebssystem und der Architektur Ihres PCs entspricht. Zum Beispiel, wenn Du 64-Bit Windows verwendest, dann willst Du die ASF-win-x64-Variante. Für mehr Information über die verfügbaren Varianten, besuche bitte den Abschnitt Kompatibilität. ASF kann auch unter Betriebssystemen ausgeführt werden, für die wir kein betriebssystemspezifisches Paket zur Verfügung stellen. Ein Beispiel hierfür ist 32-bit Windows. Dafür gehe bitte zur generischen Installation.

Beginne nach dem Download damit, die Zip-Datei in einen eigenen Ordner zu entpacken. Wenn Sie dafür ein spezielles Programm benötigen, wird 7-zip dies tun aber alle Standardwerkzeuge wie entpacken von Linux/macOS sollten ebenfalls problemlos funktionieren.

Stelle bitte sicher, dass Du ASF in einen eigenen Ordner entpackst und nicht in einen bereits existenten, der für etwas anderes verwendet wird – ASFs automatische Aktualisierungen werden alle alten Dateien in diesem Ordner löschen, was möglicherweise dazu führen könnte, dass Du Dateien verlierst, die nichts mit ASF zu tun haben aber im selben Ordner sind. Solltest Du zusätzliche Skripte oder Dateien haben, die Du mit ASF verwenden willst, solltest Du sie in den Ordner darüber tun.

Eine Beispiel-Struktur würde wie folgt aussehen:

C:\ASF (wo Sie Ihre eigenen Dateien speichern)
  ├── ASF shortcut.lnk (optional)
  ├── Config shortcut.lnk (optional)
  ├── Commands.txt (optional)
  ├── MyExtraScript.bat (optional)
  ├── (...) (alle anderen Dateien Ihrer Wahl, optional)
  └── Core (nur ASF gewidmet, wo Sie das Archiv extrahieren)
     ├── ArchiSteamFarm(.exe)
     ├── config
     ├── logs
     ├── plugins
     └── (...)

---

Konfiguration

Wir sind nun bereit, den allerletzten Schritt, die Konfiguration, durchzuführen. Dies ist bei weitem der komplizierteste Schritt, da es sich um eine Menge neuer Informationen handelt, die Du noch nicht kennst, also werden wir versuchen, hier einige leicht verständliche Beispiele und vereinfachte Erklärungen zu geben.

In erster Linie gibt es die Seite Installation, die alles erklärt, was sich auf die Konfiguration bezieht, aber es ist eine riesige Menge an neuen Informationen, von denen wir im Moment nicht alle benötigen werden. Stattdessen zeigen wir dir, wie Du die Informationen bekommst, die Du tatsächlich suchst.

Die Konfiguration von ASF kann auf mindestens drei Arten erfolgen – durch unseren Web-Konfigurationseditor, über das ASF-UI oder manuell. Dies wird ausführlich auf der Seite Installation erläutert, also beziehe dich darauf, wenn Du detailliertere Informationen benötigst. Wir werden den Web-Konfigurationseditor als Ausgangspunkt verwenden.

Besuche unsere Web-Konfigurationsgenerator Seite mit deinem Lieblingsbrowser (Du musst JavaScript aktiviert haben, falls Du es manuell deaktiviert hast). Wir empfehlen Chrome oder Firefox, aber es sollte mit allen gängigen Browsern funktionieren.

Nach dem Öffnen der Seite klicke auf „Bot“. Du solltest nun eine ähnliche Seite wie die unten sehen:

Wenn die Version von ASF, die Du gerade heruntergeladen hast, älter ist als der Konfigurationsgenerator, der standardmäßig verwendet wird, wähle einfach deine ASF-Version aus dem Dropdown-Menü. Dies kann passieren, da der Konfigurationsgenerator zum Erzeugen von Konfigurationen für neuere (Vorabversionen) ASF-Versionen verwendet werden kann, die bislang nicht als stabil markiert wurden. Du hast die neueste stabile Version von ASF heruntergeladen, die auf Ihre zuverlässige Funktion überprüft wurde.

Beginne damit, den Namen deines Bot in das rot markierte Feld zu schreiben. Dies kann jeder beliebige Name sein, den Du verwenden möchtest, z. B. dein Spitzname, Kontoname, eine Nummer oder etwas anderes. Es gibt nur ein Wort, das Du nicht verwenden kannst, nämlich ASF, da dieses Schlüsselwort für die globale Konfigurationsdatei reserviert ist. Außerdem kann dein Bot-Name nicht mit einem Punkt beginnen (ASF ignoriert diese Dateien absichtlich). Wir empfehlen dir auch keine Leerzeichen zu verwenden. Du solltest bei Bedarf _ als Trennzeichen verwenden.

Nachdem Du dich für einen Namen entschieden hast, aktiviere den Enabled Schalter. Hiermit wird festgelegt, ob dein Bot von ASF automatisch nach dem Start (des Programms) gestartet werden soll.

Jetzt kannst Du dich für zwei Dinge entscheiden:

• Sie können Ihren Benutzernamen in das Feld SteamLogin und Ihr Passwort in das SteamPassword Feld eintragen
• Oder Du kannst sie leer lassen

Wenn Du das erste tust, kann ASF deine Konto-Anmeldeinformationen während des Startvorgangs automatisch verwenden, sodass Du sie nicht jedes Mal manuell eingeben musst, wenn ASF sie benötigt. Du kannst sie jedoch auch weglassen. In diesem Fall werden sie nicht gespeichert, sodass ASF nicht ohne deine Hilfe automatisch starten kann und Du sie während der Laufzeit eingeben musst.

ASF benötigt deine Anmeldeinformationen, da es seine eigene Implementierung des Steam-Clients beinhaltet und die gleichen Details benötigt, die Du selbst benutzt um dich anzumelden. Deine Anmeldeinformationen werden nirgends außer auf deinem PC im config ASF-Verzeichnis gespeichert. Unser Web-Konfigurationsgenerator ist client-basiert, was bedeutet, dass der Programmcode lokal in deinem Browser ausgeführt wird, um gültige ASF-Konfigurationen zu generieren, ohne dass Du Details eingibst, die deinen PC überhaupt erst verlassen, sodass Du dir keine Sorgen über einen möglichen Verlust vertraulicher Daten machen musst. Dennoch, wenn Du aus irgendeinem Grund deine Zugangsdaten dort nicht eingeben möchtest, verstehen wir das, und Du kannst sie später manuell in generierte Dateien einfügen, oder sie ganz weglassen und sie nur in die ASF-Befehlszeile eingeben. Mehr zu Sicherheitsfragen findest Du im Abschnitt Konfiguration.

Du kannst auch nur ein Feld leer lassen, z. B. SteamPassword. ASF kann dann dein Login automatisch verwenden, fragt aber trotzdem nach dem Passwort (ähnlich wie beim Steam Client). Wenn Du die Steam-Familienansicht benutzt um das Konto freizuschalten musst Du es in das Feld SteamParentalCode eingeben.

Nach der Entscheidung und den optionalen Details wird deine Webseite nun ähnlich wie die untenstehende aussehen:

Du kannst jetzt auf den „Download“-Button klicken und unser Web-Konfigurationsgenerator erzeugt eine neue json Datei basierend auf deinem gewählten Namen. Speichern Sie diese Datei im config Verzeichnis, welches sich in dem Ordner befindet, in dem Sie unsere Zip-Datei aus dem vorherigen Schritt extrahiert haben.

Dein config Verzeichnis sieht nun wie folgt aus:

Glückwunsch! Du hast gerade die sehr einfache ASF-Bot-Konfiguration abgeschlossen. Wir werden dies in Kürze erweitern, denn jetzt ist dies alles, was Du brauchst.

---

Ausführen von ASF

Du bist nun bereit, das Programm zum ersten Mal zu starten. Führe einfach einen Doppelklick auf die ArchiSteamFarm Binärdatei im ASF-Verzeichnis aus. Alternativ kannst Du diese auch von der Konsole aus starten.

Nach diesem Schritt, vorausgesetzt, Du hast alle erforderlichen Abhängigkeiten im ersten Schritt installiert, sollte ASF richtig starten, deinen ersten Bot bemerken (wenn Du nicht vergessen hast, die generierte Konfiguration in das Verzeichnis config zu legen) und versuchen, dich anzumelden:

Wenn Du SteamLogin und SteamPassword für ASF angegeben hast, wirst Du nur nach deinem SteamGuard-Code gefragt (E-Mail, 2FA oder keine, abhängig von deinen Steam-Einstellungen). Wenn Du es nicht getan hast, wirst Du auch nach deinem Steam-Login und Passwort gefragt.

Jetzt wäre ein guter Zeitpunkt, um unseren Abschnitt Telekommunikation Sektion zu überprüfen, wenn Sie sich Sorgen darüber machen, dass ASF programmiert ist, inklusive Aktionen, die es in Ihrem Namen erledigen wird, wie in unserer Steam-Gruppe.

Nachdem du das anfängliche Anmeldeportal passiert hast, (davon ausgegangen, dass Ihre Daten korrekt sind) wirst du erfolgreich angemeldet und ASF beginnt mit den Standardeinstellungen, die du bisher nicht geändert hast, zu sammeln:

Dies beweist, dass ASF nun erfolgreich seine Arbeit auf deinem Konto erledigt, sodass Du nun das Programm minimieren und etwas anderes tun kannst. Nach einiger Zeit (je nach Performance) wirst Du sehen, wie Steam-Karten langsam gesammelt werden. Natürlich müssen Sie dafür zulässige Spiele zum Sammeln besitzen, die auf Ihrer**Abzeichen-Seite** Folgendes zeigen: „Sie können noch X weitere Kartendrops vom Spielen dieses Spiels bekommen“. Wenn es keine Spiele zum Sammeln gibt, dann wird ASF feststellen, dass es nichts zu tun gibt, wie in unserem FAQ beschrieben.

Dies schließt unseren sehr einfachen Einrichtungsleitfaden ab. Du kannst nun entscheiden, ob Du ASF weiter konfigurieren möchtest oder ob Du es in den Standardeinstellungen seine Arbeit tun lassen möchtest. Wir werden noch ein paar grundlegende Details besprechen und dir dann das gesamte Wiki zur Verfügung stellen.

---

Erweiterte Konfiguration

Auf mehreren Konten gleichzeitig sammeln

ASF ermöglicht das Sammeln von Karten auf mehreren Konten zeitgleich, was seine Hauptfunktion ist. Du kannst weitere Konten zu ASF hinzufügen, indem Du mehr Bot-Konfigurationsdateien erzeugst, genau so, wie Du deine erste vor wenigen Minuten generiert hast. Du musst nur zwei Dinge sicherstellen:

• Eindeutiger Bot-Name, wenn Du bereits Ihren ersten Bot „Hauptkonto“ genannt hast, kannst Du keinen weiteren so nennen.
• Gültige Anmeldedaten, z. B. SteamLogin, SteamPassword und SteamParentalCode (bei Verwendung der Steam Parental Einstellungen)

Mit anderen Worten, gehe einfach erneut zur Konfiguration und mache genau das Gleiche, nur für dein zweites oder drittes Konto. Vergiss nicht für alle deine Bots eindeutige Namen zu verwenden.

---

Einstellungen ändern

Du kannst bestehende Einstellungen auf die gleiche Weise ändern, indem Du eine neue Konfigurationsdatei erzeugst. Wenn Du unseren Web-Konfigurationsgenerator bislang nicht geschlossen hast, klicke auf „Zu den erweiterten Einstellungen umschalten“ und sieh dir an, was Du entdecken kannst. Für diese Anleitung werden wir die Einstellung CustomGamePlayedWhileFarming ändern, mit der du einstellen kannst, dass der benutzerdefinierte Name angezeigt wird, wenn ASF am Sammeln ist, anstatt das aktuelle Spiel anzuzeigen.

Also lass uns das tun, wenn du ASF ausführst und das Sammeln beginnst, wirst du in den Standardeinstellungen sehen, dass dein Steam-Konto jetzt im Spiel ist:

Lass uns das jetzt ändern. Aktiviere die erweiterten Einstellungen im Webkonfigurationsgenerator und suche CustomGamePlayedWhileFarming. Sobald Du das getan hast, füge dort deinen eigenen benutzerdefinierten Text ein, den Du anzeigen möchtest, wie zum Beispiel „Idling cards":

Nun kannst Du die neue Konfigurationsdatei auf genau die gleiche Weise herunterladen, dann überschreibe deine alte Konfigurationsdatei mit der neuen. Du kannst natürlich auch deine alte Konfigurationsdatei löschen und an Ihre Stelle die neue einfügen.

Sobald Du das getan hast und ASF erneut startest, wirst Du feststellen, dass ASF nun deinen benutzerdefinierten Text an der vorherigen Stelle anzeigt:

Dies bestätigt, dass Sie Ihre Konfiguration erfolgreich bearbeitet haben. Auf genau die gleiche Weise können Sie globale ASF-Eigenschaften ändern, indem Sie vom Bot-Tab zum »ASF«-Tab wechseln, die generierte ASF.json Konfigurationsdatei herunterladen und sie in das config Verzeichnis legen.

Das Bearbeiten Ihrer ASF-Konfigurationen kann durch die Verwendung unserer ASF-ui Frontend, die weiter unten erläutert wird, viel einfacher gemacht werden.

---

Verwendung von ASF-UI

ASF ist eine Konsolenanwendung und beinhaltet keine grafische Benutzeroberfläche. Wir arbeiten jedoch aktiv an unserem IPC-Schnittstellen Frontend ASF-UI, was eine sehr gute und benutzerfreundliche Möglichkeit sein kann, auf verschiedene ASF-Funktionen zuzugreifen.

Um ASF-ui verwenden zu können, muss IPC aktiviert sein, was die Standardoption ist. Sobald Sie ASF gestartet haben, sollten Sie in der Lage sein zu bestätigen, dass die IPC-Schnittstelle automatisch gestartet wurde:

Sie können auf die IPC-Schnittstelle von ASF unter diesen Link zugreifen, solange ASF ausgeführt wird. Sie können ASF-ui für verschiedene Zwecke verwenden, z. B. das Bearbeiten der Konfigurationsdateien vor Ort oder das Senden von Befehlen. Wirf einfach einen Blick darauf, um alle Funktionalitäten von ASF-UI kennenzulernen.

---

Zusammenfassung

Du hast ASF bereits erfolgreich so eingestellt, dass es deine Steam-Konten nutzt, und Du hast es bereits ein wenig nach deinen Wünschen angepasst. Wenn Sie unserer gesamten Anleitung gefolgt sind, dann ist es Ihnen auch gelungen, ASF über unsere ASF-ui Schnittstelle zu optimieren und herauszufinden, dass ASF tatsächlich eine Art GUI hat. Jetzt ist ein guter Zeitpunkt, unseren gesamten Abschnitt Konfiguration zu lesen, um zu erfahren, was all die verschiedenen Einstellungen, die Sie auf der Registerkarte »Erweitert« sahen, tatsächlich bewirken kann und was ASF bietet. Falls Sie über ein Problem stolpern oder eine allgemeine Frage haben, lesen Sie stattdessen das FAQ, wo zumindest die meisten Ihrer möglichen Fragen erklärt werden. Wenn Du alles über ASF erfahren möchtest und wie es dein Leben einfacher machen kann, dann schaue dir den Rest von unserem Wiki an. Wenn Sie herausgefunden haben, dass unser Programm für Sie nützlich ist und Sie sich großzügig fühlen, können Sie auch in Erwägung ziehen, an unser Projekt zu spenden. Viel Spaß!

---

Generisches Setup

Dieses Setup richtet sich an fortgeschrittene Benutzer, die ASF so einrichten möchten, dass es in der Variante generic ausgeführt wird. Während die Verwendung schwieriger ist als OS-spezifische Varianten, bieten diese hier auch zusätzliche Vorteile.

Sie wollen die generic Variante hauptsächlich in drei Situationen verwenden (kann aber natürlich trotzdem anderweitig verwendet werden):

• Wenn Du ein Betriebssystem verwendest, für das wir kein betriebssystemspezifisches Paket erstellen (z. B. 32-Bit Windows)
• Wenn Sie bereits .NET Runtime/SDK haben, oder eines installieren und verwenden möchten
• Wenn Sie die ASF-Strukturgröße und den Speicherbedarf selbst minimieren möchten, indem Sie die Laufzeitanforderungen selbst handhaben
• Wenn Sie ein benutzerdefiniertes Plugin verwenden möchten, das eine generic Installation von ASF (aufgrund fehlender nativer Abhängigkeiten) benötigt

Bedenken Sie jedoch, dass Sie in diesem Fall für die .NET Runtime verantwortlich sind. Das bedeutet, dass ASF nicht funktioniert, wenn Sie Ihre .NET SDK (Runtime) nicht verfügbar, veraltet oder defekt ist. Ebendarum empfehlen wir dieses Setup nicht für Gelegenheitsanwender, da Sie nun sicherstellen müssen, dass Ihr .NET SDK (Runtime) den ASF-Anforderungen entspricht und ASF ausführen kann; anstatt dass wir sicherstellen, dass unsere mit ASF gebündelte .NET Runtime dies ermöglicht.

Für das generic Paket können Sie dem gesamten betriebssystemspezifischen Leitfaden oben folgen, mit zwei kleinen Abweichungen. Zusätzlich zur Installation der .NET Prerequisites möchten Sie auch das .NET SDK installieren, und anstatt eine betriebssystemspezifische ArchiSteamFarm(.exe) ausführbare Datei zu haben, nutzen Sie nun eine generische Binärdatei ArchiSteamFarm.dll. Alles andere ist identisch.

Mit zusätzlichen Schritten:

• .NET Abhängigkeiten installieren.
• Installieren Sie .NET SDK (oder mindestens ASP.NET Core Laufzeit) passend für Ihr Betriebssystem. Sie möchten höchstwahrscheinlich ein Installationsprogramm verwenden. Lesen Sie die Runtime-Anforderungen, wenn Sie sich nicht sicher sind, welche Version installiert werden muss.
• Laden Sie die neueste ASF-Version (latest) der generic Variante herunter.
• Das Archiv an einen neuen Ort entpacken.
• ASF konfigurieren.
• Starte ASF entweder mit einem Hilfsskript oder führe dotnet /pfad/zu/ArchiSteamFarm.dll aus Ihrer Lieblingsshell heraus manuell aus.

Hilfsskripte (z. B. ArchiSteamFarm.cmd für Windows und ArchiSteamFarm.sh Linux/macOS befinden sich neben der ArchiSteamFarm.dll Binärdatei – diese sind lediglich in der generic Variante enthalten. Sie können diese verwenden, wenn Sie den Befehl dotnet nicht manuell ausführen möchten. Offensichtlich funktionieren Hilfsskripte nicht, wenn Sie .NET SDK nicht installieren und Sie keine dotnet ausführbare Datei in Ihrem PATH haben. Hilfsskripte sind völlig optional verwendbar, Sie können jederzeit dotnet /pfad/zu/ArchiSteamFarm.dll manuell eingeben.