-
-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Setting up zh HK
ๅฆๆๆจๆฏ้ฆๆฌกไพ่จช๏ผๆญก่ฟ๏ผ ๆๅๅพ้ซ่ๅ่ฆๅฐไธไฝๅฐๆๅ็้ ็ฎๆ่่ถฃ็่จชๅฎข๏ผไฝ่ซ่จไฝ่ฝๅ่ถๅผท่ฒฌไปป่ถๅคงโโๅช่ฆไฝ ่ถณๅค ่ช็ๅปๅญธ็ฟๅฆไฝไฝฟ็จๅฎ๏ผASF ๆ่ฝๅๅฎๆ้ๅธธๅค็ Steam ็ธ้ไบๅใ ๆธๅฑฑๆ่ทฏๅค็บๅพ๏ผๅญธๆตท็กๆถฏ่ฆไฝ่๏ผๅจ้ๅง้ๆฎต้กๅณญ็ๅญธ็ฟๆ ้ไนๅ๏ผๆๅๆๅพ ๆจ้ฑ่ฎ้ๆน้ข็wiki๏ผ่ฉณ็ดฐไบ่งฃ้ไธๅๆฏๅฆไฝ้ไฝ็ใ
ๅฆๆๆจ้ๅจ้่ฃ๏ผ้ฃๅฐฑๆๅณ่ๆจ่ชๅๆๅไธ้ข็ๆๅญ๏ผไธ้ฏใ ้ค้ไฝ ่ทณ้ๅฎ๏ผๅฆๅๆจๅพๅฟซๅฐฑๆ็ถๆญท**ไธๆฎต่ฑ้ฃ็ๆ้**โฏโฏ Anyway, ASF is a console app, which means that the program itself doesn't have a friendly GUI that you're in general used to, at least out of the box. ASF ไธป่ฆ่จญ่จไปฅๅจไผบๆๅจไธๅท่ก๏ผๆไปฅๅฎๅ ไฝ็บไธๅๆๅ๏ผๅฎ่ญท้ฒ็จ๏ผ้่ก๏ผ่้ๆก้ขๆ็จ็จๅผใ
็ถ่้ไธฆไธไปฃ่กจๆจไธ่ฝๅจ PC ไธไฝฟ็จๅฎ๏ผๆๅฎๅจๆ็จฎ็จๅบฆไธๆฏๅธธ่ฆ็็จๅผๆด่ค้๏ผไธฆ้ๅฆๆญคใ ASFๆฏไธๅ็จ็ซ็็จๅผ๏ผไธ้่ฆๅฎ่ฃไธฆไธๅฏไปฅ็ซๅณไฝฟ็จ๏ผไฝ้ไนๅ้่ฆ้ฒ่ก่จญ็ฝฎใ ่จญ็ฝฎ ASF ไปฅๅฎ็พฉๅฎๅๅไนๅพๆ่ฉฒๅไป้บผใ ๅฆๆไฝ ๅจๆฒๆ่จญ็ฝฎ็ๆ ๆณไธๅๅๅฎ๏ผ้ฃ้บผ ASF ๅฐไธๆๅไปปไฝไบๆ ๏ผๅฐฑๆฏ้้บผ็ฐกๅฎใ
ไธ่ฌไพ่ชช๏ผ้ๆฏๆๅๅจๆฅไธไพ็ๅนพๅ้ๅ ง่ฆๅ็ไบๆ ๏ผ
- Install .NET prerequisites.
- ไธ่ผ้ฉๅๆจๆไฝ็ณป็ตฑ็**ๆๆฐ็ ASF **
- Extract the archive into new location.
- ้ ็ฝฎASFใ
- ๅๅ ASF๏ผ่ฆ่ญๅฅ่น็ๆๅป๏ผ
่ผ่ๆ่๏ผๅฐๅง๏ผ ๆไปฅ่ฎๆๅ็นผ็บๅงใ
็ฌฌไธๆญฅๆฏ็ขบไฟๆจ็ๆไฝ็ณป็ตฑๅฏไปฅๆญฃ็ขบๅฐๅๅ 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 macOS, you will have different requirements, although all of them are listed in .NET prerequisites document that you should follow. ้ๆฏๆๅๆ่ฉฒไฝฟ็จ็ๅ่่ณๆ๏ผไฝ็บไบ็ฐกๅฎ่ตท่ฆ๏ผๆๅ้ๅจไธ้ข่ฉณ็ดฐไป็ดนไบๆๆ้่ฆ็ๅฅ่ฃ่ปไปถใๅ ๆญคๆจ็ก้้ฑ่ฎๅฎๆด็ๆๆชใ
ๅจ้ๅธธๆ ๆณไธ๏ผๆจๆญฃๅจไฝฟ็จ็ๅ ถไป่ปไปถๅทฒๅฎ่ฃไบๅ ถไพ่ณด้ ๏ผๅ ๆญคๆจ็ๆไฝ็ณป็ตฑไธๅฏ่ฝๅทฒ็ถๅญๅจๆไบ๏ผ็่ณๅ จ้จ๏ผไพ่ณด้ ใ ็ถ่๏ผๆจ้ๆฏๆ้่ก็ธๆๅฎ่ฃ็จๅผไปฅ็ขบไฟๆจ็ๆไฝ็ณป็ตฑไธ็ขบๅฏฆๅทฒ็ถๅญๅจ ASF ็ไพ่ณด้ โโๅฆๅ 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.
- Microsoft Visual C++ Redistributable Update (x64 for 64-bit, x86 for 32-bit or arm64 for 64-bit ARM)
- ๅผท็ๅปบ่ญฐๆจ็ขบไฟๅทฒๅฎ่ฃๆๆ Windows ๆดๆฐใ If you don't have them enabled, then at the very least you need KB2533623 and KB2999226, but more updates may be needed. You don't need to install them if your Windows is up-to-date.
ๅฅ่ฃๅ็จฑๅ ๆจไฝฟ็จ็ Linux ็ๆฌ่็ฐ๏ผๆๅๅๅบไบๆๅธธ่ฆ็ๅฅ่ฃ่ปไปถๅ็จฑใ ๆจๅฏไปฅ็ฒๅพๆๆ้ไบ้ฉ็จๆผๆจๆไฝ็ณป็ตฑ็ๆฌๆฉๅฅไปถ็ฎก็ๅจ๏ผๅฆ้ฉ็จๆผ Debian ็apt
ๆ้ฉ็จๆผ CentOS ็ yum
๏ผใ
-
ca-certificates
(standard trusted SSL certificates to make HTTPS connections) -
libc6
(libc
) -
libgcc-s1
(libgcc1
,libgcc
) -
libicu
(icu-libs
, latest version for your distribution, for examplelibicu72
) -
libgssapi-krb5-2
(libkrb5-3
,krb5-libs
) -
libssl3
(libssl
,openssl-libs
, latest version for your distribution, at least1.1.X
) -
libstdc++6
(libstdc++
, in version5.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 libicu72
.
- None for now, but you should have latest version of macOS installed, at least 12.0+
็ฑๆผๆๅๅทฒ็ถๆไบๆๆๅฟ
้็ไพ่ณด้
๏ผไธไธๆญฅๆฏไธ่ผ ๆๆฐ็ผไฝ็ASFใ ASFๆๅค็จฎๅ่ๅฏไพ้ธๆ๏ผๆจ็กๅฏ้ธๆ่ๆจ็ๆไฝ็ณป็ตฑๅๆถๆง็ธๅน้
็่ปไปถๅ
ใ ไพๅฆ๏ผๅฆๆๆจไฝฟ็จ64
ไฝWindows
๏ผ้ฃ้บผๆจ้่ฆASF-win-x64
ๅ
ใ ๆ้ๅฏ็จ่ฎ้ซ็ๆดๅคไฟกๆฏ๏ผ่ซ่จชๅ** ๅ
ผๅฎนๆง ้จๅใ ASFไนๅฏไปฅ้่กๅจๆๅๆฒๆ็บๅ
ถๆงๅปบ็นๅฎๆผๆไฝ็ณป็ตฑ็่ปไปถๅ
็ๆไฝ็ณป็ตฑไธ๏ผไพๅฆ 32ไฝWindows ๏ผ่ฉณๆ
่ซ่ฆ ้็จ่จญ็ฝฎ **ใ
After download, start from extracting the zip file into its own folder. If you require specific tool for that, 7-zip will do it, but all standard utilities like unzip
from Linux/macOS should work without problems as well.
Be advised to unpack ASF to its own directory and not to any existing directory you're already using for something else - ASF's auto-updates feature will delete all old and unrelated files when upgrading, which may lead to you losing anything unrelated you put in ASF directory. ๅฆๆๆจๆไปปไฝ่ฆ่ASFไธ่ตทไฝฟ็จ็้กๅค่ ณๆฌๆๆกฃๆก๏ผ่ซๅฐๅฎๅๆพๅจไนๅๆๅฐ็่ณๆๅคพไธญใ
็คบไพ็ตๆงๅฆไธๆ็คบ๏ผ
C:\ASF (where you put your own things)
โโโ ASF shortcut.lnk (optional)
โโโ Config shortcut.lnk (optional)
โโโ Commands.txt (optional)
โโโ MyExtraScript.bat (optional)
โโโ (...) (any other files of your choice, optional)
โโโ Core (dedicated to ASF only, where you extract the archive)
โโโ ArchiSteamFarm(.exe)
โโโ config
โโโ logs
โโโ plugins
โโโ (...)
ๆๅ็พๅจๅทฒ็ถๆบๅๅฅฝๅๆๅพไธๆญฅ๏ผ้ ็ฝฎใ ้ๆฏ่ฟไป็บๆญขๆ่ค้็ไธๆญฅ๏ผๅ ็บๅฎๆถๅ่จฑๅคๆจ้ไธ็ๆ็ๆฐไฟกๆฏ๏ผๅ ๆญคๆๅๅฐๅ่ฉฆๅจๆญคๆไพไธไบๆๆผ็่งฃ็็คบไพๅ็ฐกๅ่ชชๆใ
้ฆๅ ๏ผ** ้ ็ฝฎ ้ ้ข่งฃ้ไบไธๅ**่้ ็ฝฎๆ้็ไบๆ ๏ผไฝๅฎๅ ๅซๅคง้็ๆฐไฟกๆฏ๏ผๅ ถไธญ็ๅพๅคไฟกๆฏๆๅไธฆไธ้่ฆ็ซๅณ็่งฃใ ็ธๅ๏ผๆๅๅฐๆๆจๅฆไฝ็ฒๅๆจๅฏฆ้่ฆๆพ็่ณ่จใ
ASF configuration can be done in at least three ways - through our web config generator, ASF-ui or manually. ้ๅฐๅจ ้ ็ฝฎ ้จๅไธญ้ฒ่กๆทฑๅ ฅ่งฃ้๏ผๅ ๆญคๅฆๆๆจๆณ่ฆๆด่ฉณ็ดฐ็่ณ่จ๏ผ่ซๅ่ใ We'll use web config generator as a starting point.
ไฝฟ็จๆจๅๆญก็็่ฆฝๅจๅฐ่ชๅฐๆๅ็** ็ถฒ้ ่จญๅฎๆช็ข็ๅจ **้ ้ข๏ผ่ฅๆจไนๅๆๅ็ฆ็จไบ Javascript๏ผๆจ้่ฆๅ็จไนใ ๆๅๆจ่ฆ Chrome ๆ Firefox๏ผไฝๅฎๆ่ฉฒ้ฉ็จไบ็ถๅๆๆๆต่ก็็่ฆฝๅจใ
ๆ้้ ้ขๅพ๏ผๅๆๅฐใๆฉๆขฐไบบใ้ธ้ ๅกใ ็พๅจ๏ผๆจๆ่ฉฒๆ็ๅฐ้กไผผไบไธ้ข็้ ้ข๏ผ
ๅฆๆๆจๅๅไธ่ผ็ ASF ็ๆฌๆฏ็ถฒ้ ่จญๅฎๆช็ข็ๅจ็้ ่จญ็ๆฌๆด่๏ผๅพไธๆ่ๅฎไธญ้ธๆๆจ็ ASF ็ๆฌๅณๅฏใ ๅ ็บ้ ็ฝฎ็ๆๅจๅฏ็จๆผ็ๆ้ ็ฝฎๅฐๅฐๆชๆจ่จ็บ็ฉฉๅฎ็่ผๆฐ๏ผ้ ็ผๅธ๏ผASF ็ๆฌ๏ผๆไปฅ้็งๆ ๆณๆๅฏ่ฝ็ผ็ใ ๆจไธ่ผ็ๆฏ็ถ้้ฉ่ญๅฏ้ ้่ก็ ASF ๆๆฐ็ฉฉๅฎ็ๆฌใ
ๅพๅจ็ชๅบ้กฏ็คบ็บ็ด
่ฒ็ๅญๆฎตๅกซๅ
ฅๆฉๆขฐไบบ็ๅ็จฑ้ๅงใ ้ๅฏไปฅๆฏๆจๆณ่ฆไฝฟ็จ็ไปปไฝๅ็จฑ๏ผไพๅฆๆจ็ๆต็จฑใๅธณๆถๅใ่็ขผๆไปปไฝๅ
ถไปๅ็จฑใ ๅชๆไธๅ่ฉไธ่ฝไฝฟ็จ๏ผASF
๏ผๅ ็บ่ฉฒ้้ตๅญๆฏ็บๅ
จๅ่จญๅฎๆชไฟ็็ใ ้คๆญคไนๅค๏ผๆจ็ๆฉๆขฐไบบๅ็จฑไธ่ฝไปฅ้ป้้ ญ๏ผASFๆๅฟฝ็ฅ้ไบๆช๏ผใ ๆๅ้ๅปบ่ญฐๆจ้ฟๅ
ไฝฟ็จ็ฉบๆ ผ๏ผๅฆๆ้่ฆ๏ผๅฏไปฅไฝฟ็จ _
ไฝ็บๅฎ่ฉๅ้็ฌฆ่ใ
ๅจ็ขบๅฎๅ็จฑๅพ๏ผ้ๅEnabled
้้๏ผ้ๅฐๅฎ็พฉ ASF ๆฏๅฆๆ่ฉฒๅจๅๅ๏ผ็จๅบไนๅพ๏ผ่ชๅๅๅๆจ็ๆฉๆขฐไบบ ใ
็พๅจ๏ผๆจๅฏไปฅๆฑบๅฎๅ ฉไปถไบ๏ผ
- ๆจๅฏไปฅๅจ
SteamLogin
ๅญๆฎตไธญๅกซๅ ฅๆจ็็ป้ๅธณ่๏ผไธฆๅจSteamPassword
ๅญๆฎตไธญๅกซๅ ฅๆจ็็ป้ๅฏ็ขผ - ๆ่ ๆจๅฏไปฅ่ฎๅฎๅ็ฉบ่
ๅ่ ๅฐๅ ่จฑ ASF ๅจๅๅๆ้่ชๅไฝฟ็จๆจ็ๅธณๆถๆๆ๏ผไฝฟๆจไธๅฟ ๅจๆฏๆฌก ASF ้่ฆๆๆๅ่ผธๅ ฅๅฎๅใ ไฝๆฏ๏ผๆจๅฏไปฅๆฑบๅฎ็็ฅๅฎๅ๏ผๅจ้็จฎๆ ๆณไธๅฎๅไธๆ่ขซไฟๅญ๏ผๅ ๆญค ASF ๅฐ็กๆณๅจๆฒๆๆจๅนซๅฉ็ๆ ๆณไธ่ชๅๅๅ๏ผๆจ้่ฆๅจ้่กๆ่ผธๅ ฅๅฎๅใ
ASF ้่ฆๆจ็็ป้ๆๆ๏ผๅ ็บๅฎไฝฟ็จๅ
ง็ฝฎ็Steam็จๆถ็ซฏๅฏฆ็พ๏ผไธฆไธ้่ฆ่ๆจ่ชๅทฑไฝฟ็จ็็จๆถ็ซฏ็ธๅ็่ฉณ็ดฐ่ณ่จ็ป้ใ Your login credentials are not saved anywhere but on your PC in ASF config
directory only, our web config generator is client-based which means that the code is run locally in your browser to generate valid ASF configs, without details you're inputting ever leaving your PC in the first place, so there is no need to worry about any possible sensitive data leak. Still, if you for whatever reason don't want to put your credentials there, we understand that, and you can put them manually later in generated files, or omit them entirely and put them only in ASF command prompt. More on security matter can be found in configuration section.
You can also decide to leave just one field empty, such as SteamPassword
, ASF will then be able to use your login automatically, but will still ask for password (similar to Steam Client). If you're using Steam parental to unlock the account, you'll need to put it into SteamParentalCode
field.
After the decision and optional details, your web page will now look similar to the one below:
You can now hit "download" button and our web config generator will generate new json
file based on your chosen name. Save that file into config
directory which is located in the folder where you've extracted our zip file in the previous step.
Your config
directory will now look like this:
ๆญๅ๏ผ ๆจๅๅๅฎๆไบ ASF ๆฉๆขฐไบบ็ๅบ็ค้ ็ฝฎใ ๆๅๅพๅฟซๅฐฑๆๅฐๆญค้ฒ่กๆดๅฑ่ชฌๆ๏ผ็พๅจ้ๅฐฑๆฏๆจ้่ฆ็ไธๅใ
ๆจ็พๅจๅทฒๆบๅๅฅฝ้ฆๆฌกๅๅ่ฉฒ็จๅบใ Simply double-click ArchiSteamFarm
binary in ASF directory. You can also start it from the console.
After doing so, assuming you installed all required dependencies in the first step, ASF should launch properly, notice your first bot (if you didn't forget to put generated config in config
directory), and attempt to log in:
If you supplied SteamLogin
and SteamPassword
for ASF to use, you'll be asked for your SteamGuard token only (e-mail, 2FA or none, depending on your Steam settings). If you didn't, you'll also be asked for your Steam login and password.
Now would be a good time to review our remote communication section if you're concerned about stuff ASF is programmed to do, including actions it'll take in your name, such as joining our Steam group.
After passing through initial login gate, assuming your details are correct, you'll successfully log in, and ASF will start farming using default settings that you didn't change as of now:
This proves that ASF is now successfully doing its job on your account, so you can now minimize the program and do something else. After enough of time (depending on performance), you'll see Steam trading cards slowly being dropped. Of course, for that to happen you must have valid games to farm, showing as "you can get X more card drops from playing this game" on your badges page - if there are no games to farm, then ASF will state that there is nothing to do, as stated in our FAQ.
This concludes our very basic setting up guide. You can now decide whether you want to configure ASF further, or let it do its job in default settings. We'll cover a few more basic details, then leave you entire wiki for discovery.
ASF supports farming more than one account at a time, which is its primary function. You can add more accounts to ASF by generating more bot config files, in exactly the same way as you've generated your first one just a few minutes ago. You need to ensure only two things:
- Unique bot name, if you already have your first bot named "MainAccount", you can't have another one with the same name.
- Valid login details, such as
SteamLogin
,SteamPassword
andSteamParentalCode
(if using Steam parental settings)
In other words, simply jump to configuration again and do exactly the same, just for your second or third account. Remember to use unique names for all of your bots.
You change existing settings in exactly the same way - by generating a new config file. If you didn't close our web config generator yet, click on "toggle advanced settings" and see what is there for you to discover. For this tutorial we'll change CustomGamePlayedWhileFarming
setting, which allows you to set custom name being displayed when ASF is farming, instead of showing actual game.
So let's do that, if you run ASF and start farming, in default settings you'll see that your Steam account is in-game now:
Let's change that then. Toggle advanced settings in web config generator and find CustomGamePlayedWhileFarming
. Once you do that, put your own custom text there that you want to display, such as "Idling cards":
Now download the new config file in exactly the same way, then overwrite your old config file with new one. You can also delete your old config file and put new one in its place of course.
Once you do that and start ASF again, you'll notice that ASF now displays your custom text in previous place:
This confirms that you've successfully edited your config. In exactly the same way you can change global ASF properties, by switching from bot tab to "ASF" tab, downloading generated ASF.json
config file and putting it in your config
directory.
Editing your ASF configs can be done much easier by using our ASF-ui frontend, which will be explained further below.
ASF is a console app and doesn't include a graphical user interface. ไฝๆฏ๏ผๆๅๆญฃ็ฉๆฅต่ดๅๆผ** ASF-ui **ๆๅ็ IPC ๅ็ซฏๆฅๅฃ๏ผๅฎๅฐไปฅๅ้ฉไธๅฐ็จๆถๅๅฅฝ็ๆนๅผไพ่จชๅๅ็จฎ ASF ๅ่ฝใ
In order to use ASF-ui, you need to have IPC
enabled, which is the default option. Once you launch ASF, you should be able to confirm that it properly started the IPC interface automatically:
You can access ASF's IPC interface under this link, as long as ASF is running, from the same machine. You can use ASF-ui for various purposes, e.g. editing the config files in-place or sending commands. Feel free to take a look around in order to find out all ASF-ui functionalities.
You've successfully set up ASF to use your Steam accounts and you've already customized it to your liking a little. If you followed our entire guide, then you also managed to tweak ASF through our ASF-ui interface and found out that ASF actually has a GUI of some sort. Now is a good time to read our entire configuration section in order to learn what all those different settings you've seen actually do, and what ASF has to offer. If you've stumbled upon some issue or you have some generic question, read our FAQ instead which should cover all, or at least a vast majority of questions that you may have. If you want to learn everything about ASF and how it can make your life easier, head over to the rest of our wiki. If you found out our program to be useful for you and you appreciate the massive amount of work that was put into it, you can also consider a donation to our cause. In any case, have fun!
This setup is for advanced users that want to set up ASF to run in generic variant. While being more troublesome in usage than OS-specific variants, they also come with additional benefits.
You want to use generic
variant mainly in those situations (but of course you can use it regardless):
- When you're using OS that we don't build OS-specific package for (such as 32-bit Windows)
- When you already have .NET Runtime/SDK, or want to install and use one
- When you want to minimize ASF structure size and memory footprint by handling runtime requirements yourself
- When you want to use a custom plugin which requires a
generic
setup of ASF to run properly (due to missing native dependencies)
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.
For generic
package, you can follow entire OS-specific guide above, with two small changes. 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. Everything else is exactly the same.
้กๅคๆญฅ้ฉ๏ผ
- Install .NET prerequisites.
- Install .NET SDK (or at least ASP.NET Core runtime) appropriate for your OS. You most likely want to use an installer. Refer to runtime requirements if you're not sure which version to install.
- Download latest ASF release in
generic
variant. - Extract the archive into new location.
- ้ ็ฝฎASFใ
- Launch ASF by either using a helper script or executing
dotnet /path/to/ArchiSteamFarm.dll
manually from your favourite shell.
Helper scripts (such as ArchiSteamFarm.cmd
for Windows and ArchiSteamFarm.sh
for Linux/macOS) are located next to ArchiSteamFarm.dll
binary - those are included in generic
variant only. You can use them if you don't want to execute dotnet
command manually. Obviously helper scripts won't work if you didn't install .NET SDK and you don't have dotnet
executable available in your PATH
. Helper scripts are entirely optional to use, you can always dotnet /path/to/ArchiSteamFarm.dll
manually.
- ๐ก Home
- ๐ง Configuration
- ๐ฌ FAQ
- โ๏ธ Setting up (start here)
- ๐ฅ ๅพๅฐๅบ่ๅๅๅจ
- ๐ข Commands
- ๐ ๏ธ Compatibility
- ๐งฉ ItemsMatcherPlugin
- ๐ Management
- โฑ๏ธ Performance
- ๐ก Remote communication
- ๐ช Steam ่ฆชๅๅไบซ
- ๐ Trading