Setting up zh TW
如果您是第一次來到這裡，歡迎！ 我們很高興又看到一位對我們的專案感興趣的旅客，但請記住：能力越強，責任越大⸺只要您足夠認真學習如何使用它，ASF就能完成相當多的Steam相關事務。 也對，詳讀Wiki、遵循我們的指南，並深入了解ASF的各種功能，最後將使您掌握目前Steam最強大工具之一的獨特使用技巧。
我們建議您一次只做一件事。 ASF涉及的領域非常廣泛，部分較為簡單，而另一些則相當複雜。 您不需要立即理解或閱讀一切，我們建議您以輕鬆的態度一點一點地來。 放輕鬆，拿杯喜歡的飲料，抽出一個小時進入我們的課堂⸺我們保證它值得。
讓我們從基礎開始：ASF本質上是一款控制台應用程式，這代表它不會生成您經常使用的圖形化介面。 ASF作為一個通用應用程式，主要以服務（常駐程式）的形式執行，而非桌面應用程式。 它的其中一個使用範例為在伺服器設備上執行，而桌面應用程式完全不適合在這個情境下使用。 不過，這僅描述了程式的核心，因為事實上ASF確實有圖形化介面⸺也就是內建的前端，ASF-ui，我們會在稍後討論這部分⸺我們先提這部分，是為了避免您被黑色控制台視窗之類的東西嚇到。
在您取得ASF二進制檔案後，程式需要您來設定，也就是您指定ASF要來做哪些事情。 您可以在尚未設定的情形下直接啟動程式，在這種情形下，ASF會以預設設定啟動，能夠讓您進行部分操作，例如透過ASF-ui設定，但除此之外就無法在未經預先設定的情形下發揮出更多功能了。
大概就先說這些吧，讓我們先開始！
在一般情形下，這是我們在接下來的幾分鐘內要做的事情：
某些步驟一目了然，但其他的可能需要您稍加注意。 別擔心，我們會手把手帶您進入。
首要步驟，是確保您的作業系統可以正確地啟動ASF。 這部分您不必特別了解，但ASF是用C#語言編寫的，基於.NET平台，並可能需要您平台上尚未擁有的原生函式庫。 您可以把它想像成3D遊戲需要DirectX，或是車子需要引擎發動。
依據您是使用Windows、Linux或macOS，您將需要滿足不同的需求。 參考文件為.NET需求套件，但為了簡單起見，我們也在下方列出了一切所需，這樣您就不必閱讀整份文件，除非您遇到了問題或有額外需求。
若您已安裝並使用了其他第三方軟體，一些（甚至全部）相依性套件已存在於您的作業系統上，是很正常的。 不過，這種情形並非總是發生，導致您需要在您的作業系統中執行相應的安裝程式⸺沒有這些相依套件的話，ASF將會完全無法啟動，且您在這種情形下也基本不會看到任何有用的錯誤資訊。
請注意，您不需要特地為特定作業系統的組建版本做其他任何事情，特別是.NET SDK的安裝或執行環境，因為它們已包含於作業系統套件中。 您只需要安裝.NET需求套件（相依套件），使ASF自帶的.NET執行環境能執行即可⸺僅需安裝下列指定的內容，不需安裝其他東西。
Windows：
- Microsoft Visual C++可轉散發套件更新（64位元組使用x64、32位元組使用x86、64位元組ARM使用arm64）
- 強烈建議您，務必確保已安裝所有的Windows更新。 若您尚未啟用自動更新，您最少需要安裝KB2533623及KB2999226，但有可能還需要安裝更多更新。 若您的Windows已是最新版本，或足夠新版，則可跳過這項說明。
Linux：
套件名稱取決於您使用的Linux發行版本，我們列出了最常見的套件名稱。 您可以使用本機中的套件管理系統，為您的作業系統取得全部套件（例如適用於Debian的apt，或適用於CentOS的yum）。 這些都是非常標準的函式庫，不論您使用哪種發行版本都應該有對應的可供使用，您只需要弄清楚它們在您的環境中叫什麼名稱。
-
ca-certificates（用於建立HTTPS連線的標準可信賴的SSL憑證） -
libc6（libc） -
libgcc-s1（libgcc1、libgcc） -
libicu（icu-libs，您的發行版本的最新版，例如libicu76） -
libgssapi-krb5-2（libkrb5-3、krb5-libs） -
libssl3（libssl、openssl-libs，您的發行版本的最新版，且至少為1.1.X版本） -
libstdc++6（libstdc++，5.0版本或更高） -
zlib1g（zlib）
上述大多數套件應早已安裝於您的系統中。 舉例來說，Debian穩定版的最小安裝通常也只需再安裝libicu76即可。
macOS：
- 您不必做額外的事情，但您仍應安裝最新版本的macOS，至少為12.0+版本
既然我們有了所有的相依性套件，那麼接下來就是下載ASF最新版本。 ASF有許多變體版本可供使用，但您應使用符合您作業系統及其架構的版本套件。 舉例來說，假設您使用64位元Windows，那麼您需使用ASF-win-x64版本的套件。 欲取得關於可用變體的更多資訊，請參閱相容性章節。 ASF也可以執行於沒有提供組建版本的環境中，例如32位元Windows，但您需要安裝Generic版本。
下載完成後，請先解壓縮.zip檔至一個資料夾中。 若您需要特定的工具，7-zip即可做到，不過使用任何標準工具（例如Windows內建的解壓縮，或Linux/macOS中的unzip工具）應該也沒有問題。
請注意，務必將ASF解壓縮至獨立的資料夾中，不要解壓縮至有其它用途的資料夾⸺這非常重要。 ASF含有自動更新功能，也就是會取代自身的檔案，在升級時，通常會刪除舊的或不相關的檔案，會使得您在ASF資料夾中放置的任何的無關檔案遺失。 若您擁有與ASF相關的額外腳本或檔案，那也沒問題，您可以為其建立一個獨立資料夾，或是將ASF放在其子資料夾中。
一個檔案結構範例，看起來會像是這樣：
C:\ASF（可存放您自己的東西）
├── MyNotes.txt（選擇性）
├── AsfMakeMeCoffeeScript.bat（選擇性）
├── (...)（其餘您想存放的檔案，選擇性）
└── Core（ASF專用資料夾，也就是您解壓縮壓縮檔的地方）
├── ArchiSteamFarm(.exe)
├── config
├── logs
├── plugins
├── www
└── (...)
現在只剩最後一步：組態設定。 ASF基於「Bot」的概念運作，每個Bot對應了您要在ASF中使用的每個Steam帳號。 您可以定義任意數量的Bot，但對於初學者而言，我們將專注於單一一個⸺通常是您的主要帳號。 ASF也擁有非Bot的設定檔，最重要的當屬全域設定檔，它會影響到實例中的所有Bot。
建議您，如果不清楚、或不了解某個設定，最好維持預設值，不要隨意修改。 ASF offers countless ways to configure, customize and tweak almost all of its features, but like mentioned above, trying to understand it right off the bat is a rabbit hole that may quickly drag you into severe confusion, if not straight into the abyss. Instead, we recommend to have a working example first, and only then start digging into additional options, with the help of configuration page on the wiki, while changing one thing at a time.
ASF configuration can be done in several ways - through our built-in ASF-ui frontend, a standalone web config generator, or manually. 這在組態設定章節中有深入的解釋，若您想要取得更多詳細資訊，請參閱此部分。 We'll use standalone web config generator as a starting point, because it works even if for some reason ASF-ui fails to start or work correctly.
Navigate to our web config generator page with your favourite browser. We recommend Chrome or Firefox, but it should not matter as long as your browser works for everything else.
開啟頁面後，切換到「Bot」分頁。 您應該會看見類似於下圖的頁面：
如果您剛剛下載的ASF版本低於設定檔生成器的預設值，只需在下拉式選單中選擇您的ASF版本。 This can (rarely) happen, as the config generator can be used for generating configs to newer (pre-release) ASF versions that weren't marked as stable yet. You've downloaded latest stable release of ASF that is verified to work reliably, so it might be a bit older than the absolute cutting edge version, which is totally not suitable for the first-time use.
Start from putting name for your bot into the field highlighted as red, called Name. 您可以使用任何名稱，例如您的暱稱、帳號名稱、一串數字或是任何其他文字。 其中只有一個您無法使用的名稱，ASF，因為這個關鍵字是為全域設定檔保留的。 除此之外，Bot的名稱不能以一個點作為開頭（ASF會略過那些檔案）。 We also recommend that you avoid using spaces, you can use _ as a word separator if needed - not a strict requirement, but you'll have hard time using ASF commands otherwise.
Bot name decided? Great, in the next step, change Enabled switch to be on, that one defines whether your bot is supposed to be started by ASF automatically after launch (of the program). Not doing that will cause ASF to state that your bot is disabled in the configuration file, and it'll wait for your input to start it, which is not what we want to be doing in this example.
Now, there are two sensitive properties coming up next: SteamLogin and SteamPassword. You can make another decision here - either you can put your Steam login details in those two properties, or you can decide against doing that, leaving them empty.
ASF需要您的登入憑證，因為它是透過內建的Steam用戶端來實現的，且需要跟您自己使用的用戶端相同的登入資訊。 Your login credentials are not saved anywhere but on your PC in ASF config directory only (once you download the generated config). Our web config generator is client-based application which means that everything you're doing inside our standalone web config-generator website is running 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 operate without them.
If you decide to input your credentials, ASF will be able to automatically log in during startup, which together with optional 2FA will effectively allow you to just double-click the program to run everything. If you decide to omit them, then ASF will ask you to input those details when needed - that approach won't save them anywhere, but naturally ASF won't be able to operate without your help. It's up to you which way you prefer more, and you can also find additional information in configuration section, as usual.
As a side note, 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 if needed (similar to Steam Client). If by any chance you're using 4-digit parental pin to unlock your account, we also recommend to put it inside SteamParentalPin box, although also in this case you can just leave this empty, and instead observe how weak that protection is, because ASF can also "crack" it itself within mere seconds after logging in. Oops.
After following with everything above, so once again, bot name, enabled switch, and login credentials , your web page will now look similar to the one below:
現在您可以點擊「下載」按鈕，設定檔生成器會生成一個名為您剛才輸入的名稱的.json檔。 Save that file into config directory which is located in the folder inside which you've extracted the zip file in the previous step.
恭喜！ 您剛剛完成了最基本的ASF Bot組態設定。 There's a lot more to discover, but for now this is everything that you need.
I know you've been waiting for this moment, and we can't hold you longer, as you're now ready to launch the program for the first time. 只需雙擊ASF資料夾中的ArchiSteamFarm二進制執行檔即可。 您也可以使用控制台來開啟它。
Now would be a good time to review our remote communication section if you're concerned about stuff that ASF is programmed to do, especially actions that it'll take in your name, such as joining our Steam group by default. You can always disable selected functionalities later on if you won't like them, ASF simply comes with sensible defaults, and we had to make some decision about general use that applies to the majority of our userbase, as well as our own view on the program in its principle.
Assuming everything went well, which mostly considers installing all required dependencies in the first step, and configuring ASF in the third one, ASF should launch properly, discover your first bot, and attempt to log in:
ASF will most likely still require one more detail from you - 2FA to access the account (unless you disabled SteamGuard completely, then no). Simply follow the instructions on the screen, you can provide code from authenticator/e-mail, or accept the confirmation in the mobile app.
Something went wrong?
Either you're missing .NET prerequisites, or you've downloaded incorrect variant of ASF for your machine. If you don't know what's wrong, check our FAQ for a possible way to find out exact problem, and if you're still stuck, reach for our support.
You didn't put generated config into the config directory. Some other common mistakes in this step might include manually changing extension from .json e.g. to .txt, and some operating systems (e.g. Windows) like to hide common extensions by default, so ensure your file is in appropriate place and also with appropriate name.
You forgot to flip the Enabled switch which tells ASF to start your bot automatically. Unless that was your intention of course, but then you should already know how to execute commands, simply start your bot after that message.
Your login credentials are most likely wrong. Check your SteamLogin and SteamPassword in the generated config, if they're wrong, correct them by going back to the configuration step. If you're still having issues, try to use the same login credentials in your own Steam client - you should also fail to log in, and perhaps you'll get more information on what's wrong this way.
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 touch as of now:
這代表ASF現在已成功地在您的帳號上運作，您可以將程式最小化，然後去做其他事情。 Go ahead, you deserved it, maybe refill that drink of your choice at least!
Farming cards is a subject for another lengthy article like this, but in principle: 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, which answers the most common question people have at this point, wondering why despite owning whopping 14 games on their account, ASF claims there's nothing to do - no, it's not a bug.
我們最基本的新手上路指南到此結束。 Like in every RPG game, you've finished the tutorial, and we're leaving you whole ASF world to explore now. For example 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 if you'd like to read a bit more, then leave you entire wiki for discovery.
ASF支援一個帳號以上的同時掛卡，這也是它的主要功能。 您可以透過生成更多Bot設定檔來增加更多帳號，方法跟您幾分鐘前產生的第一個設定檔完全相同。 您只需要確保兩件事：
- 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,SteamPasswordandSteamParentalCode(if you've decided to fill them)
也就是說，就是再次回到組態設定的部分，然後做完全一樣的事情，只不過這次要填入您第二或是第三個帳號的資訊。 Remember to use unique names for all of your bots, to not overwrite existing configs.
In our standalone web config-generator, you change existing settings in exactly the same way - by generating a new config file. Click on "toggle advanced settings" and see what is there for you to discover. In this example, we'll change CustomGamePlayedWhileFarming setting, which allows you to set custom name being displayed when ASF is farming, instead of showing actual game.
Let's analyze this a bit first. If you run ASF and start farming, in default settings you'll see that your Steam account is in-game now:
That makes sense, after all ASF just told the Steam platform that we're playing the game, we need cards from it, right? But hey, we can customize this! Toggle advanced settings if you haven't done in yet, then find CustomGamePlayedWhileFarming. Simply put any custom text that you want to display there, such as "Idling cards":
現在跟之前一樣下載新的設定檔，然後用新的設定檔取代舊的。 You can also delete your old config file and put the new one in its place of course.
ASF is pretty smart and it should notice that you've changed the config, which it should then automatically pick up and apply, without a program restart. If by any chance that didn't happen, you can simply restart the program to ensure your new config is picked up. After doing that, you should notice that ASF now displays your custom text in the previous place:
這證明了您已成功修改您的設定。 您也可以使用相同的方式來修改ASF全域屬性，切換至「ASF」分頁，下載生成出來的ASF.json設定檔，並放到config資料夾中。
使用我們的ASF-ui前端，可以更輕鬆地編輯您的ASF設定，我們在接下來會有更深入的說明。
As we mentioned before, ASF is a console app and doesn't launch a graphical user interface by default. 但是，我們也積極開發使用IPC介面的ASF-ui前端，它能夠存取各種ASF功能，是個非常方便的使用者友好方式。
In order to use ASF-ui, you need to have IPC enabled, which is the default option, so unless you manually disabled it, it's already active. 啟動ASF之後，您應該能夠看到它自動成功開啟IPC介面的訊息：
IPC, in a nutshell, is built-in ASF's web server that starts locally on your machine, allowing you to interact with it using your favourite web browser. Assuming that it started correctly, you can access ASF's IPC interface by clicking this link, as long as ASF is running, from the same machine. 您可以使用ASF-ui來進行各種操作，例如直接編輯設定檔，或是傳送指令。 您可以隨意瀏覽它，來發現ASF-ui的全部功能。
您已成功設定了ASF，讓它使用您的Steam帳號，並依據您的喜好進行了客製化。 If you followed our entire guide, then you also managed to tweak ASF through our ASF-ui interface and started discovering its functionalities. This concludes our tutorial, but we're leaving you with some additional pointers to stuff that you may be interested in, "side quests", if you insist:
- Our configuration section will explain to you what all those different settings you've seen actually do, and what else ASF can offer to you. Just remember to hydrate properly while reading, you've been warned.
- If you've stumbled upon some issue or you have some generic question, consider our FAQ, which should cover all, or at least a vast majority of questions and issues that you may have.
- 如果您想了解關於ASF的一切資訊，及它如何讓您的掛卡事半功倍，請閱讀ASF Wiki的剩餘部分。 Use the sidebar on the right to pick the subject that interests you.
- And finally, 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 small donation to our cause. ASF is labor of love, we've been working hard in our free time for the last 10+ years to make this experience possible for you, and we're very proud of it - even $1 is highly appreciated and shows that you care. In any case, have lots of fun!
This appendix 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, it also comes with additional benefits.
You want to use generic variant mainly when:
- You're using OS that we don't build OS-specific package for (such as 32-bit Windows)
- You already have .NET Runtime/SDK, or want to install and use one
- You want to minimize ASF structure size and memory footprint by handling runtime requirements yourself
- You want to use a custom plugin which requires a
genericsetup of ASF to run properly (due to missing native dependencies)
Of course, you can use it also in any other scenario you want, but the above make the most sense.
However, keep in mind that generic setup comes with a twist - you are in charge of .NET runtime in this case. This means that if your .NET SDK (runtime) is unavailable, outdated, or broken, ASF simply won't work. This is why we totally 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 only two small changes. In addition to installing .NET prerequisites, you also want to install .NET SDK, and instead of downloading and having OS-specific ArchiSteamFarm(.exe) executable file, you'll now download and have a generic ArchiSteamFarm.dll binary only. 而其他步驟都是完全相同的。
增加了額外步驟之後：
- 安裝.NET需求套件。
- 安裝適合您的作業系統的.NET SDK（或至少安裝ASP.NET Core及.NET執行環境）。 大部分情形下您會需要一個安裝程式。 如果您不知道要安裝.NET Core的哪一個版本，請參閱執行環境需求。
- 在ASF發布頁面下載
Generic版本變體。 - 將壓縮檔解壓縮至一個新資料夾中。
- Configure ASF, in exactly the same way as described above.
- 透過輔助腳本或是手動在Shell中執行
dotnet /路徑/至/ArchiSteamFarm.dll指令來啟動ASF。
Generic variant of ASF does not have machine-specific binary, after all it's called generic for a reason - it's platform-agnostic build that can work everywhere.
This is why we've bundled it with helper scripts (such as ArchiSteamFarm.cmd for Windows and ArchiSteamFarm.sh for Linux/macOS), which are located next to ArchiSteamFarm.dll binary. You can use those 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. They're also entirely optional to use, you can always dotnet /path/to/ArchiSteamFarm.dll manually if you'd like to, as under the hood with some extra tweaks, that's exactly what those scripts are doing anyway.
