Setting up ko KR

설치하기

여기 오신게 처음인가요? 환영합니다! 저희 프로젝트에 관심을 가진 또 한 분의 여행자를 만나게 되어 매우 기쁩니다. 다만 큰 힘에는 큰 책임이 따른다는 점을 유념해 주세요. ASF는 Steam과 관련된 다양한 작업을 수행할 수 있지만, 이는 어디까지나 여러분이 사용법을 배울 만큼의 관심을 기울일 때에 한합니다. 실제로 위키를 읽고, 저희 가이드라인을 따르며, 다양한 ASF 개념을 익히다 보면 결국 현존하는 가장 강력한 Steam 도구 중 하나를 다루는 독보적인 기술을 얻게 될 것입니다.

한 번에 하나씩 진행하실 것을 권장합니다. ASF는 매우 다양한 측면을 다루며, 그중 일부는 상당히 단순하지만 어떤 것들은 지나치게 복잡할 수 있습니다. 모든 것을 한 번에 이해하거나 읽을 필요는 없으며, 오히려 여유롭게 진행하시기를 권장합니다. 편안하게 마음먹고, 좋아하는 음료를 한 잔 준비한 뒤, 한 시간 정도 시간을 내어 저희 강의에 빠져 보세요. 그만한 가치가 있을 것이라고 약속드릴 수 있습니다.

기본부터 시작하겠습니다. ASF는 원리상 콘솔 앱이며, 이는 여러분이 일반적으로 익숙한 그래픽 인터페이스가 자동으로 뜨지는 않는다는 뜻입니다. ASF는 데스크톱 앱이 아니라 주로 서비스(데몬)로 동작하는 범용(generic) 앱입니다. 주요 사용 사례 중 하나는 데스크톱 앱이 전혀 적합하지 않은 서버 장비에서의 실행입니다. 다만 이는 프로그램의 핵심 부분에만 해당하는 이야기입니다. ASF에는 실제로 자체 그래픽 인터페이스가 있으며, 내장된 ASF-ui 프론트엔드가 그것입니다. 이 부분은 적절한 때에 다루겠습니다. 검은 콘솔 화면 같은 것을 보고 당황하지 않으시도록 미리 말씀드립니다.

ASF 바이너리 파일을 받고 나면, 프로그램은 ASF가 정확히 무엇을 하기를 원하는지 지정하는 설정을 요구합니다. 설정 없이도 프로그램을 시작할 수 있으며, 이 경우 ASF는 기본 설정으로 실행되어 초기 설정에 ASF-ui 등을 사용할 수 있게 해 줍니다. 다만 그 외에는 여러분이 먼저 무언가를 하지 않는 한 별다른 동작을 하지 않습니다.

일단은 이 정도면 충분하니, 시작해 봅시다!

---

특정 OS에 설치하기

일반적으로 다음 몇분동안 할 일의 목록입니다:

• **.NET 사전 요구 사항**을 설치합니다.
• 그런 다음 사용 중인 OS에 맞는 변형으로 **최신 ASF 릴리스**를 내려받습니다.
• 다음으로 압축 파일을 새 위치에 풉니다.
• 그런 다음 **ASF를 설정**합니다.
• 마지막으로 ASF를 실행해 그 진가를 확인해 봅니다.

일부 단계는 설명이 필요 없을 만큼 간단하지만, 어떤 단계는 좀 더 주의가 필요합니다. 걱정하지 마세요, 저희가 잘 안내해 드리겠습니다.

---

.NET 사전 요구 사항

첫 번째 단계는 당신의 OS가 ASF를 제대로 실해할 수 있는지를 확인하는 것입니다. 굳이 아실 필요는 없지만, ASF는 .NET 플랫폼 기반의 C#으로 작성되었으며, 아직 여러분의 플랫폼에 없는 네이티브 라이브러리를 필요로 할 수 있습니다. 3D 게임의 DirectX나 자동차의 시동 엔진 같은 것이라고 생각하시면 됩니다.

Windows, Linux, macOS 중 무엇을 사용하느냐에 따라 요구 사항이 달라집니다. 참고 문서는 **.NET 사전 요구 사항**이지만, 편의를 위해 필요한 패키지를 아래에 모두 정리해 두었으므로, 문제가 발생하거나 추가로 궁금한 점이 생기지 않는 한 해당 문서를 읽으실 필요는 전혀 없습니다.

당신의 시스템에 일부(혹은 전체) 종속성이 이미 존재하는 것은 사용하고 있는 제3자 소프트웨어가 설치했을 수 있으므로 완벽하게 정상입니다. 그렇더라도 반드시 그럴 필요는 없으니, 사용 중인 OS에 맞는 설치 프로그램을 실행해야 합니다. 이러한 종속성이 없으면 ASF는 아예 실행되지 않으며, 무엇이 잘못되었는지에 대한 유용한 정보도 거의 얻을 수 없습니다.

OS별 빌드의 경우 그 외에 다른 작업은 할 필요가 없다는 점을 유의하세요. 특히 .NET SDK나 런타임조차 설치할 필요가 없습니다. OS별 패키지에 이미 모두 포함되어 있기 때문입니다. ASF에 포함된 .NET 런타임을 실행하는 데 필요한 것은 .NET 사전 요구 사항(종속성)뿐입니다. 즉, 아래에 명시한 항목들만 있으면 되며 그 외에 추가로 필요한 것은 없습니다.

Windows:

• Microsoft Visual C++ 재배포 가능 패키지 업데이트 (64비트는 x64, 32비트는 x86, 64비트 ARM은 arm64)
• 모든 윈도우 업데이트를 미리 설치해 놓는 것을 매우 권장합니다. 이를 활성화하지 않은 경우 최소한 **KB2533623**과 **KB2999226**이 필요하며, 더 많은 업데이트가 필요할 수도 있습니다. Windows가 최신 상태이거나 적어도 충분히 최근 버전이라면 이 부분은 신경 쓰지 않으셔도 됩니다.

Linux:

리눅스 배포판에 따라 패키지 이름이 다릅니다. 아래에 공통적인 것들을 나열했습니다. 데비안에서는 apt, CentOS에서는 yum 등 OS에서 사용하는 자체 패키지 관리자를 통해 전부를 설치할 수 있습니다. 아래는 어떤 배포판을 사용하든 제공될 만한 상당히 표준적인 라이브러리들이며, 사용 중인 환경에서 어떤 이름으로 불리는지만 확인하면 됩니다.

• 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 stable의 최소 설치 환경에서는 보통 libicu76만 필요합니다.

macOS:

• 특별히 필요한 것은 없지만, 최소 12.0 이상의 최신 버전 macOS가 설치되어 있어야 합니다

---

다운로드

모든 필요한 종속 프로그램을 다 가지고 있으므로, 다음 단계는 **최신 ASF 릴리즈**를 다운로드 받는 것입니다. ASF는 다양한 변종이 있지만 당신은 OS와 아키텍쳐에 맞는 패키지를 원할 것입니다. 예를들어 64-비트 윈도우를 사용한다면, ASF-win-x64 패키지를 사용하면 됩니다. 사용가능한 변종에 대한 더 많은 정보를 원하시면 호환성 항목을 참고하십시오. ASF는 32비트 Windows처럼 저희가 OS별 패키지를 빌드하지 않는 환경에서도 실행할 수 있지만, 그러려면 **범용(generic) 설정**이 필요합니다.

다운로드 후에 zip 파일의 압축을 폴더에 푸는 것부터 시작하십시오. 이를 위해 특정 도구가 필요하다면 **7-zip**이면 충분하지만, Windows 내장 압축 해제 기능이나 Linux/macOS의 unzip 같은 모든 표준 유틸리티도 문제없이 작동합니다.

ASF는 자체 디렉터리에 풀어야 하며, 이미 다른 용도로 사용 중인 기존 디렉터리에 풀어서는 안 된다는 점에 유의하세요. 이는 중요한 사항입니다. ASF에는 자체 파일을 교체하는 자동 업데이트 기능이 포함되어 있으며, 업그레이드 시 오래되었거나 관련 없는 파일을 대개 모두 삭제합니다. 따라서 ASF 디렉터리에 넣어 둔 관련 없는 파일들을 잃을 수 있습니다. ASF와 함께 사용하려는 추가 스크립트나 파일이 있다면 문제될 것은 없습니다. 그런 파일들을 위한 전용 폴더를 만들고, ASF는 한 단계 더 안쪽 폴더에 두시면 됩니다.

예시 구조는 다음과 같을 수 있습니다:

C:\ASF (where you put your own things)
    ├── MyNotes.txt (optional)
    ├── AsfMakeMeCoffeeScript.bat (optional)
    ├── (...) (any other files of your choice, optional)
    └── Core (dedicated to ASF only, where you extract the archive)
         ├── ArchiSteamFarm(.exe)
         ├── config
         ├── logs
         ├── plugins
         ├── www
         └── (...)

---

환경설정

마지막 단계인 환경설정을 할 준비가 되었습니다. ASF는 "봇"이라는 개념으로 동작하며, 각 봇은 보통 ASF 안에서 사용하려는 하나의 Steam 계정입니다. 원하는 만큼 봇을 선언할 수 있지만, 처음에는 그중 하나에만 집중하겠습니다. 보통은 주 계정입니다. ASF에는 봇이 아닌 설정 파일들도 있으며, 그중 가장 중요한 것은 인스턴스의 모든 봇에 영향을 미치는 전역 설정 파일입니다.

일반적인 원칙은, 잘 모르거나 어떤 설정이 이해되지 않는다면 아무것도 바꾸지 말고 기본값 그대로 두라는 것입니다. ASF는 거의 모든 기능을 설정하고, 사용자화하고, 조정할 수 있는 무수한 방법을 제공합니다. 다만 위에서 말씀드린 대로, 처음부터 이를 전부 이해하려 드는 것은 토끼굴에 빠지는 일이며 심각한 혼란, 나아가 **곧장 나락**으로 이어질 수 있습니다. 대신 먼저 작동하는 예시를 만들어 두고, 그다음에 위키의 설정 페이지를 참고하면서 한 번에 하나씩 바꿔 가며 추가 옵션을 파고들기 시작하시길 권장합니다.

ASF 설정은 여러 방법으로 할 수 있습니다. 내장된 ASF-ui 프론트엔드를 이용하거나, 독립형 웹 설정 생성기를 이용하거나, 수동으로 하는 방법이 있습니다. 이에 대해 환경설정 항목에서 깊게 설명하고 있으므로 더 자세한 정보를 원한다면 참고하십시오. 여기서는 독립형 웹 설정 생성기를 출발점으로 삼겠습니다. 어떤 이유로 ASF-ui가 시작되지 않거나 제대로 작동하지 않더라도 사용할 수 있기 때문입니다.

즐겨 쓰는 브라우저로 저희 웹 설정 생성기 페이지에 접속하세요. Chrome이나 Firefox를 권장하지만, 다른 용도로 문제없이 쓰는 브라우저라면 무엇이든 상관없습니다.

페이지를 연 후 "Bot" 탭으로 전환합니다. 아래와 비슷한 페이지를 볼 수 있습니다.

혹시라도 방금 다운로드한 ASF의 버전이 환경설정 생성기가 기본으로 사용하도록 설정된 버전보다 오래되었다면, 드롭다운 메뉴에서 사용중인 ASF 버전을 선택합니다. 이런 일은 (드물게) 발생할 수 있습니다. 설정 생성기는 아직 안정 버전으로 표시되지 않은 더 최신의 (사전 릴리스) ASF 버전용 설정을 생성하는 데에도 사용될 수 있기 때문입니다. 여러분은 안정적으로 작동하는 것이 검증된 최신 안정 릴리스를 내려받았으므로, 최첨단 버전보다 다소 오래되었을 수 있습니다. 최첨단 버전은 처음 사용하기에는 전혀 적합하지 않습니다.

빨간색으로 강조 표시된 Name 필드에 봇 이름을 입력하는 것부터 시작하세요. 이것은 별명, 계정명, 숫자 등등 당신이 사용하고 싶은 어떤 이름이라도 가능합니다. 사용할 수 없는 단 하나의 단어가 있습니다. ASF 는 일반 환경설정 파일로 예약된 키워드입니다. 추가로, 봇 이름은 마침표로 시작할 수 없습니다.(ASF는 이 파일을 내부적으로 무시합니다.) 공백은 사용하지 않으실 것을 권장하며, 필요하다면 _를 단어 구분자로 사용할 수 있습니다. 엄격한 요구 사항은 아니지만, 그렇지 않으면 ASF 명령을 사용할 때 어려움을 겪게 됩니다.

봇 이름을 정하셨나요? 좋습니다. 다음 단계로 Enabled 스위치를 켜 주세요. 이 설정은 (프로그램) 실행 후 ASF가 봇을 자동으로 시작할지 여부를 결정합니다. 이렇게 하지 않으면 ASF는 설정 파일에서 봇이 비활성화되어 있다고 표시하고 봇을 시작하라는 입력을 기다리게 되는데, 이 예시에서 저희가 원하는 동작이 아닙니다.

이제 다음으로 민감한 속성 두 가지가 나옵니다. SteamLogin과 SteamPassword입니다. 여기서 또 한 번 선택하실 수 있습니다. 이 두 속성에 Steam 로그인 정보를 입력할 수도 있고, 그렇게 하지 않고 비워 둘 수도 있습니다.

ASF는 자체적인 Steam 클라이언트 구현을 포함하고 있어 여러분이 직접 사용하는 것과 동일한 정보로 로그인해야 하므로 로그인 자격 증명을 필요로 합니다. 로그인 자격 증명은 (생성된 설정을 내려받은 후) 여러분 PC의 ASF config 디렉터리 외에는 어디에도 저장되지 않습니다. 저희 웹 설정 생성기는 클라이언트 기반 애플리케이션입니다. 즉, 독립형 설정 생성기 웹사이트에서 하는 모든 작업은 유효한 ASF 설정을 생성하기 위해 브라우저에서 로컬로 실행되며, 입력한 정보는 애초에 여러분의 PC를 벗어나지 않습니다. 따라서 민감한 데이터가 유출될 가능성을 걱정하실 필요가 없습니다. 그럼에도 어떤 이유로든 자격 증명을 입력하고 싶지 않으시다면 충분히 이해합니다. 나중에 생성된 파일에 직접 입력하셔도 되고, 아예 생략하고 그 없이 운영하셔도 됩니다.

자격 증명을 입력하기로 하셨다면 ASF가 시작 시 자동으로 로그인할 수 있게 되며, 선택 사항인 2FA와 함께 사용하면 사실상 프로그램을 더블 클릭하는 것만으로 모든 것이 실행됩니다. 생략하기로 하셨다면, ASF는 필요할 때마다 해당 정보를 입력하도록 요청합니다. 이 방식은 정보를 어디에도 저장하지 않지만, 당연히 여러분의 도움 없이는 ASF가 동작할 수 없습니다. 어느 쪽을 선호하실지는 여러분의 선택이며, 여느 때처럼 설정 섹션에서 추가 정보를 찾아보실 수 있습니다.

참고로 SteamPassword처럼 한 필드만 비워 두기로 하실 수도 있습니다. 그러면 ASF는 로그인 아이디는 자동으로 사용하되, 필요할 때 비밀번호를 요청합니다(Steam 클라이언트와 유사합니다). 혹시 4자리 자녀 보호 PIN으로 계정을 잠금 해제하고 계신다면 이를 SteamParentalPin 칸에 입력하시길 권장합니다. 다만 이 경우에도 그냥 비워 두고, 그 보호 수단이 얼마나 취약한지 확인해 보셔도 됩니다. ASF는 로그인 후 몇 초 만에 이를 직접 "크랙"할 수도 있기 때문입니다. 크흠...

위의 모든 내용을 따라 하셨다면, 다시 말해 봇 이름, enabled 스위치, 로그인 자격 증명까지 마치셨다면, 웹 페이지가 이제 아래와 비슷한 모습일 것입니다:

이제 "download" 버튼을 누르면 저희 웹 설정 생성기가 여러분이 선택한 이름을 바탕으로 새 json 파일을 생성합니다. 해당 파일을 이전 단계에서 zip 파일을 푼 폴더 안에 있는 config 디렉터리에 저장하세요.

축하합니다! 기본적인 ASF 봇 환경설정을 끝마쳤습니다. 살펴볼 것이 훨씬 더 많지만, 지금 필요한 것은 이게 전부입니다.

---

ASF 실행

이 순간을 기다리셨을 텐데요, 더 이상 붙잡아 둘 수 없겠네요. 이제 프로그램을 처음으로 실행할 준비가 되었습니다. ASF 디렉터리에서 ArchiSteamFarm 바이너리를 더블 클릭하기만 하면 됩니다. 콘솔에서 실행하실 수도 있습니다.

ASF가 수행하도록 프로그래밍된 동작들, 특히 기본적으로 저희 Steam 그룹에 가입하는 것처럼 여러분의 이름으로 수행되는 동작이 신경 쓰이신다면, 지금이 저희 원격 통신 섹션을 살펴보기 좋은 때입니다. 마음에 들지 않는 기능은 나중에 언제든 비활성화하실 수 있습니다. ASF는 단지 합리적인 기본값을 갖추고 있을 뿐이며, 저희는 사용자 대다수에게 적용되는 일반적인 사용 방식과 프로그램에 대한 저희의 원칙적인 관점을 바탕으로 어떤 결정을 내려야 했습니다.

모든 것이 잘 진행되었다면, 즉 첫 단계에서 필요한 종속성을 모두 설치하고 세 번째 단계에서 ASF를 설정하셨다면, ASF가 정상적으로 실행되어 첫 번째 봇을 인식하고 로그인을 시도할 것입니다:

ASF는 아마도 한 가지 정보를 더 요구할 것입니다. 계정에 접근하기 위한 2FA입니다(Steam Guard를 완전히 비활성화하셨다면 요구하지 않습니다). 화면의 안내를 따르기만 하면 됩니다. 인증기나 이메일에서 받은 코드를 입력하거나, 모바일 앱에서 확인 요청을 승인하시면 됩니다.

문제가 발생했나요?

ASF가 아예 시작되지 않고 콘솔 창도 뜨지 않음

.NET 사전 요구 사항이 없거나, 사용 중인 장비에 맞지 않는 ASF 변형을 내려받으셨을 것입니다. 무엇이 잘못되었는지 모르겠다면 저희 **FAQ**에서 정확한 문제를 찾을 방법이 있는지 확인해 보시고, 그래도 해결되지 않으면 저희 **지원**을 이용하세요.

정의된 봇이 없음

생성한 설정을 config 디렉터리에 넣지 않으셨습니다. 이 단계에서 흔히 하는 다른 실수로는 확장자를 .json에서 .txt 등으로 직접 바꾼 경우가 있습니다. 또한 일부 운영체제(예: Windows)는 기본적으로 일반적인 확장자를 숨기므로, 파일이 올바른 위치에 올바른 이름으로 있는지 확인하세요.

설정 파일에서 비활성화되어 있어 봇이 시작되지 않음

ASF가 봇을 자동으로 시작하도록 하는 Enabled 스위치를 켜는 것을 잊으셨습니다. 물론 의도한 것이라면 상관없지만, 그렇다면 이미 명령 실행 방법을 아실 테니 해당 메시지 이후 봇을 start하기만 하면 됩니다.

InvalidPassword

로그인 자격 증명이 잘못되었을 가능성이 높습니다. 생성된 설정에서 SteamLogin과 SteamPassword를 확인하고, 잘못되었다면 설정 단계로 돌아가 수정하세요. 그래도 문제가 계속된다면 동일한 로그인 자격 증명으로 본인의 Steam 클라이언트에 로그인해 보세요. 마찬가지로 로그인에 실패할 것이며, 이 방법으로 무엇이 잘못되었는지 더 많은 정보를 얻을 수도 있습니다.

모두 잘 되셨나요?

입력한 정보가 정확하다는 전제하에 초기 로그인 관문을 통과하면 성공적으로 로그인되며, ASF는 지금까지 여러분이 건드리지 않은 기본 설정으로 파밍을 시작합니다:

이는 ASF가 이제 여러분의 계정에서 성공적으로 작업을 수행하고 있다는 뜻이므로, 이제 프로그램을 최소화하고 다른 일을 하셔도 됩니다. 그렇게 하세요, 그럴 자격이 있으십니다. 적어도 좋아하는 음료를 다시 채워 오시는 건 어떨까요!

카드 파밍은 이 글만큼이나 긴 별도의 문서에서 다룰 주제이지만, 원리상으로는 충분한 시간이 지나면(**성능**에 따라 다릅니다) Steam 트레이딩 카드가 조금씩 드롭되는 것을 보게 됩니다. 물론 그러려면 파밍할 유효한 게임이 있어야 하며, **배지 페이지**에 "이 게임을 플레이하여 카드 X장을 더 획득할 수 있습니다"라고 표시되어야 합니다. 파밍할 게임이 없으면 ASF는 할 일이 없다고 알립니다. 이는 저희 **FAQ**에 설명되어 있으며, 이 시점에서 사람들이 가장 흔히 하는 질문, 즉 계정에 무려 14개나 되는 게임을 보유하고 있는데도 왜 ASF가 할 일이 없다고 하는지에 대한 답을 담고 있습니다 - 아니요, 버그가 아닙니다.

이것으로 아주 기본적인 설정 가이드를 마칩니다. 모든 RPG 게임이 그렇듯 여러분은 튜토리얼을 끝냈고, 이제 ASF 세계 전체를 탐험하도록 남겨 드립니다. 예를 들어 이제 ASF를 더 세부적으로 설정할지, 아니면 기본 설정 그대로 두고 알아서 동작하게 할지 결정하실 수 있습니다. 조금 더 읽고 싶으신 분들을 위해 몇 가지 기본적인 내용을 더 다룬 뒤, 나머지 위키 전체는 직접 발견하시도록 남겨 두겠습니다.

---

추가 환경설정

여러 계정 동시에 파밍하기

ASF는 한 번에 두 개 이상의 계정을 파밍할 수 있으며, 이것이 ASF의 주된 기능입니다. 몇 분 전에 첫 번째 설정 파일을 생성했던 것과 완전히 동일한 방식으로 봇 설정 파일을 더 만들어 ASF에 계정을 추가할 수 있습니다. 두 가지만 확인하시면 됩니다:

• 고유한 봇 이름. 첫 번째 봇 이름이 이미 MainAccount라면 같은 이름의 봇을 또 만들 수 없습니다.
• 유효한 로그인 정보. SteamLogin, SteamPassword, 그리고 SteamParentalCode(입력하기로 하신 경우)가 이에 해당합니다

다시 말해, 설정 단계로 다시 가서 두 번째, 세 번째 계정에 대해 똑같이 하시면 됩니다. 기존 설정을 덮어쓰지 않도록 모든 봇에 고유한 이름을 사용하는 것을 잊지 마세요.

---

설정 변경

저희 독립형 웹 설정 생성기에서도 기존 설정을 완전히 동일한 방식으로, 즉 새 설정 파일을 생성하여 변경합니다. "toggle advanced settings"를 클릭해 어떤 항목들이 있는지 살펴보세요. 이 예시에서는 CustomGamePlayedWhileFarming 설정을 변경해 보겠습니다. 이 설정을 사용하면 ASF가 파밍 중일 때 실제 게임 대신 사용자가 지정한 이름이 표시되도록 할 수 있습니다.

먼저 이를 조금 분석해 보겠습니다. ASF를 실행해 파밍을 시작하면, 기본 설정에서는 Steam 계정이 현재 게임 중인 상태로 표시됩니다:

당연한 일입니다. ASF가 방금 Steam 플랫폼에 해당 게임을 플레이 중이라고 알렸으니까요. 그래야 카드를 받을 수 있지 않겠습니까? 하지만 이것도 원하는 대로 바꿀 수 있습니다! 아직 하지 않으셨다면 고급 설정을 켜고 CustomGamePlayedWhileFarming을 찾으세요. 거기에 "카드 아이들링 중"처럼 표시하고 싶은 텍스트를 자유롭게 입력하기만 하면 됩니다:

이제 완전히 동일한 방식으로 새 설정 파일을 내려받은 뒤, 기존 설정 파일을 새 파일로 덮어쓰세요. 물론 기존 설정 파일을 삭제하고 그 자리에 새 파일을 넣으셔도 됩니다.

ASF는 상당히 똑똑해서 설정이 변경된 것을 인식하며, 프로그램을 재시작하지 않아도 이를 자동으로 반영해 적용합니다. 혹시 그렇게 되지 않는다면, 프로그램을 재시작해 새 설정이 반영되도록 하시면 됩니다. 그 후에는 ASF가 앞서 본 위치에 지정하신 텍스트를 표시하는 것을 확인하실 수 있습니다:

이는 설정을 성공적으로 편집하셨다는 뜻입니다. 완전히 동일한 방식으로 봇 탭에서 "ASF" 탭으로 전환한 뒤, 생성된 ASF.json 설정 파일을 내려받아 config 디렉터리에 넣으면 ASF 전역 속성도 변경할 수 있습니다.

ASF 설정 편집은 아래에서 더 자세히 설명할 ASF-ui 프론트엔드를 사용하면 훨씬 더 쉽게 하실 수 있습니다.

---

ASF-ui 사용하기

앞서 언급했듯이 ASF는 콘솔 앱이며 기본적으로 그래픽 사용자 인터페이스를 실행하지 않습니다. 다만 저희는 IPC 인터페이스에 대한 ASF-ui 프론트엔드를 활발히 개발하고 있으며, 이는 다양한 ASF 기능에 접근하는 매우 훌륭하고 사용자 친화적인 방법이 될 수 있습니다.

ASF-ui를 사용하려면 IPC가 활성화되어 있어야 합니다. 이는 기본 옵션이므로 직접 비활성화하지 않으셨다면 이미 활성화되어 있습니다. ASF를 실행하면 IPC 인터페이스가 자동으로 정상 시작되었는지 확인하실 수 있습니다:

간단히 말해 IPC는 ASF에 내장된 웹 서버로, 로컬 머신에서 시작되어 즐겨 쓰는 웹 브라우저로 ASF와 상호작용할 수 있게 해 줍니다. 정상적으로 시작되었다면 ASF가 실행 중인 동안 같은 머신에서 **이 링크**를 클릭해 ASF의 IPC 인터페이스에 접속할 수 있습니다. ASF-ui는 설정 파일을 직접 편집하거나 **명령**을 보내는 등 다양한 용도로 사용할 수 있습니다. ASF-ui의 모든 기능을 알아보실 수 있도록 자유롭게 둘러보세요.

---

요약

Steam 계정을 사용하도록 ASF를 성공적으로 설정하셨고, 취향에 맞게 어느 정도 사용자화도 마치셨습니다. 저희 가이드를 끝까지 따라오셨다면 ASF-ui 인터페이스를 통해 ASF를 조정하고 그 기능들을 탐색하기 시작하셨을 것입니다. 이것으로 튜토리얼을 마치지만, 관심 있으실 만한 내용에 대한 몇 가지 안내를 남겨 드립니다. 굳이 이름을 붙이자면 "사이드 퀘스트"라고 할 수 있겠네요:

• 저희 설정 섹션에서는 여러분이 본 다양한 설정들이 실제로 각각 무슨 일을 하는지, 그리고 ASF가 그 밖에 무엇을 제공할 수 있는지 설명합니다. 읽는 동안 수분 보충 잘 하시는 것만 잊지 마세요, 미리 경고해 드렸습니다.
• 문제가 발생했거나 일반적인 질문이 있으시다면 저희 **FAQ**를 참고해 보세요. 여러분이 겪을 수 있는 질문과 문제의 전부, 적어도 대부분을 다루고 있습니다.
• ASF에 관한 모든 것과 ASF가 어떻게 여러분의 삶을 편하게 해 줄 수 있는지 배우고 싶으시다면 **저희 위키**의 나머지 부분으로 가 보세요. 오른쪽 사이드바를 이용해 관심 있는 주제를 선택하세요.
• 마지막으로, 저희 프로그램이 유용하다고 느끼셨고 여기에 들어간 방대한 노력을 인정해 주신다면, 저희의 활동에 소액의 **후원**을 고려해 주실 수 있습니다. ASF는 애정으로 만든 결과물입니다. 저희는 지난 10년 넘게 여가 시간을 들여 이 경험을 여러분께 제공하기 위해 열심히 노력해 왔고, 이를 매우 자랑스럽게 생각합니다. 단 1달러라도 큰 힘이 되며, 여러분이 마음을 써 주신다는 표시가 됩니다. 아무쪼록 즐겁게 이용해 주세요!

---

일반 설치

이 부록은 ASF를 범용(generic) 변형으로 실행하도록 설정하려는 고급 사용자를 위한 것입니다. **OS별 변형**보다 사용하기 번거롭지만, 그만큼 추가적인 이점도 있습니다.

범용(generic) 변형은 주로 다음과 같은 경우에 사용하는 것이 좋습니다:

• 저희가 OS별 패키지를 빌드하지 않는 OS를 사용하는 경우(예: 32비트 Windows)
• 이미 .NET 런타임/SDK를 보유하고 있거나, 이를 설치해 사용하고자 하는 경우
• 런타임 요구 사항을 직접 처리하여 ASF의 구조 크기와 메모리 사용량을 최소화하려는 경우
• **플러그인**을 직접 사용하려는 경우로, 해당 플러그인이 (네이티브 종속성 누락으로 인해) 제대로 실행되려면 ASF의 범용(generic) 설정을 필요로 하는 경우

물론 원하는 다른 어떤 상황에서도 사용할 수 있지만, 위의 경우가 가장 합리적입니다.

다만 범용(generic) 설정에는 반전이 하나 있다는 점을 유의하세요. 이 경우 .NET 런타임을 여러분이 직접 관리해야 합니다. 즉, .NET SDK(런타임)를 사용할 수 없거나, 오래되었거나, 손상된 경우 ASF는 아예 작동하지 않습니다. 이것이 저희가 일반 사용자에게 이 설정을 전혀 권장하지 않는 이유입니다. 위에서처럼 ASF에 번들로 포함된 .NET 런타임이 이를 처리하도록 저희가 보장하는 것과 달리, 이제 여러분이 직접 .NET SDK(런타임)가 ASF 요구 사항에 맞고 ASF를 실행할 수 있는지 확인해야 하기 때문입니다.

범용(generic) 패키지의 경우 두 가지 사소한 변경 사항만 제외하면 OS별 가이드 전체를 그대로 따르시면 됩니다. .NET 사전 요구 사항을 설치하는 것에 더해 .NET SDK도 설치해야 하며, OS별 ArchiSteamFarm(.exe) 실행 파일을 내려받아 사용하는 대신 이제 범용(generic) ArchiSteamFarm.dll 바이너리만 내려받아 사용하게 됩니다. 그 외에는 모두 완전히 동일합니다.

추가 단계는 다음과 같습니다:

• **.NET 사전 요구 사항**을 설치합니다.
• 사용 중인 OS에 맞는 .NET SDK(또는 최소한 ASP.NET Core와 .NET 런타임)를 설치합니다. 설치 프로그램을 사용하시는 편이 좋습니다. 어떤 버전을 설치해야 할지 확실하지 않다면 **런타임 요구 사항**을 참고하세요.
• 일반적인(generic) 변형으로 **최신 ASF 릴리스**를 내려받습니다.
• 압축 파일을 새 위치에 풉니다.
• 위에서 설명한 것과 완전히 동일한 방식으로 **ASF를 설정**합니다.
• 헬퍼 스크립트를 사용하거나, 즐겨 쓰는 셸에서 dotnet /path/to/ArchiSteamFarm.dll을 직접 실행하여 ASF를 시작합니다.

ASF의 일반적인(generic) 변형에는 머신별 바이너리가 없습니다. 괜히 generic이라고 불리는 것이 아니니까요. 어디서든 작동할 수 있는 플랫폼 독립적 빌드이므로, 거기서 exe 파일을 기대하지 마세요.

그래서 저희는 ArchiSteamFarm.dll 바이너리 옆에 위치한 헬퍼 스크립트(Windows용 ArchiSteamFarm.cmd, Linux/macOS용 ArchiSteamFarm.sh)를 함께 제공하고 있습니다. dotnet 명령을 직접 실행하고 싶지 않다면 이 스크립트들을 사용하시면 됩니다.

당연하지만 .NET SDK를 설치하지 않아 PATH에 dotnet 실행 파일이 없다면 헬퍼 스크립트는 작동하지 않습니다. 또한 이 스크립트들은 전적으로 선택 사항입니다. 원하신다면 언제든 dotnet /path/to/ArchiSteamFarm.dll을 직접 실행하셔도 됩니다. 내부적으로 몇 가지 추가 조정이 들어갈 뿐, 이 스크립트들이 하는 일도 결국 그것이기 때문입니다.