Configuration ko KR

환경설정

이 페이지는 ASF 환경설정에 대한 내용입니다. 이는 config 디렉토리에 대한 완전한 설명이며, ASF를 당신의 입맛에 맞게 조정하게 해줍니다.

• 소개
• 웹 기반 환경설정 생성기(ConfigGenerator)
• ASF-ui 설정
• 수동 환경설정
• 일반 환경설정
• 봇 환경설정
• 파일 구조
• JSON 매핑
• 호환성 매핑
• 환경설정 호환성
• 자동 재시작

---

소개

ASF 환경설정은 두개의 주요 부분으로 나누어집니다. 일반(프로세스) 환경설정과 모든 봇의 환경설정입니다. 모든 봇은 각각 봇이름.json이라는 이름의 봇 환경설정 파일을 가집니다. 봇이름은 봇의 이름입니다. ASF 일반(프로세스) 설정은 ASF.json이라는 단일 파일입니다.

봇은 ASF 프로세스에 참여하는 단일 스팀 계정입니다. 정상적으로 작동하기 위해서 ASF는 최소한 하나 이상의 정의된 봇 인스턴스가 필요합니다. 프로세스가 강제하는 봇 인스턴스의 개수제한은 없습니다. 원하는 만큼 봇(스팀 계정)을 사용할 수 있습니다.

ASF는 환경설정 파일을 저장하기 위하여 JSON 형식을 사용합니다. 사람에게 친숙하고, 읽을 수 있으며 프로그램을 설정할 수 있는 가장 보편적인 형식입니다. 걱정하지 마십시오. ASF를 설정하기 위해 JSON을 알 필요는 없습니다. 어떤 종류의 bash 스크립트로 ASF 환경설정을 대량생성하길 원하는 경우가 있어서 언급했을 뿐입니다.

설정은 여러 방법으로 진행할 수 있습니다. 저희의 **Web 기반 ConfigGenerator**를 사용할 수 있으며, 이는 ASF와 독립적으로 실행되는 로컬 앱입니다. ASF 내에서 직접 설정을 진행할 수 있는 저희의 ASF-ui IPC 프론트엔드를 사용할 수도 있습니다. 마지막으로, 아래에 명시된 고정된 JSON 구조를 따르기만 하면 언제든지 설정 파일을 직접 수동으로 생성할 수도 있습니다. 사용 가능한 옵션들은 곧이어 설명드리겠습니다.

---

웹 기반 환경설정 생성기(ConfigGenerator)

저희 **Web 기반 ConfigGenerator**의 목적은 ASF 설정 파일 생성에 사용할 수 있는 사용자 친화적인 프론트엔드를 제공하는 것입니다. 웹 기반 환경설정 생성기는 100% 클라이언트 기반입니다. 즉 입력한 세부내용은 다른 어디로도 보내지지 않고 로컬에서만 처리된다는 뜻입니다. 이렇게 해서 보안성과 신뢰성을 보장할 수 있습니다. 모든 파일을 다운로드 받고 index.html 파일을 당신의 웹 브라우저에서 실행하면 오프라인 으로 작동할 수도 있습니다.

웹 기반 환경설정 생성기는 크롬과 파이어폭스에서 정상작동됨을 검증하였습니다. 또한 자바스크립트가 가능한 대부분의 유명한 웹 브라우저에서도 정상적으로 작동할 것입니다.

사용법은 매우 간단합니다. 적절한 탭을 선택해서 생성을 원하는 ASF 또는 봇 환경설정을 선택합니다. ASF 버전과 환경설정 파일의 버전이 맞는지 다시한번 확인 후, 모든 세부내용을 입력하고 "다운로드" 버튼을 누릅니다. 이 파일을 ASF의 config 디렉토리로 옮깁니다. 필요하다면 기존의 파일에 덮어쓰기 합니다. 매 최종수정마다 이를 반복합니다. 환경설정에서 가능한 옵션에 대한 설명은 이 섹션의 나머지 부분을 참고하십시오.

---

ASF-ui 설정

저희의 ASF-ui IPC 인터페이스로도 ASF를 설정할 수 있으며, 초기 설정을 생성한 이후 ASF를 다시 설정하려는 경우에는 더 우수한 방법입니다. Web 기반 ConfigGenerator가 설정을 정적으로 생성하는 것과 달리, 이 방식은 설정을 그 자리에서(in-place) 바로 수정할 수 있기 때문입니다.

ASF-ui를 사용하려면 저희 IPC 인터페이스가 활성화되어 있어야 합니다. IPC는 기본적으로 활성화되어 있으므로, 직접 비활성화하지 않는 한 바로 접근할 수 있습니다.

프로그램을 실행한 후, ASF의 **IPC 주소**로 이동하기만 하면 됩니다. 모든 것이 정상적으로 작동했다면, 그곳에서 ASF 설정도 변경할 수 있습니다.

---

수동 환경설정

일반적으로 저희 ConfigGenerator나 ASF-ui 중 하나를 사용하시길 강력히 권장합니다. 이 방법이 훨씬 쉽고 JSON 구조에서 실수하지 않도록 보장해주기 때문입니다. 하지만 어떤 이유로든 이를 원하지 않으신다면, 직접 수동으로 올바른 설정을 작성하실 수도 있습니다. 올바른 구조로 시작하려면 아래의 JSON 예시를 확인하세요. 해당 내용을 파일에 복사하여 설정의 기본 틀로 사용할 수 있습니다. 저희 프론트엔드를 전혀 사용하지 않으시는 경우, 설정 파일이 유효한지(valid) 확인하세요. ASF는 파싱할 수 없는 파일은 로드를 거부합니다. 유효한 JSON이라 하더라도, ASF가 요구하는 대로 모든 속성이 올바른 타입을 가지고 있는지도 반드시 확인해야 합니다. 모든 사용 가능한 필드의 올바른 JSON 구조에 대해서는, JSON 매핑 섹션과 아래의 문서를 참고하세요.

---

일반 환경설정

일반 환경설정은 ASF.json 파일에 들어있으며 다음과 같은 구조를 가집니다.

{
    "AutoRestart": true,
    "Blacklist": [],
    "CommandPrefix": "!",
    "ConfirmationsLimiterDelay": 10,
    "ConnectionTimeout": 90,
    "CurrentCulture": null,
    "Debug": false,
    "DefaultBot": null,
    "FarmingDelay": 15,
    "FilterBadBots": true,
    "GiftsLimiterDelay": 1,
    "Headless": false,
    "IdleFarmingPeriod": 8,
    "InventoryLimiterDelay": 4,
    "IPC": true,
    "IPCPassword": null,
    "IPCPasswordFormat": 0,
    "LicenseID": null,
    "LoginLimiterDelay": 10,
    "MaxFarmingTime": 10,
    "MaxTradeHoldDuration": 15,
    "MinFarmingDelayAfterBlock": 60,
    "OptimizationMode": 0,
    "PluginsUpdateList": [],
    "PluginsUpdateMode": 0,
    "ShutdownIfPossible": false,
    "SteamMessagePrefix": "/me ",
    "SteamOwnerID": 0,
    "SteamProtocols": 7,
    "UpdateChannel": 1,
    "UpdatePeriod": 24,
    "WebLimiterDelay": 300,
    "WebProxy": null,
    "WebProxyPassword": null,
    "WebProxyUsername": null
}

---

모든 옵션은 다음과 같습니다.

AutoRestart

bool 타입으로 기본값은 true입니다. 이 속성값은 필요할때 ASF가 자동으로 재시작할지를 정의합니다. UpdatePeriod 혹은 update 명령으로 수행되는 ASF업데이트나, ASF.json 환경설정 변경, restart 명령 등 ASF가 재시작을 필요로 하는 몇가지 이벤트가 있습니다. 일반적으로, 재시작은 두 부분으로 이루어져 있습니다. 새로운 프로세스의 생성과 현재 프로세스의 종료입니다. 대부분의 사용자는 이 속성을 기본값인 true로 유지하셔도 괜찮습니다. 하지만 직접 작성한 스크립트나 dotnet을 통해 ASF를 실행 중이라면, 프로세스 시작을 완전히 직접 제어하고 싶으실 수 있습니다. 예를 들어 새로 (재시작된) ASF 프로세스가 스크립트의 foreground가 아닌 백그라운드 어딘가에서 조용히 실행 중이고, 기존 ASF 프로세스와 함께 스크립트가 종료되어버리는 상황을 방지하고 싶을 때입니다. 새 프로세스가 더이상 직계 차일드 프로세스가 아니라는 사실이 특히 중요합니다. 표준 콘솔 입력을 사용하지 못할수도 있습니다.

이 경우 이 속성값을 false로 설정할 수 있습니다. 하지만 이 경우 프로세스를 재시작하는 것은 당신 이라는 것을 명심하십시오. 업데이트 후 등 새 프로세스를 낳는 대신 종료만 하는 것은 꽤 중요합니다. 당신이 추가한 논리구조가 없다면 당신이 다시 시작하기 전까지 작동을 멈출것입니다. ASF는 항상 성공(0) 또는 성공아님(0이외의 값) 등의 적절한 오류 코드를 가지고 종료합니다. 이렇게 해서 실패하는 경우 ASF를 자동으로 재시작하는 것을 방지하는 적절한 논리구조를 추가할 수 있고, 적어도 향후의 분석을 위한 log.txt을 작성합니다. restart 명령은 이 속성값이 어떻게 설정되어있는지와 상관없이 항상 ASF를 재시작함을 명심하십시오. 이 속성값은 기본 행동을 정의하지만 restart 명령은 항상 프로세스를 재시작합니다. 이 속성값을 비활성화할 이유가 있지 않다면 활성화 상태로 유지해야 합니다.

---

Blacklist

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. 이름에서 알 수 있듯, 이 전역(global) 설정 속성은 ASF의 자동 파밍 프로세스에서 완전히 무시할 appID(게임)를 정의합니다. 불행히도 Steam은 여름/겨울 할인 배지를 "카드 획득 가능"으로 분류하는 걸 좋아합니다. 이는 ASF 프로세스를 혼란시켜서 여름/겨울 할인 배지도 농사지어야 할 유효한 게임으로 믿게합니다. 어떠한 블랙리스트도 없다면 ASF는 실제로는 게임이 아닌 게임을 농사짓느라고 결국 매달려있을 것이고, 일어나지 않을 카드 획득을 무한히 기다릴 것입니다. ASF의 블랙리스트는 이러한 배지를 농사용이 아님으로 표시하여 어떤 것을 농사지을지 결정할때 이들을 조용히 무시하고 함정에 빠지지 않게 하려는 목적입니다.

ASF는 기본적으로 두 가지 블랙리스트를 포함합니다 – ASF 코드에 하드코딩되어 있어 수정이 불가능한 SalesBlacklist, 그리고 여기서 정의되는 일반 Blacklist입니다. SalesBlacklist는 ASF 버전과 함께 업데이트되며, 일반적으로 릴리스 시점 기준의 모든 "문제 있는(bad)" appID를 포함합니다. 따라서 최신 ASF를 사용 중이라면 여기서 정의하는 Blacklist를 별도로 직접 관리할 필요가 없습니다. 이 속성값의 주 목적은 ASF 릴리스 시점에 알려지지 않은 새로운 농사짓지 말아야 할 appID를 당신이 관리할 수 있게하는 것입니다. 하드코딩된 SalesBlacklist는 최대한 빠르게 업데이트되므로, 최신 ASF 버전을 사용 중이라면 직접 Blacklist를 업데이트할 필요는 없습니다. 하지만 Blacklist가 없다면, Valve가 새로운 세일 배지를 출시할 때 "계속 작동하도록" 하려면 ASF를 업데이트할 수밖에 없게 됩니다 – 저는 여러분이 항상 최신 ASF 코드를 사용하도록 강제하고 싶지 않으며, 그래서 어떤 이유로든 새 ASF 릴리스의 새로운 하드코딩된 SalesBlacklist로 업데이트하고 싶지 않거나 업데이트할 수 없는 상황에서도 기존 ASF를 계속 실행하고 싶을 때, 직접 ASF를 "고칠" 수 있도록 이 속성이 존재하는 것입니다. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

봇 단위(bot-based) 블랙리스트를 찾고 계시다면, fb, fbadd, fbrm **명령어**를 확인해보세요.

---

CommandPrefix

string 타입으로 기본값은 !입니다. 이 속성값은 ASF 명령어 에 사용되는 대소문자 구문이 필요한 접두사를 정의합니다. 즉, ASF가 당신의 말을 듣게하려면 모든 ASF 명령어의 앞에 이것을 붙여야 합니다. ASF의 명령어 접두사를 없애려고 이 값을 null 혹은 빈 값으로 설정하는 것도 가능합니다. 이 경우 명령어를 일반 식별자와 함께 입력해야 합니다. 하지만 ASF는 CommandPrefix 없이 시작하는 메시지를 파싱하는데 최적화되어있지 않아서 그렇게 하는 것은 ASF의 성능을 잠재적으로 줄이게 됩니다. 만약 의도적으로 접두사를 사용하지 않으려면 ASF는 ASF 명령어가 아니더라도 모든 메시지를 읽어서 응답해야 합니다. 따라서 기본값인 !가 싫다면 / 같은 어떤 명령어 접두사(CommandPrefix)를 계속 사용하는 것을 권장합니다. 일관성을 위하여 CommandPrefix는 ASF 프로세스 전체에 영향을 줍니다. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

ConfirmationsLimiterDelay

byte 타입으로 기본값은 10입니다. ASF는 등록제한이 걸리는 것을 피하기 위해 요청을 가져오는 두개의 연속된 2단계 인증 확인 사이에 적어도 ConfirmationsLimiterDelay초의 간격을 둡니다. 이는 ASF 2단계 인증 에서 2faok 명령어 등이나 다양한 거래관련 동작을 수행할 때 요청 기반으로 사용됩니다. 기본값은 테스트에 따라 설정되었으며 문제를 발생하려는 것이 아니면 이보다 낮춰서는 안됩니다. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

ConnectionTimeout

byte 타입으로 기본값은 90입니다. 이 속성값은 ASF가 수행하는 다양한 네트워크 활동의 타임아웃을 초단위로 정의합니다. 특히, ConnectionTimeout은 HTTP와 IPC 요청의 타임아웃을 정의하고, ConnectionTimeout / 10은 실패한 heartbeat 최대 숫자를, ConnectionTimeout / 30은 최초 Steam 네트워크 연결요청에 허용되는 분단위 숫자를 정의합니다. 기본값인 90은 대다수의 사용자에게 적합하지만, 네트워크 연결이나 PC 사양이 다소 느린 편이라면 이 수치를 더 높게(예: 120) 늘리는 것을 고려해볼 수 있습니다. 더 큰 값이 느리거나 혹은 접속이 불가능한 Steam 서버를 마술처럼 고치는 것은 아님을 명심하십시오. 일어나지 않을 일을 무한히 기다리지 않고 그냥 다음에 다시 시도할 것입니다. 이 값을 너무 높게 설정하면 네트워크 이슈를 탐지하는데 극도의 지연과 전체적인 성능 저하가 발생합니다. 이 값을 너무 낮게 설정하면 ASF가 파싱중인 유효한 요청도 취소하게되어 전체적인 안정성과 성능을 저하시킬 것입니다. 따라서 이 값을 기본값보다 낮게 설정하는 것은 일반적으로 아무런 이점이 없습니다. Steam 서버는 종종 매우 느려질 때가 있으며, ASF 요청을 처리하는 데 더 많은 시간이 필요할 수 있기 때문입니다. 기본값은 네트워크 연결이 안정적이라는 믿음과 Steam 네트워크가 우리의 요청을 주어진 타임아웃 내에 처리하지 못할 것이라는 의심 사이의 균형점입니다. 이슈를 더 빨리 탐지하고 ASF가 더 빨리 재연결/반응하길 원한다면 기본값이면 됩니다.(혹은 아주 살짝 낮은값, 60 정도면 ASF가 참을성이 약간 없어집니다.) 반대로 ASF가 요청 실패, heartbeat 손실, Steam 연결 끊김과 같은 네트워크 문제를 겪고 있다면, 이것이 여러분의 네트워크가 아니라 Steam 자체 문제라고 확신하는 경우 이 값을 늘리는 것이 합리적일 수 있습니다. 타임아웃을 늘리면 ASF가 더 "인내심 있게" 동작하여 바로 재연결을 시도하지 않게 되기 때문입니다.

이 속성을 늘려야 할 수 있는 예시 상황으로는, Steam이 완전히 수락하고 처리하는 데 족히 2분 이상 걸리는 매우 큰 거래 제안(trade offer)을 ASF가 처리해야 하는 경우가 있습니다. 기본 타임아웃을 증가시키면 ASF는 더 참을성이 있게되고 거래가 성사되지 않아서 최초 요청을 중단하는 결정을 하기 전에 더 오래 기다릴 것입니다.

또 다른 상황은 전송된 데이터를 처리하는데 더 많은 시간이 필요한 매우 느린 기기나 인터넷 연결로 인해 발생할 수 있습니다. 이는 매우 드문 경우로 CPU/네트워크 대역폭은 거의 보틀넥을 겪지 않지만 언급해둘 가능성은 여전히 있습니다.

요약하자면, 기본값은 대부분의 경우 적절하지만, 필요에 따라 늘릴 수도 있습니다. 하지만 타임아웃을 크게 잡는다고 해서 접속이 불가능한 Steam 서버를 마술처럼 고칠수는 없으므로 기본값보다 한참 크게하는 것은 의미가 없습니다. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

CurrentCulture

string 타입으로 기본값은 null입니다. ASF는 기본적으로 운영체제의 언어를 사용하려하고, 가능하다면 그 언어로 번역된 문자열을 사용합니다. 이는 ASF를 거의 모든 대중적 언어로 현지화 하려고 노력중인 커뮤니티 덕분에 가능합니다. 어떤 이유로든 OS를 모국어로 사용하고 싶지 않다면, 이 환경설정 속성값으로 대신 사용하길 원하는 유효한 언어를 고를 수 있습니다. 모든 가능한 국가 및 언어 리스트는 MSDN 을 방문하여 Language tag를 찾아보시기 바랍니다. ASF는 "en-GB"와 같은 특정 문화권(culture)뿐만 아니라 "en"과 같은 중립적인(neutral) 문화권도 모두 허용한다는 점을 참고하시면 좋습니다. 현재 문화권(culture)을 지정하면 통화/날짜 형식 등 문화권에 따라 달라지는 다른 동작에도 영향을 미칩니다. 네이티브가 아닌(non-native) 문화권을 선택하여 해당 언어 특유의 문자를 사용하는 경우, 이를 올바르게 표시하려면 추가 글꼴/언어 팩이 필요할 수 있다는 점을 참고하세요. 일반적으로 ASF를 모국어가 아니라 영어로 사용하려는 경우 이 속성값을 활용합니다.

---

Debug

bool 타입으로 기본값은 false입니다. 이 속성값은 프로세스를 디버그 모드에서 실행해야 하는 지를 정의합니다. 디버그 모드에서 ASF는 config 디렉토리 옆에 특별한 debug 디렉토리를 생성하여 ASF와 Steam 서버간의 모든 통신을 기록합니다. 디버그 정보는 네트워킹과 일반적인 ASF 작업흐름과 관련된 불쾌한 문제를 찾아내는데 도움이 됩니다. 또한, 일부 프로그램 루틴은 훨씬 더 자세해집니다. 예를 들어 WebBrowser는 일부 요청이 왜 실패하는지 정확한 이유를 표시하는데, 이 항목이 일반 ASF 로그에 기록됩니다. 개발자가 요청하지 않는 한 ASF를 디버그 모드로 실행하지 마십시오. ASF를 디버그 모드로 실행하면 성능 감소 및 안정성에 부정적 영향을 주고, 여러 곳에서 훨씬 더 자세해지므로 특정 이슈를 디버그하기 위해서 문제를 재생산하거나 요청 실패에 대한 더 많은 정보를 얻으려는 등 오직 의도했을때만 짧게 사용해야 합니다. 일반적 실행을 위해서는 사용하지 마십시오. 많은 새로운 오류, 이슈, 예외를 보게 될 것입니다. ASF, Steam과 이상행동을 모두 직접 분석하려면 이에 대한 충분한 지식이 있는지 확인하십시오.

경고: 이 모드를 활성화하면 (네트워크 로깅으로 인해) Steam 로그인에 사용하는 로그인 정보 및 비밀번호와 같은 잠재적으로 민감한 정보까지 로그에 기록됩니다. 해당 데이터는 debug 디렉터리와 표준 log.txt(이 정보를 기록하기 위해 의도적으로 훨씬 상세하게 기록되도록 되어 있음) 양쪽 모두에 기록됩니다. ASF가 생성한 debug 콘텐츠를 어떠한 공개된 장소에도 게시해서는 안 됩니다. ASF 개발자는 항상 이를 본인의 이메일이나 다른 보안이 확보된 장소로 전송하도록 안내할 것입니다. 저희는 이러한 민감한 정보를 저장하거나 활용하지 않습니다. 이는 여러분이 겪고 있는 문제와 관련이 있을 수 있기 때문에 debug 루틴의 일부로 기록될 뿐입니다. 가능하다면 ASF 로깅을 어떠한 방식으로도 변경하지 않으시길 권장드리지만, 걱정되신다면 해당 민감한 정보를 적절히 가려서(redact) 제공하셔도 무방합니다.

가리기(redact)한다는 것은 민감한 정보를 예를 들어 별표(*) 등으로 대체하는 것을 의미합니다. 민감한 줄을 아예 삭제하는 것은 자제해야 합니다. 해당 줄이 존재한다는 사실 자체가 문제와 관련이 있을 수 있으므로 보존되어야 하기 때문입니다.

---

DefaultBot

string 타입으로 기본값은 null입니다. 일부 시나리오에서 ASF는 특정 작업을 처리할 책임이 있는 "기본 봇(default bot)"이라는 개념으로 동작합니다 – 예를 들어 대상 봇을 지정하지 않았을 때의 IPC 명령이나 인터랙티브 콘솔의 경우가 그렇습니다. 이 속성은 이러한 시나리오를 처리할 기본 봇을 여기에 BotName을 입력하여 지정할 수 있게 해줍니다. 지정한 봇이 존재하지 않거나 기본값인 null을 사용하는 경우, ASF는 대신 알파벳순으로 정렬했을 때 가장 먼저 등록된 봇을 선택합니다. 일반적으로 이 설정 속성은 IPC 및 인터랙티브 콘솔 명령에서 [Bots] 인자를 생략하고, 이러한 호출에 대해 항상 동일한 봇을 기본값으로 사용하고 싶을 때 활용하게 됩니다.

---

FarmingDelay

byte 타입으로 기본값은 15입니다. ASF가 작동하려면, 현재 파밍 중인 게임에서 카드가 모두 드롭되었는지를 FarmingDelay분마다 확인합니다. 이 속성을 너무 낮게 설정하면 과도한 양의 Steam 요청이 전송될 수 있고, 반대로 너무 높게 설정하면 해당 타이틀이 완전히 파밍되었음에도 최대 FarmingDelay분 동안 ASF가 계속 "파밍 중"인 상태로 남아있을 수 있습니다. 기본값은 대부분의 사용자에게 충분히 적합하지만, 많은 봇을 운영 중이라면 전송되는 Steam 요청을 줄이기 위해 30분 정도로 늘리는 것을 고려해볼 수 있습니다. 참고로 ASF는 이벤트 기반(event-based) 방식을 사용하여 Steam 아이템이 드롭될 때마다 게임 배지 페이지를 확인하므로, 일반적으로 정해진 시간 간격으로 확인할 필요조차 없습니다. 하지만 Steam 네트워크를 완전히 신뢰하지는 않기 때문에, 최근 FarmingDelay분 동안 카드 드롭 이벤트를 통해 확인하지 못했다면(예: Steam 네트워크가 아이템 드롭을 제대로 알려주지 않은 경우 등) 어쨌든 게임 배지 페이지를 확인합니다. Steam 네트워크가 정상적으로 작동한다고 가정할 때, 이 값을 줄이더라도 파밍 효율은 전혀 개선되지 않으며, 오히려 네트워크 부하만 크게 증가시킵니다 – 필요한 경우 기본값인 15분에서 늘리는 것만 권장됩니다. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

FilterBadBots

bool 타입으로 기본값은 true입니다. 이 속성은 알려져 있고 악의적인 것으로 표시된 사용자(bad actor)로부터 받은 거래 제안을 ASF가 자동으로 거부할지 여부를 정의합니다. 이를 위해, ASF는 필요할 때마다 저희 서버와 통신하여 블랙리스트에 등록된 Steam 식별자 목록을 가져옵니다. 목록에 있는 봇들은 저희가 ASF 이니셔티브에 유해하다고 분류한 사람들이 운영하는 것으로, 저희의 **행동 강령**을 위반하거나, **PublicListing**과 같이 저희가 제공하는 기능 및 리소스를 악용하여 다른 사람을 착취하거나, 서버에 DDoS 공격을 가하는 등 노골적인 범죄 행위를 저지르는 경우 등이 포함됩니다. ASF는 전체 커뮤니티가 번창할 수 있도록 사용자 간의 전반적인 공정성, 정직성, 협력을 매우 중요하게 여기기 때문에, 이 속성은 기본적으로 활성화되어 있으며, 이에 따라 저희가 유해하다고 분류한 봇들은 제공되는 서비스에서 필터링됩니다. 저희의 입장에 동의하지 않아 의도적으로 이러한 봇들이 활동하도록(계정을 악용당하는 것까지 포함하여) 허용하려는 경우와 같이 강력한 이유가 없다면, 이 속성은 기본값으로 유지하셔야 합니다.

---

GiftsLimiterDelay

byte 타입으로 기본값은 1입니다. ASF는 등록제한이 걸리는 것을 피하기 위해 두개의 연속된 선물/키/라이센스 처리(등록) 요청 사이에 적어도 GiftsLimiterDelay초의 간격을 둡니다. 그 외에도, owns **명령어**에서 발생하는 것과 같은 게임 목록 요청에 대한 전역(global) 제한 장치로도 사용됩니다. 이 속성을 변경할 강력한 이유가 없다면, 기본값으로 유지하시는 것이 좋습니다.

---

Headless

bool 타입으로 기본값은 false입니다. 이 속성값은 프로세스를 headless 모드에서 실행해야 하는 지를 정의합니다. headless 모드일 때, ASF는 자신이 서버나 다른 비대화형(non-interactive) 환경에서 실행 중이라고 간주하며, 따라서 콘솔 입력을 통해 어떠한 정보도 읽으려고 시도하지 않습니다. 여기에는 필요 시 요청되는 세부정보(2FA 코드, SteamGuard 코드, 비밀번호 등 ASF 작동에 필요한 계정 자격 증명 및 기타 변수)뿐만 아니라, 인터랙티브 명령 콘솔과 같은 그 외 모든 콘솔 입력도 포함됩니다. 다시 말해, Headless 모드는 ASF 콘솔을 읽기 전용(read-only)으로 만드는 것과 동일합니다. 이 설정은 주로 서버에서 ASF를 운영하는 사용자에게 유용합니다. 예를 들어 2FA 코드를 요청하는 대신, ASF는 해당 계정을 정지시켜 작업을 조용히 중단하기 때문입니다. 서버에서 ASF를 운영 중이며 ASF가 non-headless 모드에서도 정상적으로 작동한다는 것을 사전에 확인한 경우가 아니라면, 이 속성은 비활성화된 상태로 유지하셔야 합니다. headless 모드에서는 모든 사용자 상호작용이 거부되며, 계정이 시작 중에 어떠한 콘솔 입력이라도 필요로 한다면 실행되지 않습니다. 이는 서버에 유용한데, 사용자가 자격 증명을 제공할 때까지 (무한정) 기다리는 대신, 자격 증명을 요구받았을 때 ASF가 계정 로그인 시도를 중단할 수 있기 때문입니다.

이 모드를 활성화하면 필요한 콘솔 입력을 다른 방법을 통해 제공할 수 있습니다. 예를 들면: ASF-ui(ASF API)를 통하거나, input 명령어를 통해서입니다. 이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 false로 두십시오.

---

IdleFarmingPeriod

byte 타입으로 기본값은 8입니다. ASF가 농사지을 것이 없다면 주기적으로 IdleFarmingPeriod 시간마다 계정에 새로운 농사지을 게임이 있는지 확인합니다. 이 기능은 우리가 갖게될 새 게임에 대해 이야기 할때는 필요없습니다. ASF는 배지 페이지를 자동으로 확인할 만큼 똑똑합니다. IdleFarmingPeriod는 주로 이미 갖고 있는 오래된 게임에 트레이딩 카드가 추가되는 경우를 위한 것입니다. 이경우 아무런 알림도 없어서 이것을 알기 위해서는 ASF가 주기적으로 배지 페이지를 확인해야 합니다. 0값은 이 기능을 비활성화 합니다. 다음도 함께 확인해보세요: FarmingPreferences의 ShutdownOnFarmingFinished 설정.

---

InventoryLimiterDelay

기본값이 4인 byte 타입입니다. ASF는 속도 제한(rate-limit)에 걸리지 않도록, 연속되는 두 웹 인벤토리 요청 사이에 최소 InventoryLimiterDelay초의 간격을 두도록 보장합니다 – 이는 예를 들어 인벤토리 알림을 읽음 처리할 때 사용되며, 다른 사용자의 인벤토리를 가져오는 서드파티 플러그인에서도 사용될 수 있습니다. 이 속성은 자신의 인벤토리를 가져올 때는 사용되지 않는데, ASF가 이를 위해 훨씬 더 효율적인 내부 네트워크 호출을 사용하기 때문입니다. 따라서 loot나 transfer와 같은 명령어에는 어떠한 영향도 미치지 않습니다. 기본값인 4는 100개 이상의 연속된 봇 인스턴스의 인벤토리를 읽음 처리하는 것을 기준으로 설정되었으며, 대부분(전부는 아니더라도)의 사용자를 만족시킬 것입니다. 하지만 봇의 수가 매우 적다면 이 값을 줄이거나 심지어 0으로 변경하고 싶으실 수 있습니다. 그러면 ASF는 딜레이를 무시하고 Steam 인벤토리를 훨씬 더 빠르게 읽음 처리합니다. 다만 이 값을 너무 낮게 설정하면 Steam이 여러분의 IP를 일시적으로 차단하게 됩니다, 그렇게 되면 어떠한 호출도 할 수 없게 되니 주의하세요. 많은 인벤토리 요청을 발생시키는 다수의 봇을 운영 중이라면 이 값을 늘려야 할 수도 있지만, 이런 경우에는 대신 해당 요청의 수 자체를 줄이는 방법을 시도해보시는 것이 좋습니다. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

IPC

bool 타입으로 기본값은 true입니다. 이 속성값은 ASF 프로세스와 함께 시작되는 IPC 서버를 정의합니다. IPC는 로컬 HTTP 서버를 구동함으로써, ASF-ui 사용을 포함한 프로세스 간 통신(inter-process communication)을 가능하게 합니다. 저희 ASF-ui를 포함하여 ASF와 연동되는 서드파티 IPC를 사용할 계획이 없다면, 이 옵션을 안전하게 비활성화할 수 있습니다. 그렇지 않다면, 활성화된 상태(기본 옵션)로 유지하는 것이 좋습니다.

---

IPCPassword

string 타입으로 기본값은 null입니다. 이 속성값은 IPC를 통해 이루어지는 모든 API 호출에 대한 필수 암호를 정의하고, 추가 보안수단으로 제공합니다. 빈 값이 아닌것으로 설정되면 모든 IPC 요청은 여기에 명시된 암호로 설정된 추가적인 password 속성값을 요구할 것입니다. 기본값인 null은 암호요구를 건너뛰어서 ASF가 모든 쿼리를 수행하도록 합니다. 그리고, 이 옵션을 활성화하면 내장된 IPC 대-무작위공격 메커니즘을 활성화합니다. 이는 매우 짦은 시간동안 너무 많은 승인되지 않은 요청이 있는 경우 특정 IP 주소를 일시적으로 차단합니다. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

IPCPasswordFormat

byte 타입으로 기본값은 0입니다. 이 속성은 IPCPassword 속성의 형식(format)을 정의하며, 내부적으로 EHashingMethod 타입을 사용합니다. 더 알아보고 싶으시다면 보안(Security) 섹션을 참고하세요. IPCPassword 속성이 실제로 일치하는 IPCPasswordFormat에 맞는 비밀번호를 포함하고 있는지 확인해야 하기 때문입니다. 다시 말해, IPCPasswordFormat을 변경하면 IPCPassword는 목표로만 삼는 것이 아니라 이미 해당 형식이어야 합니다. 무슨 일을 하고 있는지 알지 못한다면 기본값인 0을 유지하십시오.

---

LicenseID

기본값이 null인 Guid? 타입입니다. 이 속성은 저희 **스폰서(sponsor)**가 유료 리소스가 필요한 선택적 기능으로 ASF를 강화할 수 있게 해줍니다. 현재로서는, 이를 통해 ItemsMatcher 플러그인의 MatchActively 기능을 사용할 수 있습니다.

월간 및 일회성 등급을 제공하고, 완전 자동화와 즉시 접근이 가능한 GitHub 이용을 권장드리지만, 현재 이용 가능한 다른 모든 **후원 방법**도 지원합니다. 다른 방법으로 후원하여 특정 기간 동안 유효한 수동 라이선스를 받는 방법은 **이 게시물**을 참고하세요.

어떤 방법을 사용했든, ASF 스폰서(sponsor)라면 **여기**에서 라이선스를 발급받을 수 있습니다. 신원 확인을 위해 GitHub으로 로그인해야 하며, 읽기 전용(read-only)의 공개 정보인 사용자 이름(username)만 요청합니다. LicenseID는 f6a0529813f74d119982eb4fe43a9a24와 같이 32자리의 16진수 문자로 구성됩니다.

본인의 LicenseID를 다른 사람과 공유하지 않도록 주의하세요. 이는 개인 단위로 발급되므로, 유출될 경우 취소될 수 있습니다. 혹시라도 실수로 이런 일이 발생했다면, 같은 곳에서 새로 발급받을 수 있습니다.

추가적인 ASF 기능을 활성화하고 싶은 것이 아니라면, 라이선스를 발급받거나 제공할 필요는 없습니다.

---

LoginLimiterDelay

byte 타입으로 기본값은 10입니다. ASF는 등록제한이 걸리는 것을 피하기 위해 두개의 연속된 연결 시도 사이에 적어도 LoginLimiterDelay초의 간격을 둡니다. 기본값인 10은 100개 이상의 봇 인스턴스를 연결하는 것을 기준으로 설정되었으며, 대부분(전부는 아니더라도)의 사용자를 만족시킬 것입니다. 하지만 봇의 수가 매우 적다면 이 값을 늘리거나 줄이거나, 심지어 0으로 변경하고 싶으실 수 있습니다. 그러면 ASF는 딜레이를 무시하고 Steam에 훨씬 더 빠르게 연결됩니다. 다만 봇이 너무 많은 상태에서 이 값을 너무 낮게 설정하면 Steam이 여러분의 IP를 일시적으로 차단하게 됩니다. 그렇게 되면 InvalidPassword/RateLimitExceeded 오류와 함께 로그인 자체가 완전히 불가능해지며, 이는 ASF뿐만 아니라 일반 Steam 클라이언트에도 동일하게 적용됩니다. 마찬가지로, 특히 동일한 IP 주소를 사용하는 다른 Steam 클라이언트/도구와 함께 과도한 수의 봇을 운영 중이라면, 로그인을 더 긴 시간에 걸쳐 분산시키기 위해 이 값을 늘려야 할 가능성이 높습니다.

참고로, 이 값은 SendTradePeriod에서의 거래(trade)와 같이 ASF가 예약한(scheduled) 모든 작업에서 부하 분산(load-balancing) 버퍼로도 사용됩니다. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

MaxFarmingTime

byte 타입으로 기본값은 10입니다. 아시다시피 Steam이 항상 정상적으로 작동하는 것은 아니며, 실제로 게임을 플레이 중임에도 플레이타임이 기록되지 않는 등 이상한 상황이 발생할 수 있습니다. ASF는 한 게임을 솔로모드로 최대 MaxFarmingTime 시간동안 농사지을 것입니다. 그리고 그 후에는 완전히 농사를 지은것으로 간주합니다. 이는 이러한 이상 상황이 발생했을 때 파밍 프로세스가 멈추지 않도록 하기 위해 필요하며, Steam이 어떤 이유로든 ASF의 진행을 막는 새로운 배지를 출시한 경우(참고: Blacklist)에도 마찬가지입니다. 기본값인 10시간이면 한 게임의 모든 Steam 카드를 드롭하는 데 충분할 것입니다. 이 속성을 너무 낮게 설정하면 정상적인 게임이 건너뛰어질 수 있고(실제로 파밍에 최대 9시간까지 걸리는 정상적인 게임도 있습니다), 반대로 너무 높게 설정하면 파밍 프로세스가 멈출 수 있습니다. 이 속성은 하나의 파밍 세션에서 단일 게임에만 영향을 미치며(따라서 전체 대기열을 모두 거친 후 ASF는 해당 타이틀로 다시 돌아옵니다), 총 플레이타임이 아니라 ASF 내부의 파밍 시간을 기준으로 하므로, 재시작 이후에도 ASF는 해당 타이틀로 다시 돌아온다는 점을 참고하세요. 이 속성값을 변경해야 할 명확한 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

MaxTradeHoldDuration

byte 타입으로 기본값은 15입니다. 이 속성은 저희가 수용할 수 있는 거래 보류(trade hold)의 최대 기간(일 단위)을 정의합니다 – ASF는 거래(trading) 섹션에 정의된 대로 MaxTradeHoldDuration일을 초과하여 보류 중인 거래를 거부합니다. 이 옵션은 TradingPreferences가 SteamTradeMatcher로 설정된 봇에만 의미가 있으며, Master/SteamOwnerID 거래나 기부(donation)에는 영향을 미치지 않습니다. 거래 보류는 모두에게 성가신 존재이며, 누구도 이를 굳이 상대하고 싶어하지 않습니다. ASF는 관대한 규칙에 따라 작동하며 거래 보류 여부와 관계없이 모두를 돕는 것을 지향합니다 – 그래서 이 옵션은 기본적으로 15로 설정되어 있습니다. 하지만 거래 보류의 영향을 받는 모든 거래를 거부하고 싶으시다면, 여기에 0을 지정하시면 됩니다. 거래(trading) 섹션에서 설명한 것처럼, 수명이 짧은 카드는 이 옵션의 영향을 받지 않으며 거래 보류 중인 사용자에 대해 자동으로 거부되므로, 그것 때문에 모든 사용자를 전체적으로 거부할 필요는 없다는 점을 참고하세요. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

MinFarmingDelayAfterBlock

byte 타입으로 기본값은 60입니다. 이 속성은, 현재 파밍 중인 ASF를 게임을 실행하여 강제로 연결 해제시켰을 때 발생하는 LoggedInElsewhere로 인해 이전에 연결이 끊긴 경우, 카드 파밍을 재개하기 전까지 ASF가 대기할 최소 시간(초 단위)을 정의합니다. 이 딜레이는 주로 편의성 및 오버헤드 문제로 존재합니다. 예를 들어, playing lock이 순간적으로 풀렸다는 이유만으로 ASF가 다시 계정을 점유해버려 이와 충돌하지 않고도 게임을 재시작할 수 있게 해줍니다. 세션을 다시 가져오면 LoggedInElsewhere 연결 해제가 발생하기 때문에, ASF는 전체 재연결 절차를 다시 거쳐야 하며, 이는 기기와 Steam 네트워크에 추가적인 부담을 줍니다. 따라서 가능하다면 추가적인 연결 해제를 피하는 것이 바람직합니다. 기본적으로 이 값은 60초로 설정되어 있으며, 큰 번거로움 없이 게임을 재시작하기에 충분한 시간입니다. 하지만 이 값을 늘리는 것이 유용한 경우도 있습니다. 예를 들어 네트워크 연결이 자주 끊기고 ASF가 너무 빨리 계정을 다시 점유해버려서, 결국 여러분이 직접 재연결 과정을 다시 거쳐야 하는 상황이 발생할 수 있습니다. 이 속성에는 최대 255까지 설정할 수 있으며, 이는 일반적인 모든 상황에 충분한 값입니다. 위 내용에 더해, 딜레이를 줄이거나 0 값을 사용해 아예 없앨 수도 있지만, 앞서 언급한 이유들로 인해 일반적으로는 권장하지 않습니다. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

OptimizationMode

byte 타입으로 기본값은 0입니다. 이 속성은 런타임 중 ASF가 선호할 최적화 모드를 정의합니다. 현재 ASF는 두 가지 모드를 지원합니다 – MaxPerformance라고 불리는 0, 그리고 MinMemoryUsage라고 불리는 1입니다. 기본적으로 ASF는 가능한 한 많은 작업을 병렬(동시에)로 실행하는 것을 선호하며, 이는 모든 CPU 코어, 다중 CPU 스레드, 다중 소켓, 다중 스레드풀 작업에 걸쳐 작업을 부하 분산함으로써 성능을 향상시킵니다. 예를 들어, ASF는 파밍할 게임을 확인할 때 첫 번째 배지 페이지를 요청하고, 요청이 도착하면 실제로 몇 개의 배지 페이지가 있는지 읽어들인 다음, 나머지 페이지들을 동시에 요청합니다. 대부분의 경우 오버헤드가 미미하고, ASF의 비동기(asynchronous) 코드로 인한 이점은 CPU 코어가 하나뿐이고 성능이 크게 제한된 매우 오래된 하드웨어에서도 확인할 수 있으므로, 거의 항상 이 방식을 원하시게 될 것입니다. 하지만 많은 작업이 병렬로 처리되는 동안, ASF 런타임은 소켓을 열린 상태로 유지하고 스레드를 살아있게 하며 작업이 처리되도록 하는 등 이를 유지 관리해야 하며, 이로 인해 때때로 메모리 사용량이 증가할 수 있습니다. 사용 가능한 메모리가 극도로 제한되어 있다면, 이 속성을 1(MinMemoryUsage)로 전환하여 ASF가 최대한 적은 작업만 사용하도록 강제하고, 병렬로 처리 가능한 비동기 코드를 일반적으로 동기(synchronous) 방식으로 실행하게 할 수 있습니다. 이 속성은 **저메모리 설정(low-memory setup)**을 사전에 읽어보셨고, 매우 적은 메모리 오버헤드 감소를 위해 의도적으로 큰 성능 향상을 포기하고자 하는 경우에만 전환을 고려하셔야 합니다. 일반적으로 이 옵션은 훨씬 더 나쁜 결과를 보이는데, **저메모리 설정(low-memory setup)**에서 설명한 것처럼 ASF 사용량을 제한하거나 런타임의 가비지 컬렉터를 튜닝하는 등의 다른 방법으로 달성할 수 있는 결과에 비해 그렇습니다. 따라서 MinMemoryUsage는 다른 (훨씬 더 나은) 옵션들로 만족스러운 결과를 얻지 못했을 때, 런타임을 다시 컴파일하기 직전의 최후의 수단으로만 사용하셔야 합니다. 이 속성을 변경할 강력한 이유가 없다면, 기본값으로 유지하시는 것이 좋습니다.

---

PluginsUpdateList

ImmutableHashSet<string> 타입으로 기본값은 비어있습니다. 이 속성은 아래에 정의된 PluginsUpdateMode에 따라, 자동 업데이트 대상으로 고려될 때 블랙리스트 또는 화이트리스트로 처리될 플러그인 어셈블리 이름 목록을 정의합니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

PluginsUpdateMode

byte 타입으로 기본값은 0입니다. 이 속성은 위에 정의된 PluginsUpdateList에 의미를 부여하는 플러그인 업데이트 모드를 정의합니다. 이 속성을 지정하면 선언된 항목을 제외한 모든 플러그인의 자동 업데이트를 손쉽게 활성화/비활성화할 수 있습니다.

• 값 0은 Whitelist라고 불리며, PluginsUpdateList에 정의된 항목을 제외한 모든 플러그인의 자동 업데이트를 비활성화합니다.
• 값 1은 Blacklist라고 불리며, PluginsUpdateList에 정의된 항목을 제외한 모든 플러그인의 자동 업데이트를 활성화합니다.

ASF 팀은 여러분의 안전을 위해, 신뢰할 수 있는 곳에서 제공하는 플러그인에 대해서만 자동 업데이트를 활성화하시길 다시 한번 안내드립니다. 악성 플러그인은 이 설정과 무관하게 스스로를 업데이트하거나 원격 명령을 실행할 수 있다는 점을 유의하세요. 이러한 이유로 이 설정은 오직 ASF가 제공하는 플러그인 업데이트 기능에만 적용되며, 사용하기로 결정한 모든 플러그인을 적절히 검증했는지는 여전히 직접 확인하셔야 합니다.

플러그인 업데이트는 기본적으로 ASF 업데이트 루틴인 UpdateChannel 및 **UpdatePeriod**와 함께 수행됩니다. update 명령어와 같은 표준 ASF 업데이트 메커니즘도 선택적 플러그인 업데이트를 함께 트리거합니다. 대신 ASF 버전을 함께 업데이트하지 않고 플러그인만 수동으로 업데이트하고 싶다면, updateplugins 명령어를 통해 이를 수행할 수 있습니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

ShutdownIfPossible

bool 타입으로 기본값은 false입니다. 활성화하면, ASF는 가능한 경우 – 즉 등록된 모든 봇이 정지된 경우 – 프로세스를 종료하려고 시도합니다. 모든 봇 인스턴스에 ShutdownOnFarmingFinished를 함께 적용하면 특히 유용할 수 있습니다. 마지막 봇의 파밍이 끝났을 때 ASF가 자동으로 종료될 수 있기 때문입니다.

대다수의 사용자는 예를 들어 IPC 사용 등을 위해 프로세스가 항상 실행 중이길 기대하므로, 이 옵션은 기본적으로 비활성화되어 있습니다.

---

SteamMessagePrefix

string 타입으로 기본값은 "/me "입니다. 이 속성값은 ASF가 보내는 모든 Steam 메시지에 붙는 접두사를 정의합니다. ASF는 기본적으로 "/me " 접두사를 사용하여 Steam 대화에서 봇 메시지를 다른 색으로 표시하여 구별하기 쉽도록 합니다. "/pre " 접두사도 비슷한 효과를 내지만 다른 형식을 가지고 있습니다. 접두사를 완전히 사용하지 않고 모든 ASF 메시지를 전통적 방식으로 보내려면 이 속성값을 빈 문자열이나 null로 설정할 수도 있습니다. 이 속성값은 Steam 메시지에만 영향을 줍니다. IPC와 같은 다른 채널을 통해 돌아오는 응답은 영향을 받지 않습니다. 기본 ASF 행동을 변경하고 싶지 않다면 기본값 그대로 두는것도 좋은 생각입니다.

---

SteamOwnerID

ulong 타입으로 기본값은 0입니다. 이 속성값은 ASF 프로세스 소유자의 64비트 형태로 된 Steam ID를 정의합니다. 봇 인스턴스(일반 환경설정이 아닙니다)의 주인(Master) 권한과 매유 유사합니다. 이 속성값은 당신 자신의 메인 Steam 계정의 ID로 설정합니다. 주인(Master) 권한은 봇 인스턴스에 대한 전체 제어를 갖지만, exit, restart 또는 update 같은 일반 환경의 명령어는 SteamOwnerID 전용입니다. 이는 예를 들어 친구들을 위해 봇을 실행하면서도, exit 명령어로 프로세스를 종료하는 등 ASF 프로세스를 직접 제어하지는 못하게 하고 싶을 때 편리합니다. 기본값인 0은 ASF 프로세스의 소유자가 없다는 것으로, 일반 ASF 명령을 누구도 실행할 수 없다는 뜻입니다. 이 속성은 Steam 채팅에만 적용된다는 점을 유의하세요. **IPC**와 인터랙티브 콘솔에서는 이 속성이 설정되어 있지 않더라도 여전히 Owner 명령어를 실행할 수 있습니다.

---

SteamProtocols

byte flags 타입으로 기본값은 7입니다. 이 속성값은 ASF가 Steam 서버에 접속할때 사용할 Steam 프로토콜을 정의합니다. 정의는 아래와 같습니다.

값	이름	설명
0	없음(None)	프로토콜 없음
1	TCP	Transmission Control Protocol
2	UDP	User Datagram Protocol
4	WebSocket	WebSocket

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 알아보고 싶으시다면 **JSON 매핑**을 확인해보세요. 어떤 플래그도 활성화하지 않으면 없음(None) 옵션과 동일하며, 이는 유효하지 않은 값입니다.

기본적으로 ASF는 다운타임(downtime) 및 이와 유사한 Steam 문제에 대응하기 위한 수단으로 사용 가능한 모든 Steam 프로토콜을 사용합니다. 일반적으로 ASF가 하나 또는 두 개의 특정 프로토콜만 사용하도록 제한하고 싶을 때 이 속성을 변경하게 됩니다. 이러한 조치는 다양한 상황에서 필요할 수 있습니다. 예를 들어 방화벽에서 UDP 트래픽을 차단하고 TCP 트래픽만 통과하도록 하고 싶은 경우, 혹은 WebProxy를 사용 중이며 이를 Steam 클라이언트 연결에도 사용하고 싶은 경우입니다(이는 WebSocket 프로토콜에서만 지원됩니다).

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

UpdateChannel

byte 타입으로 기본값은 1입니다. 이 속성값은 자동 업데이트(UpdatePeriod 가 0보다 큰 경우)나 업데이트 알림에서 사용할 업데이트 채널을 정의합니다. 현재 ASF는 세 가지 업데이트 채널을 지원합니다 – None이라고 불리는 0, Stable이라고 불리는 1, 그리고 PreRelease라고 불리는 2입니다. 안정(Stable) 채널은 기본 릴리스 채널로, 대부분의 사용자가 사용해야 합니다. PreRelease 채널은 Stable 릴리스뿐만 아니라, 새로운 기능을 테스트하고 버그 수정을 확인하거나 예정된 개선 사항에 대한 피드백을 제공하기 위한 고급 사용자 및 기타 개발자 전용의 pre-release도 포함합니다. PreRelease versions often contain unpatched bugs, work-in-progress features or rewritten implementations. If you don't consider yourself advanced user, please stay with default 1 (Stable) update channel. PreRelease channel is dedicated to users who know how to report bugs, deal with issues and give feedback - no technical support will be given. 더 알고 싶다면 ASF의 릴리스 주기 를 참고하십시오. 모든 버전확인을 완전히 제거하고 싶다면 UpdateChannel을 0(없음(None))으로 설정할 수도 있습니다. UpdateChannel을 0으로 설정하면 update 명령을 포함한 업데이트와 관련된 모든 기능을 모두 비활성화합니다. 아래의 UpdatePeriod 설명에서 언급하는 모든 종류의 문제에 노출되므로 없음(None) 채널은 하지 않기를 강력하게 권고합니다.

지금 하고 있는 것이 뭔지 알고 있지 않다면, 기본값 그대로 두는 것을 강력하게 권장합니다.

---

UpdatePeriod

byte 타입으로 기본값은 24입니다. 이 속성값은 자동 업데이트를 위해 ASF가 얼마나 자주 확인할지를 정의합니다. 업데이트는 새로운 기능과 심각한 보안 패치를 받기위해서 뿐 아니라 버그수정, 성능개선, 안정성 향상 등을 위해서도 중요합니다. 0보다 큰 값이 설정되면 ASF는 새로운 업데이트가 나오면 자동으로 다운로드받아 교체하고 재시작(AutoRestart가 허용된 경우)합니다. 이렇게 하기 위해서 ASF는 매 UpdatePeriod 시간마다 새 업데이트가 GitHub repo에 있는지 확인합니다. 0 값은 자동 업데이트를 비활성화 합니다. 하지만 수동으로 update 명령을 실행할 수는 있습니다. You may also be interested in setting appropriate UpdateChannel that UpdatePeriod should follow.

Update process of ASF involves update of entire folder structure that ASF is using, but without touching your own configs or databases located in config directory - this means that any extra files unrelated to ASF in its directory can be lost during update. 기본값인 24는 불필요한 확인과 충분히 새제품간의 적절한 균형점입니다.

이 속성값을 비활성화할 명확한 이유가 있지 않다면 당신 자신을 위해서 합리적인 UpdatePeriod 기간으로 자동 업데이트를 활성화상태로 유지해야 합니다. 우리는 최신의 안정 ASF 릴리스만 지원하며, 최신 버전에만 보안성을 보장하기 때문입니다. 만약 오래된 ASF 버전을 사용한다면, 작은 버그부터 기능 깨짐, 종국에는 영구적인 Steam 계정 정지 까지 온갖 종류의 이슈에 일부러 노출하는 것입니다. 그러므로 자신을 위해서 항상 ASF를 최신버전으로 업데이트할 것을 강력하게 권장합니다. 자동 업데이트는 문제가 되는 코드를 일이 커지기 전에 비활성화 하거나 패치하여 모든 종류의 이슈에 빠르게 대응할 수 있게 합니다. 하지 않겠다면 모든 보안성 보장을 버리고 Steam 네트워크 뿐 아니라 자신의 Steam 계정에도 잠재적으로 해로울 수 있는 코드를 실행하는 위험을 감수하는 것입니다.

---

WebLimiterDelay

ushort 타입으로 기본값은 300입니다. 이 속성값은 동일한 Steam 웹서비스에 전송한 두개의 연속한 요청간의 최소 지연시간을 밀리초 단위로 정의합니다. 이 지연은 주어진 시간에 보내진 요청의 전체 건 수에 따른 등록 활성화 제한을 포함해서 Steam이 내부적으로 사용하는 AkamaiGhost 서비스의 형태로 필요합니다. 보통 상황에서 akamai 차단은 잘 일어나지 않지만, 거대하고 지속적인 일련의 요청으로 매우 부하가 심하다면 매우 짧은 시간동안 매우 많은 요청을 보내는 경우 차단이 작동할 가능성이 있습니다.

기본값은 ASF가 steamcommunity.com, api.steampowered.com 그리고 store.steampowered.com와 같은 Steam 웹서비스에 접근하는 유일한 도구라고 가정하고 설정하였습니다. 동일한 웹서비스에 요청을 보내는 다른 도구를 사용중이라면 그 도구에 WebLimiterDelay와 유사한 기능이 있는지를 확인하고, 양 쪽 모두를 기본값의 두배인 600 정도로 설정하여야 합니다. 이렇게 하면 어떤 경우에서건 한개의 요청이 300 ms을 넘지 않을 것입니다.

In general, lowering WebLimiterDelay under default value is strongly discouraged as it could lead to various IP-related blocks, some of which are possible to be permanent. 기본값은 서버에서 단일 ASF 인스턴스를 실행하는데도 충분하고, 원본 Steam 클라이언트와 함께 ASF를 정상적인 시나리오대로 사용하는데도 충분합니다. It should be correct for majority of usages, and you should only increase it (never lower it). 즉, 단일 IP에서 단일 Steam 도메인으로 보내지는 모든 요청의 전체 숫자는 절대 300 ms 당 1개 요청을 초과해서는 안됩니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

WebProxy

string 타입으로 기본값은 null입니다. This property defines a web proxy address that will be used for internal http-related communication, especially to services such as github.com, api.steampowered.com, steamcommunity.com and store.steampowered.com. It applies to general (non-bot specific) communication, as well as bot-specific communication if their equivalent WebProxy configuration property is not set. Proxying ASF requests could be exceptionally useful for bypassing various kinds of firewalls, especially the great firewall in China.

이 속성값은 아래와 같은 uri 문자열로 정의됩니다.

A URI string is composed of a scheme (supported: http/https/socks4/socks4a/socks5), a host, and an optional port. 다음은 완전한 uri 문자열의 예시입니다. "http://contoso.com:8080".

프록시가 인증을 필요로 하면, WebProxyUsername과 WebProxyPassword를 설정해야 합니다. 그럴 필요가 없다면 이 속성값을 설정하는 것만으로 충분합니다.

If you require proxying internal Steam network communication (CMs) as well, then you should ensure to configure SteamProtocols bot's property to a value that allows only websocket transport, i.e. a value of 4, as only websockets are supported for proxying.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

WebProxyPassword

string 타입으로 기본값은 null입니다. 이 속성값은 프록시 기능을 제공하는 대상 WebProxy 기기에서 지원하는 기본, digest, NTLM, Kerberos 인증에 사용되는 암호 필드를 정의합니다. 프록시가 사용자 자격증명을 필요로 하지 않는다면 여기에 아무것도 넣을 필요가 없습니다. WebProxy가 사용될 때 이 옵션의 사용도 의미가 있고, 그외에는 효과가 없습니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

WebProxyUsername

string 타입으로 기본값은 null입니다. 이 속성값은 프록시 기능을 제공하는 대상 WebProxy 기기에서 지원하는 기본, digest, NTLM, Kerberos 인증에 사용되는 사용자이름 필드를 정의합니다. 프록시가 사용자 자격증명을 필요로 하지 않는다면 여기에 아무것도 넣을 필요가 없습니다. WebProxy가 사용될 때 이 옵션의 사용도 의미가 있고, 그외에는 효과가 없습니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

봇 환경설정

당신이 이미 알다시피, 모든 봇은 자신만의 설정을 가지고 있어야 합니다. 아래는 기본이 되는 JSON구조의 예시입니다. 1.json, main.json, primary.json 또는 AnythingElse.json 등 봇의 이름을 짓는 것부터 시작해서 환경설정으로 넘어갑니다.

주의: 봇은 ASF로 명명할 수 없습니다. ASF는 일반 환경설정을 위한 예약키워드입니다. 또한 점(.)으로 시작하는 모든 환경설정 파일을 무시합니다.

봇 환경설정은 아래와 같은 구조를 갖습니다.

{
    "AcceptGifts": false,
    "BotBehaviour": 0,
    "CompleteTypesToSend": [],
    "CustomGamePlayedWhileFarming": null,
    "CustomGamePlayedWhileIdle": null,
    "Enabled": false,
    "FarmingOrders": [],
    "FarmingPreferences": 0,
    "GamesPlayedWhileIdle": [],
    "GamingDeviceType": 1,
    "HoursUntilCardDrops": 3,
    "LootableTypes": [1, 3, 5],
    "MachineName": null,
    "MatchableTypes": [5],
    "OnlineFlags": 0,
    "OnlineStatus": 1,
    "PasswordFormat": 0,
    "RedeemingPreferences": 0,
    "RemoteCommunication": 3,
    "SendTradePeriod": 0,
    "SteamLogin": null,
    "SteamMasterClanID": 0,
    "SteamParentalCode": null,
    "SteamPassword": null,
    "SteamTradeToken": null,
    "SteamUserPermissions": {},
    "TradeCheckPeriod": 60,
    "TradingPreferences": 0,
    "TransferableTypes": [1, 3, 5],
    "UseLoginKeys": true,
    "UserInterfaceMode": 0,
    "WebProxy": null,
    "WebProxyPassword": null,
    "WebProxyUsername": null
}

---

모든 옵션은 다음과 같습니다.

AcceptGifts

bool 타입으로 기본값은 false입니다. 활성화 되어있으면 ASF는 자동으로 봇으로 보내지는 모든 Steam 선물(월렛 기프트카드 포함)을 수락하고 등록합니다. SteamUserPermissions에서 정의된 사용자 이외의 사용자가 보낸 선물도 포함됩니다. 이메일 주소로 보낸 선물은 클라이언트로 직접 전달되지 않음을 명심하십시오. ASF는 당신의 도움 없이는 그것을 받을 수 없습니다.

이 옵션은 부계정에 권장합니다. 주 계정에 모든 선물을 자동으로 등록하지는 않기 때문입니다. 이 기능을 사용할지 아닐지 불확실하다면 기본값인 false를 유지하십시오.

---

BotBehaviour

byte flags 타입으로 기본값은 0입니다. 이 속성값은 다양한 이벤트 발생시 ASF 봇의 행동을 아래와 같이 정의합니다.

값	이름	설명
0	없음(None)	No special bot behaviour, sane default settings
1	유효하지 않은 친구초대 거절(RejectInvalidFriendInvites)	ASF는 유효하지 않은 친구 초대를 거절합니다.(무시 아님)
2	유효하지 않은 거래 거절(RejectInvalidTrades)	ASF는 유효하지 않은 거래 제안을 거절합니다.(무시 아님)
4	유효하지 않은 그룹 초대 거절(RejectInvalidGroupInvites)	ASF는 유효하지 않은 그룹 초대를 거절합니다.(무시 아님)
8	보관함 알림 해제(DismissInventoryNotifications)	ASF가 모든 보관함 알림을 자동으로 해제합니다.
16	받은 메시지 읽은상태로 표시(MarkReceivedMessagesAsRead)	ASF가 모든 도착한 메시지를 자동으로 읽은 상태로 표시합니다.
32	MarkBotMessagesAsRead	Will cause ASF to automatically mark messages from other ASF bots (running in the same instance) as read
64	DisableIncomingTradesParsing	Will cause ASF to never process incoming trade offers

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. Check out json mapping if you'd like to learn more. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

In general you want to modify this property if you expect to change various automation settings related to bot's activity. The default settings involve ASF running in non-invasive mode, which enables only beneficial automation that does not go against user's will.

유효하지 않은 친구 초대는 SteamUserPermissions에 정의된 가족 공유(FamilySharing) 이상의 권한을 가진 사용자가 아닌 사람으로 부터 온 친구 초대입니다. 예상하시는 대로 보통 모드에서 ASF는 이 초대를 무시하고 이를 받아들일지 말지 선택권을 당신에게 줍니다. 유효하지 않은 친구초대 거절(RejectInvalidFriendInvites)은 이러한 초대를 자동으로 거절합니다. 따라서 실제적으로 다른 사람들이 당신을 친구 리스트에 추가하는 옵션을 막습니다. 당신이 SteamUserPermissions에 정의한 사람들을 제외하고 그런 요청을 모두 거부합니다. 모든 친구 초대를 완전히 거부하려는 것이 아니라면 이 옵션을 활성화해서는 안됩니다.

유효하지 않은 거래 제안은 내장된 ASF 모듈에서 수락되지 않는 제안입니다. ASF가 자동으로 수락하려고 하는 거래 형식의 명시적 정의는 거래 항목을 참고하시기 바랍니다. 유효한 거래는 다른 설정, 특히 TradingPreferences에도 정의되어 있습니다. RejectInvalidTrades는 모든 유효하지 않은 거래 제안을 무시하는 대신 거부합니다. ASF에서 자동으로 수락하지 않는 모든 거래 제안을 완전히 거부하려는 것이 아니라면 이 옵션을 활성화 해서는 안됩니다.

유효하지 않은 그룹 초대는 SteamMasterClanID 그룹이 아닌 그룹에서 온 초대입니다. 예상하시는대로 보통 모드에서 ASF는 이러한 그룹 초대를 무시하고, 특정 Steam 그룹에 가입할지 말지를 스스로 정하도록 합니다. 유효하지 않은 그룹초대 거절(RejectInvalidGroupInvites)은 이러한 그룹 초대를 자동으로 거절하고, SteamMasterClanID가 아닌 다른 그룹이 당신을 초대할 수 없도록 합니다. 모든 그룹 초대를 완전히 거부하려는 것이 아니라면 이 옵션을 활성화해서는 안됩니다.

DismissInventoryNotifications is extremely useful when you start getting annoyed by constant Steam notification about receiving new items. 이 알림은 Steam 클라이언트에 내장되어있기 때문에 ASF가 이 알림을 없앨수는 없지만, 알림을 받은 후 이를 자동으로 클리어 할 수는 있으며, "새로운 보관함 항목" 알림을 놔두지 않아도 됩니다. If you expect to evaluate yourself all received items (especially cards farmed with ASF), then naturally you shouldn't enable this option. 미쳐가고 있다면 이 옵션이 있음을 기억하십시오.

MarkReceivedMessagesAsRead will automatically mark all messages being received by the account on which ASF is running, both private and group, as read. 이는 보통 부계정에서 ASF 명령어 수행중에 자신이 보낸 "새로운 메시지"를 클리어하기 위해서만 사용합니다. 당신은 오프라인이지만 ASF는 여전히 알림을 해제하고 있었던 메시지를 포함한 모든 종류의 새로운 메시지 알림을 잘라내버리고 싶지 않는 한, 이 옵션을 주 계정에서 사용하는 것을 권장하지 않습니다.

MarkBotMessagesAsRead works in a similar manner by marking only bot messages as read. However, keep in mind that when using that option on group chats with your bots and other people, Steam implementation of acknowledging chat message also acknowledges all messages that happened before the one you decided to mark, so if by any chance you don't want to miss unrelated message that happened in-between, you typically want to avoid using this feature. Obviously, it's also risky when you have multiple primary accounts (e.g. from different users) running in the same ASF instance, as you can also miss their normal out-of-ASF messages.

DisableIncomingTradesParsing will stop ASF from parsing incoming trade offers, this means that whole trading functionality related to that will be non-operative. Since ASF works in the least invasive mode by default, accepting only trade offers from Master users and above, never touching other trade offers - incoming trades parsing is enabled by default. This setting makes the most sense for people that would like to ensure no additional requests/overhead related to trades parsing, disabling whole logic in process, for example because they know that their bots will never receive master trade requests, and therefore do not require ASF participating in their trading activity at all. Keep in mind that having this option specified will disable all other options that depend on incoming trades as well, such as AcceptDonations or SteamTradeMatcher - custom plugins will also be unable to process incoming trade offers in usual way.

이 옵션을 어떻게 설정해야 할지 확실치 않다면 기본값으로 두는 것이 최선입니다.

---

CompleteTypesToSend

ImmutableHashSet<byte> 타입으로 기본값은 비어있습니다. When ASF is done with completing a given set of item types specified here, it can automatically send steam trade with all finished sets to the user with Master permission, which is very convenient if you'd like to utilize given bot account for e.g. STM matching, while moving finished sets to some other account. This option works the same as loot command, therefore keep in mind that it requires user with Master permission set, you may also need a valid SteamTradeToken, as well as using an account that is eligible for trading in the first place.

As of today, the following item types are supported in this setting:

값	이름	설명
3	은박 트레이딩 카드(FoilTradingCard)	트레이딩 카드(TradingCard)의 은박 버전
5	트레이딩 카드(TradingCard)	Steam 트레이딩 카드. 배지 제작에 사용. 은박 아님

Please note that regardless of the settings above, ASF will only ask for Steam community items (appID of 753, contextID of 6), so all game items, gifts and likewise, are excluded from the trade offer by definition.

Due to additional overhead of using this option, it's recommended to use it only on bot accounts that have a realistic chance of finishing sets on their own - for example, it makes no sense to activate if you're already using SendOnFarmingFinished preference in FarmingPreferences, SendTradePeriod or loot command on usual basis.

이 옵션을 어떻게 설정해야 할지 확실치 않다면 기본값으로 두는 것이 최선입니다.

---

CustomGamePlayedWhileFarming

string 타입으로 기본값은 null입니다. ASF가 농사를 짓는 동안 현재 농사짓는 게임 대신 "CustomGamePlayedWhileFarming을 플레이중"으로 표시합니다. 이것은 친구들에게 자신이 농사를 짓는 중이라고 알려주고는 싶지만 기본 OnlineStatus를 오프라인으로 사용하고 싶지는 않을때 유용합니다. ASF는 Steam 네트워크의 실제 표시 순서를 보장하지 않습니다. 정확하게, 혹은 부정확하게 표시될 수 있는 제안일 뿐입니다. In particular, custom name will not display in Complex farming algorithm if ASF fills all 32 slots with games requiring hours to be bumped. 기본값 null은 이 기능을 비활성화 합니다.

ASF provides a few special variables that you can optionally use in your text. {0} will be replaced by ASF with AppID of currently farmed game(s), while {1} will be replaced by ASF with GameName of currently farmed game(s).

---

CustomGamePlayedWhileIdle

string 타입으로 기본값은 null입니다. CustomGamePlayedWhileFarming와 비슷하지만 농사가 끝난 계정 등 ASF가 할 일이 없을 경에 사용합니다. ASF는 Steam 네트워크의 실제 표시 순서를 보장하지 않습니다. 정확하게, 혹은 부정확하게 표시될 수 있는 제안일 뿐입니다. If you're using GamesPlayedWhileIdle together with this option, then keep in mind that GamesPlayedWhileIdle get priority, therefore you can't declare more than 31 of them, as otherwise CustomGamePlayedWhileIdle will not be able to occupy the slot for custom name. 기본값 null은 이 기능을 비활성화 합니다.

---

Enabled

bool 타입으로 기본값은 false입니다. 이 속성값은 이 봇의 활성화 여부를 정의합니다. 활성화된 봇 인스턴스(true)는 ASF 실행시에 자동으로 시작되고, 비활성된 봇 인스턴스(false)는 수동으로 시작해야 합니다. 기본값으로 모든 봇이 비활성화되어 있습니다. 따라서 자동으로 시작할 모든 봇의 이 속성값을 true로 바꾸어야 합니다.

---

FarmingOrders

ImmutableList<byte> type with default value of being empty. 이 속성값은 해당 봇 계정에서 ASF가 사용할 선호하는 농사 순서를 정의합니다. 현재 가능한 농사 순서는 다음과 같습니다.

값	이름	설명
0	순서 없음(Unordered)	정렬하지 않음, CPU 성능 약간 개선
1	App ID 오름차순(AppIDsAscending)	appID가 작은 게임부터 먼저 농사 시도
2	App ID 내림차순(AppIDsDescending)	appID가 큰 게임부터 먼저 농사 시도
3	카드 드롭 오름차순(CardDropsAscending)	얻을 수 있는 카드의 수가 적은 게임부터 먼저 농사 시도
4	카드 드롭 내림차순(CardDropsDescending)	얻을 수 있는 카드의 수가 많은 게임부터 먼저 농사 시도
5	시간 오름차순(HoursAscending)	플레이 시간이 적은 게임부터 먼저 농사 시도
6	시간 내림차순(HoursDescending)	플레이 시간이 많은 게임부터 먼저 농사 시도
7	이름 오름차순(NamesAscending)	A부터 시작하는 알파벳 순으로 농사 시도
8	이름 내림차순(NamesDescending)	Z부터 시작하는 알파벳 역순으로 농사 시도
9	무작위(Random)	완전히 무작위 순서로 농사 시도(프로그램 실행시마다 변경)
10	배지 레벨 오름차순(BadgeLevelsAscending)	배지 레벨이 낮은 게임부터 먼저 농사 시도
11	배지 레벨 내림차순(BadgeLevelsDescending)	배지 레벨이 높은 게임부터 먼저 농사 시도
12	등록 날짜 시간 오름차순(RedeemDateTimesAscending)	계정 등록이 오래된 게임부터 먼저 농사 시도
13	등록 날짜 시간 내림차순(RedeemDateTimesDescending)	계정 등록이 최근인 게임부터 먼저 농사 시도
14	장터화 오름차순(MarketableAscending)	판매 불가능한(unmarketable) 카드 드롭이 있는 게임을 우선 파밍 시도 (경고: 계산 비용이 큼)
15	장터화 내림차순(MarketableDescending)	판매 가능한(marketable) 카드 드롭이 있는 게임을 우선 파밍 시도 (경고: 계산 비용이 큼)

이 속성값은 배열이므로 고정된 순서를 여러 다른 설정을 사용할 수 있게 해 줍니다. 예를 들어 카드 판매가능한 게임을 먼저, 배지 레벨이 높은 게임을 그 다음에, 마지막으로 알파벳순으로 정렬하려고 15, 11, 그리고 7 값을 포함할 수 있습니다. 짐작하시다시피, 순서는 실제로 중요합니다. 순서를 반대로 하면(7, 11, 15) 완전히 다른 결과를 얻게 되기 때문입니다(게임 이름을 알파벳순으로 먼저 정렬하게 되며, 게임 이름이 고유하기 때문에 나머지 두 기준은 사실상 무의미해집니다). 대부분의 사람들은 한 가지 순서만 사용하지만, 만약 원한다면 추가 매개 변수로 더 깊이있게 정렬할 수 있습니다.

위의 설명에 있는 "시도"라는 단어에 유의하십시오. 실제 ASF의 순서는 선택한 **카드 농사 알고리즘**에 심하게 영향을 받고 정렬방식은 동일한 성능측면을 고려한 경우에만 영향을 줍니다. 예를 들어, Simple 알고리즘에서는 (모든 게임이 동일한 성능 값을 가지므로) 선택한 FarmingOrders가 현재 파밍 세션에서 완전히 존중됩니다. 반면 Complex 알고리즘에서는 실제 순서가 먼저 시간(hours)의 영향을 받은 다음, 선택한 FarmingOrders에 따라 정렬됩니다. 이는 서로 다른 결과로 이어지는데, 기존에 플레이타임이 있는 게임이 다른 게임보다 우선순위를 갖기 때문입니다. 따라서 실질적으로 ASF는 필요한 HoursUntilCardDrops를 이미 충족한 게임을 우선적으로 선호하며, 그 다음에야 선택한 FarmingOrders에 따라 해당 게임들을 추가로 정렬합니다. 마찬가지로, 이미 bump된 게임들이 소진되면 ASF는 남은 대기열을 시간(hours) 기준으로 먼저 정렬합니다(이렇게 하면 남은 타이틀들을 HoursUntilCardDrops까지 끌어올리는 데 필요한 시간이 줄어들기 때문입니다). 따라서 이 설정 속성은 어디까지나 ASF가 존중하려고 시도하는 **제안(suggestion)**일 뿐이며, 이는 성능에 부정적인 영향을 주지 않는 한에서만 적용됩니다(이 경우 ASF는 항상 FarmingOrders보다 파밍 성능을 우선시합니다).

또한 fq **명령어**를 통해 접근할 수 있는 파밍 우선순위 대기열(farming priority queue)도 있습니다. 이것이 사용되는 경우, 실제 파밍 순서는 먼저 성능(performance)으로, 그 다음 파밍 대기열(farming queue)로, 마지막으로 여러분이 설정한 FarmingOrders로 정렬됩니다.

---

FarmingPreferences

byte flags 타입으로 기본값은 0입니다. 이 속성은 파밍과 관련된 ASF의 동작을 정의하며, 아래와 같이 정의됩니다:

값	이름
0	없음(None)
1	FarmingPausedByDefault
2	ShutdownOnFarmingFinished
4	SendOnFarmingFinished
8	FarmPriorityQueueOnly
16	SkipRefundableGames
32	SkipUnplayedGames
64	EnableRiskyCardsDiscovery
256	AutoUnpackBoosterPacks

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 알아보고 싶으시다면 **JSON 매핑**을 확인해보세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

모든 옵션은 아래에서 설명합니다.

FarmingPausedByDefault는 CardsFarmer 모듈의 초기 상태를 정의합니다. 일반적으로 봇은 Enabled 설정이나 start 명령어로 인해 시작될 때 자동으로 파밍을 시작합니다. FarmingPausedByDefault는 자동 파밍 프로세스를 수동으로 resume하고 싶을 때 사용할 수 있습니다. 예를 들어 항상 play만 사용하고 자동 CardsFarmer 모듈은 전혀 사용하고 싶지 않은 경우입니다 – 이는 pause **명령어**와 정확히 동일하게 작동합니다.

ShutdownOnFarmingFinished를 사용하면 파밍이 끝났을 때 봇을 종료할 수 있습니다. 일반적으로 ASF는 프로세스가 활성화되어 있는 동안 계속해서 계정을 "점유"합니다. 해당 계정의 농사가 끝났다면, ASF는 주기적으로 매 IdleFarmingPeriod 시간마다 Steam 카드가 있는 새로운 게임이 그 사이에 추가되었는지를 확인하여 프로세스를 재시작할 필요없이 농사를 계속할 수 있도록 합니다. 이는 대부분의 사람들에게 유용한데, ASF는 필요하면 자동으로 농사를 이어서할 수 있기 때문입니다. 하지만 해당 계정의 파밍이 모두 끝났을 때 프로세스를 중지시키고 싶으실 수 있는데, 이 플래그를 사용하면 그렇게 할 수 있습니다. 활성화되면 ASF는 계정의 농사가 완전히 끝나면 로그오프하여 더이상 주기적으로 체크하거나 점유하지 않게 합니다. ASF가 모든 시간을 봇 인스턴스에 사용하도록 하거나, 혹은 농사 프로세스가 끝나면 멈추게 할지를 스스로 정해야 합니다.

이 옵션은 ShutdownIfPossible과 함께 사용할 때 가장 의미가 있습니다. 이렇게 하면 모든 계정이 정지되었을 때 ASF도 함께 종료되어 기기를 유휴 상태로 전환할 수 있고, 마지막 카드가 드롭되는 시점에 맞춰 절전 모드나 종료와 같은 다른 작업을 예약할 수도 있습니다.

SendOnFarmingFinished를 사용하면, 그 시점까지 파밍한 모든 것을 담은 Steam 거래를 Master 권한을 가진 사용자에게 자동으로 전송할 수 있어, 직접 거래를 신경 쓰고 싶지 않을 때 매우 편리합니다. 이 옵션은 loot 명령어와 동일하게 작동하므로, Master 권한이 설정된 사용자가 필요하다는 점을 유의하세요. 또한 유효한 SteamTradeToken이 필요할 수 있으며, 애초에 거래가 가능한 계정을 사용하고 있어야 합니다. 이 옵션이 켜져있다면 농사 후 루팅을 시작하는 것과 함께, ASF는 거래로 생기는 새로운 아이템의 알림도 루팅을 시작합니다. 이것은 다른 사람이 우리 계정에 보낸 아이템을 "전달"하는데 매우 유용합니다. 일반적으로 이 기능과 함께 **ASF 2FA**를 사용하는 것이 좋지만, 2FA 확인을 제때 직접 처리할 계획이라면 필수는 아닙니다.

FarmPriorityQueueOnly는 fq **명령어**로 사용할 수 있는 우선순위 파밍 대기열에 직접 추가한 앱만 자동 파밍 대상으로 고려할지 여부를 정의합니다. 이 옵션을 활성화하면, ASF는 목록에 없는 모든 appIDs를 건너뛰며, 이를 통해 자동 ASF 파밍 대상 게임을 직접 선별(cherry-pick)할 수 있게 됩니다. 대기열에 게임을 하나도 추가하지 않았다면, ASF는 해당 계정에 파밍할 것이 아무것도 없는 것처럼 동작한다는 점을 유의하세요.

SkipRefundableGames는 아직 환불 가능한 게임을 자동 파밍에서 건너뛸지 여부를 정의합니다. 환불 가능한 게임은 Steam 환불 페이지에 게시된 것 처럼 Steam 상점에서 구매한지 2주 이내이고 2시간을 넘지않게 플레이한 게임입니다. 기본적으로 ASF는 Steam 환불 정책을 완전히 무시하고 모든 것을 파밍하며, 이는 대부분의 사용자가 기대하는 방식입니다. 하지만 환불 가능한 게임을 ASF가 너무 빨리 파밍하지 않도록 하고 싶다면 이 플래그를 사용할 수 있습니다. 이렇게 하면 ASF가 플레이타임에 부정적인 영향을 줄까 걱정하지 않고, 직접 해당 게임들을 평가한 뒤 필요하다면 환불할 수 있습니다. 이 옵션을 활성화하면, Steam 스토어에서 구매한 게임은 redeem(구매 등록) 날짜로부터 최대 14일 동안 ASF에 의해 파밍되지 않는다는 점을 유의하세요. 계정에 다른 게임이 없다면 이는 파밍할 것이 없는 것처럼 표시됩니다.

SkipUnplayedGames는 아직 실행하지 않은 게임을 ASF가 건너뛸지 여부를 정의합니다. 여기서 말하는 "플레이하지 않은 게임"이란 Steam에 기록된 플레이타임이 정확히 0인 게임을 의미합니다. 이 플래그를 사용하면, Steam에 해당 게임의 플레이타임이 조금이라도 기록될 때까지는 이러한 게임들이 건너뛰어집니다. 이를 통해 ASF가 파밍할 수 있는 게임을 더 세밀하게 제어할 수 있습니다. 아직 플레이해볼 기회가 없었던 게임은 건너뛰어, 플레이하지 않은 게임을 추천해주는 기능과 같은 특정 Steam 기능이 계속 유용하게 유지되도록 해줍니다.

EnableRiskyCardsDiscovery는 ASF가 하나 이상의 배지 페이지를 로드하지 못해 파밍 가능한 게임을 찾을 수 없을 때 트리거되는 추가적인 폴백(fallback)을 활성화합니다. 특히 카드 드롭 양이 매우 많은 일부 계정의 경우, (오버헤드로 인해) 배지 페이지를 더 이상 로드할 수 없는 상황이 발생할 수 있으며, 이러한 계정은 파밍 프로세스를 시작할 근거가 되는 정보를 로드할 수 없다는 단순한 이유만으로 파밍이 불가능해집니다. 이러한 극소수의 경우를 위해, 이 옵션은 대체 알고리즘을 사용할 수 있게 해줍니다. 이 알고리즘은 제작 가능한 부스터와 해당 계정이 받을 자격이 있는 부스터 팩을 조합하여 idle 가능한 게임을 찾아낸 다음, 필요한 정보를 검증하고 가져오는 데 상당한 양의 리소스를 소모하며, 제한된 데이터와 정보만으로 파밍 프로세스를 시작하려 시도합니다. 이는 결국 배지 페이지가 정상적으로 로드되어 일반적인 방식을 다시 사용할 수 있는 상황에 도달하기 위한 것입니다. 이 폴백(fallback)이 사용될 때는 ASF가 제한된 데이터만으로 작동하므로, 실제보다 훨씬 적은 드롭만 찾아내는 것이 완전히 정상이라는 점을 유의하세요 – 나머지 드롭들은 파밍 프로세스의 이후 단계에서 발견됩니다.

이 옵션이 "위험"하다고 불리는 데에는 그럴 만한 이유가 있습니다 – 작동을 위해 매우 느리고 상당한 양의 리소스(네트워크 요청 포함)를 필요로 하므로, 활성화하는 것은 권장되지 않으며, 특히 장기적으로는 더욱 그렇습니다. 이 옵션은 여러분의 계정이 배지 페이지를 로드하지 못해 문제를 겪고 있고, ASF가 프로세스를 시작하는 데 필요한 정보를 항상 로드하지 못해 해당 계정에서 작동할 수 없다는 것을 사전에 확인한 경우에만 사용해야 합니다. 저희가 이 프로세스를 최대한 최적화하기 위해 최선을 다했더라도, 이 옵션이 역효과를 일으킬 가능성은 여전히 존재하며, 너무 많은 요청을 보내거나 Steam 서버에 부하를 일으킴으로써 Steam 측의 일시적인, 혹은 심지어 영구적인 차단과 같은 원치 않는 결과를 초래할 수도 있습니다. Therefore, we warn you in advance and we're offering this option with absolutely no guarantees, you're using it at your own risk.

AutoUnpackBoosterPacks will automatically unpack all booster packs upon receiving new items notification. This will allow you to immediately acquire additional card drops, which might be wanted scenario especially in combination with other options (e.g. SteamTradeMatcher or CompleteTypesToSend).

---

GamesPlayedWhileIdle

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. ASF가 농사지을 것이 없다면 대신 특정 게임(appIDs)을 플레이할 수 있습니다. 이 방법으로 플레이하면 "플레이한 시간"을 늘릴 수 있지만, 그게 끝입니다. In order for this feature to work properly, your Steam account must own a valid license to all the appIDs that you specify here, this includes F2P games as well. 이 기능은 Steam 네트워크에서 사용자정의 상태를 보여주면서 선택한 게임을 플레이하기 위해 CustomGamePlayedWhileIdle와 동시에 활성화 될 수 있습니다. 하지만 이 경우 CustomGamePlayedWhileFarming의 경우와 같이 실제 표시 순서는 보장하지 않습니다. Steam은 ASF가 총 32개의 appIDs를 플레이 할 수 있도록 허락하고 있으며, 따라서 이 속성값에 그만큼을 넣을 수 있습니다.

---

GamingDeviceType

ushort type with default value of 1. 이 속성은 Steam 플랫폼에서 일부 추가적인 온라인 기능을 활성화할 수 있으며, 아래와 같이 정의됩니다:

값	이름	설명
1	StandardPC	특별한 모드 없음, 기본값
544	SteamDeck	Steam Deck으로 표시

이 속성의 기반이 되는 EGamingDeviceType 타입에는 더 많은 사용 가능한 값이 있지만, 저희가 아는 한 오늘날 기준으로는 전혀 효과가 없어서 가독성을 위해 제외했습니다.

이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 1으로 두십시오.

---

HoursUntilCardDrops

byte 타입으로 기본값은 3입니다. 이 속성값은 이 계정에 카드 획득 제한이 있는지를 정의하고, 만약 제한이 있다면 최초 몇시간인지를 정의합니다. 카드 획득 제한이란, 그 계정에서 한 게임을 적어도 HoursUntilCardDrops 시간 동안 플레이하지 않으면 그 게임의 카드가 나오지 않는다는 의미입니다. 아쉽게도 이를 알아낼 수 있는 마법은 없으므로 ASF는 당신에게 의존합니다. 이 속성값은 사용할 카드 농사 알고리즘 에 영향을 줍니다. 이 속성값을 설정하면 이득을 극대화하고 카드농사에 필요한 시간을 최소화합니다. 어떤 값을 사용할지에 대한 명확한 정답은 없고, 오로지 자신의 계정에 달려있음을 기억하십시오. 환불을 한번도 하지 않은 오래된 계정은 제한이 없는 것으로 보이므로 0 값을 사용하여야 하고, 새로운 계정과 환불을 받았던 계정은 획득 제한이 있으므로 3 값을 사용합니다. 하지만 이것은 단지 이론일 뿐이고 규칙으로 받아들여서는 안됩니다. 이 속성값의 기본값은 "소악(lesser evil)"과 대부분의 사용례에 근거해 설정되었습니다.

---

LootableTypes

ImmutableHashSet<byte> 타입으로 기본값은 1, 3, 5 Steam 아이템 타입입니다. 이 속성은 loot할 때의 ASF 동작을 정의합니다 – **명령어**를 사용한 수동 loot와, 하나 이상의 설정 속성을 통한 자동 loot 모두에 해당됩니다. ASF는 LootableTypes에 있는 아이템만 거래 제안에 포함할 것이므로, 이 속성값은 당신에게 보내진 거래 제안에서 무엇을 받을지 결정할 수 있게 해줍니다.

값	이름	설명
0	알 수 없음(Unknown)	아래의 어느것에도 해당하지 않는 모든 타입
1	부스터 팩(BoosterPack)	한 게임의 무작위 카드 3장이 들어있는 부스터 팩
2	이모티콘(Emoticon)	Steam 대화에서 사용하는 이모티콘
3	은박 트레이딩 카드(FoilTradingCard)	트레이딩 카드(TradingCard)의 은박 버전
4	프로필 배경(ProfileBackground)	Steam 프로필에서 사용하는 프로필 배경
5	트레이딩 카드(TradingCard)	Steam 트레이딩 카드. 배지 제작에 사용. 은박 아님
6	Steam 보석(SteamGems)	부스터 팩 제작에 사용되는 Steam 보석. 보석 더미 포함
7	판매 아이템(SaleItem)	Steam 할인기간동안 획득하는 특별한 아이템
8	소모품(Consumable)	사용하면 사라지는 특별한 소모 아이템
9	프로필 수정(ProfileModifier)	Steam 프로필 모양을 수정할 수 있는 특별한 아이템
10	Sticker	Special items that can be used on Steam chat
11	ChatEffect	Special items that can be used on Steam chat
12	MiniProfileBackground	Special background for Steam profile
13	AvatarProfileFrame	Special avatar frame for Steam profile
14	AnimatedAvatar	Special animated avatar for Steam profile
15	KeyboardSkin	Special keyboard skin for Steam deck
16	StartupVideo	Special startup video for Steam deck

Please note that regardless of the settings above, ASF will only ask for Steam community items (appID of 753, contextID of 6), so all game items, gifts and likewise, are excluded from the trade offer by definition.

Default ASF setting is based on the most common usage of the bot, with looting only booster packs, and trading cards (including foils). 여기 정의된 속성값은 당신을 만족시킬수 있도록 어떻게든 행동을 변경할 수 있게 합니다. 위에 정의되지 않은 모든 타입은 알 수 없음(Unknown) 타입으로 표시됨을 명심하십시오. Valve가 새로운 Steam 아이템을 내놓았을때 특히 중요한데, 향후 릴리스에서 여기에 추가되기 전까지는 ASF에서 알 수 없음(Unknown) 으로 표시될 것입니다. 이것이 당신이 무엇을 하고 있는지를 알고 있고, 만약 Steam 네트워크가 깨져서 모든 항목을 알 수 없음(Unknown)으로 표시한다면 ASF는 전체 보관함을 거래 제안으로 보낼것이라는 점도 이해하고 있지않는 한, 일반적으로 알 수 없음(Unknown) 타입을 LootableTypes에 포함시키는 것을 권장하지 않는 이유입니다. My strong suggestion is to not include Unknown type in the LootableTypes, even if you expect to loot everything (else).

---

MachineName

string 타입으로 기본값은 null입니다. ASF will use this property when logging in to Steam network, which can be used for customization in regards to how exactly Steam will display ASF machine and session, e.g. when displaying devices that are currently logged in here.

ASF provides a few special variables that you can optionally use in your text. {0} will be replaced by machine name as provided by your OS, {1} will be replaced by ASF's public identifier, while {2} will be replaced by ASF's version.

Unless you know what you're doing, you should keep it with default value of null. In this case, ASF will decide internally about the proper value, which is {0} ({1}/{2}) as of today. Keep in mind that this is only a suggestion that Steam network may, or may not, respect in full.

---

MatchableTypes

ImmutableHashSet<byte> 타입으로 기본값은 5 Steam 아이템 타입입니다. 이 속성값은 TradingPreferences의 SteamTradeMatcher 옵션이 활성화 되었을 때 매칭을 허락할 Steam 아이템 타입을 정의합니다. 타입은 아래와 같이 정의됩니다.

값	이름	설명
0	알 수 없음(Unknown)	아래의 어느것에도 해당하지 않는 모든 타입
1	부스터 팩(BoosterPack)	한 게임의 무작위 카드 3장이 들어있는 부스터 팩
2	이모티콘(Emoticon)	Steam 대화에서 사용하는 이모티콘
3	은박 트레이딩 카드(FoilTradingCard)	트레이딩 카드(TradingCard)의 은박 버전
4	프로필 배경(ProfileBackground)	Steam 프로필에서 사용하는 프로필 배경
5	트레이딩 카드(TradingCard)	Steam 트레이딩 카드. 배지 제작에 사용. 은박 아님
6	Steam 보석(SteamGems)	부스터 팩 제작에 사용되는 Steam 보석. 보석 더미 포함
7	판매 아이템(SaleItem)	Steam 할인기간동안 획득하는 특별한 아이템
8	소모품(Consumable)	사용하면 사라지는 특별한 소모 아이템
9	프로필 수정(ProfileModifier)	Steam 프로필 모양을 수정할 수 있는 특별한 아이템
10	스티커(Sticker)	Special items that can be used on Steam chat
11	채팅 효과(ChatEffect)	Special items that can be used on Steam chat
12	MiniProfileBackground	Special background for Steam profile
13	AvatarProfileFrame	Special avatar frame for Steam profile
14	AnimatedAvatar	Special animated avatar for Steam profile
15	KeyboardSkin	Special keyboard skin for Steam deck
16	StartupVideo	Steam deck 전용 특수 시작 영상

물론, 이 속성값에 사용해야 할 타입은 보통 2, 3, 4, 5만을 포함해야 하는데, 이 타입만 STM에서 지원하기 때문입니다. ASF는 아이템의 희귀도를 구별하는 적절한 논리구조를 가지고 있으며, 따라서 이모티콘이나 배경을 안전하게 매치할 수 있습니다. ASF는 같은 게임의 같은 타입의 이모티콘이나 배경을 공평하다고 판단하고 동일한 희귀도를 공유합니다.

ASF는 거래 봇이 아니며, 장터 가격을 신경쓰지 않음을 명심하십시오. 한 세트 내의 동일한 희귀도를 가진 아이템이 같은 가격을 가져야 한다고 생각하지 않는다면, 이 옵션은 당신을 위한 것은 아닙니다. 이 설정을 변경하기 전에 위의 문장을 이해하고 동의하는지 두번 생각하십시오.

무슨 일을 하고 있는지 알지 못한다면 기본값인 5를 유지하십시오.

---

OnlineFlags

기본값이 0인 ushort flags 타입입니다. 이 속성은 **OnlineStatus**를 보완하는 역할을 하며, Steam 네트워크에 알릴 추가적인 온라인 상태(presence) 기능을 지정합니다. Offline이 아닌 **OnlineStatus**이 필요하며, 아래와 같이 정의됩니다:

값	이름	설명
0	없음(None)	특별한 온라인 상태(presence) 플래그 없음, 기본값
2	InJoinableGame	클라이언트가 참가 가능한(joinable) 게임 중임
8	RemotePlayTogether	클라이언트가 remote play together 세션을 사용 중임
256	ClientTypeWeb	클라이언트가 web 인터페이스를 사용 중임
512	ClientTypeMobile	클라이언트가 모바일 앱을 사용 중임
1024	ClientTypeTenfoot	클라이언트가 big picture 모드를 사용 중임
2048	ClientTypeVR	클라이언트가 VR 헤드셋을 사용 중임

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 알아보고 싶으시다면 **JSON 매핑**을 확인해보세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

이 속성의 기반이 되는 EPersonaStateFlag 타입에는 더 많은 사용 가능한 플래그가 있지만, 저희가 아는 한 오늘날 기준으로는 전혀 효과가 없어서 가독성을 위해 제외했습니다.

이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 0으로 두십시오.

---

OnlineStatus

byte 타입으로 기본값은 1입니다. 이 속성값은 스팀 네트워크에 로그인 후 스팀 네트워크에 알려줄 활동 상태를 지정합니다. 현재 선택할 수 있는 활동 상태는 다음과 같습니다.

값	이름
0	오프라인
1	온라인
2	다른 용무 중
3	자리 비움
4	수면 중
5	LookingToTrade
6	LookingToPlay
7	숨기(Invisible)

오프라인 상태는 주 계정에 극도로 유용합니다. 알다시피 게임을 농사지으면 스팀 상태가 "XXX를 플레이중"으로 나타나며, 실제로는 농사를 짓고 있는데 플레이를 하는것으로 혼동울 주어 당신의 친구들이 오해할 수 있습니다. 오프라인 상태를 사용하면 ASF로 카드 농사중일때 "게임중"으로 표시하지 않아 이런 문제를 해결해줍니다. 이것은 ASF가 정상작동하기 위해서 스팀 커뮤니티에 로그인할 필요가 없기 때문에 가능합니다. 우리는 사실 스팀 네트워크에 접속해서, 게임을 플레이중이지만, 우리의 존재를 전혀 알리지 않습니다. 오프라인 상태에서 플레이했던 게임도 플레이 시간에 포함되며, 프로필의 "최근에 플레이한 게임"에 표시된 다는 것을 명심하십시오.

그 외에, 이 기능은 ASF는 실행중이지만 스팀 클라이언트는 동시에 열어놓지 않고도 알림과 읽지 않은 메시지를 수신하려는 경우에 중요합니다. 이것은 ASF가 스팀 클라이언트 그 자체인 것 처럼 행동하며, ASF가 그렇게 하던 아니던 스팀이 모든 메시지와 이벤트를 ASF로 보내주기 때문입니다. ASF와 스팀 클라이언트를 둘 다 실행하는 것은 문제가 없습니다. 두 클라이언트 모두 정확하게 동일한 이벤트를 수신합니다. 하지만 만약 ASF가 실행중이라면 스팀 클라이언트가 존재하지 않아 받을 수 없음에도 불구하고 특정 이벤트와 메시지를 "배달된" 것으로 표시할 수도 있습니다. 오프라인 상태는 이 문제도 해결합니다. ASF는 이 경우 어떤 커뮤니티 이벤트트로도 간주되지 않기때문에 모든 읽지 않은 메시지와 다른 이벤트가 당신이 돌아오면 읽지 않은 상태로 정상적으로 표시될 것입니다.

오프라인(Offline) 모드로 실행 중인 ASF는 채팅뿐만 아니라 전체 커뮤니티 상태(presence)가 사실상 완전히 오프라인 상태이기 때문에, 평소처럼 Steam 채팅을 통한 명령을 받을 수 없다는 점을 유의해야 합니다. 이 문제에 대한 해결책은 대신 숨기(Invisible) 모드를 사용하는 것입니다. 이 모드는 비슷한 방식으로 작동하지만(상태를 노출하지 않음), 메시지를 받고 응답하는 기능은 유지됩니다(따라서 위에서 언급한 것처럼 알림과 읽지 않은 메시지를 정리할 가능성도 있습니다). 숨기(Invisible) 모드는 (상태 측면에서) 노출하고 싶지 않지만 여전히 명령을 보낼 수 있어야 하는 부계정에 가장 적합합니다.

하지만 숨기(Invisible) 모드에는 한 가지 함정이 있습니다 – 주(primary) 계정과는 잘 맞지 않는다는 점입니다. 이는 ASF 자체는 상태를 노출하지 않더라도, 현재 온라인 상태인 어떤 Steam 세션이든 상태를 노출시키기 때문입니다. 이는 ASF 측에서 고칠 수 없는 Steam 네트워크의 현재 한계/버그로 인해 발생합니다. 따라서 숨기(Invisible) 모드를 사용하고 싶다면, 동일한 계정의 다른 모든 세션도 숨기(Invisible) 모드를 사용하도록 해야 합니다. 이는 ASF가 유일한 활성 세션일 가능성이 높은 부계정에서는 문제가 없겠지만, 주 계정에서는 친구들에게 온라인(Online)으로 표시되면서 ASF 활동만 숨기고 싶은 경우가 거의 대부분일 것입니다. 이런 경우 숨기(Invisible) 모드는 여러분에게 전혀 쓸모가 없습니다 (대신 오프라인(Offline) 모드 사용을 권장합니다). 이 한계/버그가 언젠가 Valve에 의해 해결되길 바라지만, 조만간 그렇게 될 거라고 기대하지는 않습니다...

이 속성값을 어떻게 설정할지 잘 모르겠다면, 주 계정은 0 (오프라인)으로 놓고 다른 계정은 기본값인 1 (온라인) 로 두는 것을 추천합니다.

---

PasswordFormat

기본값이 0(PlainText)인 byte 타입입니다. 이 속성은 SteamPassword 속성의 형식(format)을 정의하며, 현재 security 섹션에 명시된 값들을 지원합니다. SteamPassword 속성이 실제로 일치하는 PasswordFormat에 맞는 비밀번호를 포함하고 있는지 확인해야 하므로, 해당 섹션에 명시된 안내를 따라야 합니다. 즉, PasswordFormat을 변경하면 SteamPassword는 그 후에 변경하는 것이 아니고 이미 그 형식으로 바뀌어있어야 합니다. 무슨 일을 하고 있는지 알지 못한다면 기본값인 0을 유지하십시오.

이미 최소 한 번 Steam 네트워크에 로그인한 적이 있는 봇의 PasswordFormat을 변경하기로 결정하면, 다음 봇 시작 시 일회성 복호화(decrypt) 오류가 발생할 수 있습니다 – 이는 PasswordFormat이 Bot.db 데이터베이스 파일 내 민감한 속성들의 자동 암호화/복호화에도 사용되기 때문입니다. 이 오류는 안전하게 무시하셔도 됩니다. ASF가 이 상황에서 자체적으로 복구할 수 있기 때문입니다. 다만 매번 재시작할 때마다 등 지속적으로 발생한다면, 원인을 조사해봐야 합니다.

---

RedeemingPreferences

byte flags 타입으로 기본값은 0입니다. 이 속성값은 cd키 등록에서 ASF 봇의 행동을 아래와 같이 정의합니다.

값	이름	설명
0	없음(None)	특별한 redeeming preference 없음, 기본값
1	Forwarding	redeem할 수 없는 키를 다른 봇으로 전달
2	Distributing	모든 키를 본인 및 다른 봇들에게 분배
4	KeepMissingGames	전달할 때 (잠재적으로) 없는 게임에 대한 키는 유지하며, 사용하지 않은 채로 남겨둠
8	AssumeWalletKeyOnBadActivationCode	Assume that BadActivationCode keys are equal to CannotRedeemCodeFromClient, and therefore try to redeem them as wallet keys

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. Check out json mapping if you'd like to learn more. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

Forwarding will cause bot to forward a key that is not possible to redeem, to another connected and logged on bot that is missing that particular game (if possible to check). The most common situation is forwarding AlreadyPurchased game to another bot that is missing that particular game, but this option also covers other scenarios, such as DoesNotOwnRequiredApp, RateLimited or RestrictedCountry.

Distributing will cause bot to distribute all received keys among itself and other bots. This means that every bot will get a single key from the batch. Typically this is used only when you're redeeming many keys for the same game, and you want to evenly distribute them among your bots, as opposed to redeeming keys for various different games. This feature makes no sense if you're redeeming only one key in a single redeem action (as there are no extra keys to be distributed).

KeepMissingGames will cause bot to skip Forwarding when we can't be sure if key being redeemed is in fact owned by our bot, or not. This basically means that Forwarding will apply only to AlreadyPurchased keys, instead of covering also other cases such as DoesNotOwnRequiredApp, RateLimited or RestrictedCountry. Typically you want to use this option on primary account, to ensure that keys being redeemed on it won't be forwarded further if your bot for example becomes temporarily RateLimited. As you can guess from the description, this field has absolutely no effect if Forwarding is not enabled.

AssumeWalletKeyOnBadActivationCode will cause BadActivationCode keys to be treated as CannotRedeemCodeFromClient, and therefore result in ASF trying to redeem them as wallet keys. This is needed because Steam might announce wallet keys as BadActivationCode (and not CannotRedeemCodeFromClient as it used to), resulting in ASF never attempting to redeem them. However, we recommend against using this preference, as it'll result in ASF trying to redeem every invalid key as a wallet code, resulting in excessive amount of (potentially invalid) requests sent to the Steam service, with all the potential consequences. Instead, we recommend to use ForceAssumeWalletKey redeem^ mode while knowingly redeeming wallet keys, which will enable the needed workaround only when it's required, on as-needed basis.

Enabling both Forwarding and Distributing will add distributing feature on top of forwarding one, which makes ASF trying to redeem one key on all bots firstly (forwarding) before moving to the next one (distributing). Typically you want to use this option only when you want Forwarding, but with altered behaviour of switching the bot on key being used, instead of always going in-order with every key (which would be Forwarding alone). This behaviour can be beneficial if you know that majority or even all of your keys are tied to the same game, because in this situation Forwarding alone would try to redeem everything on one bot firstly (which makes sense if your keys are for unique games), and Forwarding + Distributing will switch the bot on the next key, "distributing" the task of redeeming new key onto another bot than the initial one (which makes sense if keys are for the same game, skipping one pointless attempt per key).

The actual bots order for all of the redeeming scenarios is alphabetical, excluding bots that are unavailable (not connected, stopped or likewise). Please keep in mind that there is per-IP and per-account hourly limit of redeeming tries, and every redeem try that didn't end with OK contributes to failed tries. ASF will do its best to minimize number of AlreadyPurchased failures, e.g. by trying to avoid forwarding a key to another bot that already owns that particular game, but it's not always guaranteed to work due to how Steam is handling licenses. Using redeeming flags such as Forwarding or Distributing will always increase your likelyhood to hit RateLimited.

Also keep in mind that you can't forward or distribute keys to bots that you do not have access to. This should be obvious, but ensure that you're at least Operator of all the bots you want to include in your redeeming process, for example with status ASF command.

---

RemoteCommunication

byte flags 타입으로 기본값은 3입니다. This property defines per-bot ASF behaviour when it comes to communication with remote, third-party services, and is defined as below:

값	이름	설명
0	없음(None)	No allowed third-party communication, rendering selected ASF features unusable
1	SteamGroup	Allows communication with ASF's Steam group
2	PublicListing	Allows communication with ASF's STM listing in order to being listed, if user has also enabled SteamTradeMatcher in TradingPreferences

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. Check out json mapping if you'd like to learn more. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

This option doesn't include every third-party communication offered by ASF, only those that are not implied by other settings. For example, if you've enabled ASF's auto-updates, ASF will communicate with both GitHub (for downloads) and our server (for checksum verification), as per your configuration. Likewise, enabling MatchActively in TradingPreferences implies communication with our server to fetch listed bots, which is required for that functionality.

Further explanation on this subject is available in remote communication section. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

SendTradePeriod

byte 타입으로 기본값은 0입니다. This property works very similar to SendOnFarmingFinished preference in FarmingPreferences, with one difference - instead of sending trade when farming is done, we can also send it every SendTradePeriod hours, regardless of how much we have to farm left. 부계정의 농사가 끝날때까지 기다리는 대신 평소에 루팅 하고 싶은 경우 유용합니다. 기본값인 0은 이 기능을 비활성화합니다. 예를 들어 봇이 매일 거래를 보내길 원한다면 여기에 24를 넣으십시오.

Typically you'll want to use ASF 2FA together with this feature, although it's not a requirement if you intend to handle 2FA confirmations manually in timely fashion. 이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 0으로 두십시오.

---

SteamLogin

string 타입으로 기본값은 null입니다. 이 속성값은 당신이 Steam에 로그인할때 사용하는 Steam 로그인 아이디를 정의합니다. In addition to defining steam login here, you may also keep default value of null if you want to enter your steam login on each ASF startup instead of putting it in the config. This may be useful for you if you don't want to save sensitive data in config file.

---

SteamMasterClanID

ulong 타입으로 기본값은 0입니다. 이 속성값은 봇이 자동으로 가입해야 하는 Steam 그룹 또는 그룹대화의 steamID를 정의합니다. 그룹의 SteamID는 여기 로 이동해서 /memberslistxml?xml=1 을 링크의 마지막에 추가합니다. 그러면 이런 모양이 됩니다. 그러면 결과의 <groupID64> 태그에서 그룹의 SteamID를 얻을 수 있습니다. 위의 예시에서는 103582791440160998 입니다. 봇은 시작시에 해당 그룹에 가입을 시도하고, 또한 이 그룹의 그룹 초대를 자동으로 수락하여 이 그룹이 비공개인 경우 수동으로 봇을 초대할 수 있게 합니다. 봇을 위한 그룹이 없다면 이 속성값을 기본값인 0으로 유지하십시오.

---

SteamParentalCode

string 타입으로 기본값은 null입니다. This property defines your steam parental PIN. ASF requires an access to resources protected by steam parental, therefore if you use that feature, you should provide ASF with parental unlock PIN, so it can operate normally. Default value of null means that there is no steam parental PIN required to unlock this account, and this is probably what you want if you don't use steam parental functionality.

In limited circumstances, ASF is also able to generate a valid Steam parental code itself, although that requires excessive amount of OS resources and additional time to complete, not to mention that it's not guaranteed to succeed, therefore we recommend to not rely on that feature and instead put valid SteamParentalCode in the config for ASF to use. If ASF determines that PIN is required, and it'll be unable to generate one on its own, it'll ask you for input.

---

스팀 암호(SteamPassword)

string 타입으로 기본값은 null입니다. 이 속성값은 당신이 Steam에 로그인할때 사용하는 Steam 암호를 정의합니다. In addition to defining steam password here, you may also keep default value of null if you want to enter your steam password on each ASF startup instead of putting it in the config. This may be useful for you if you don't want to save sensitive data in config file.

---

SteamTradeToken

string 타입으로 기본값은 null입니다. 친구 목록에 당신의 봇이 있다면, 거래 토큰을 걱정하지 않고 당신에게 즉시 거래를 보낼 수 있습니다. 따라서 이 속성값을 기본값인 null로 유지할 수 있습니다. 하지만 친구 목록에 당신의 봇이 없다면 이 봇이 거래를 보낼 사용자의 거래 토큰을 생성하고 채워줘야 합니다. 즉, 이 속성값은 이 봇 인스턴스의 SteamUserPermissions이 주인(Master) 권한으로 정의된 계정의 거래 토큰으로 채워져야 합니다.

토큰을 채우기 위해서는 주인(Master) 권한을 가진 사용자로 로그인해서, 여기 를 방문해서 거래 URL을 확인하십시오. 우리가 찾는 토큰은 당신의 거래 URL의 &token= 뒤의 8자리 문자입니다. 그 8자리 문자를 복사해서 여기 SteamTradeToken에 넣으십시오. 전체 거래 URL이나 &token= 부분을 포함하지 말고 오직 토큰(8자리)만 넣으십시오.

---

SteamUserPermissions

ImmutableDictionary<ulong, byte> 타입으로 기본값은 비어있습니다. 이 속성값은 64비트 Steam ID로 인식되는 Steam 사용자와 ASF 인스턴스에서의 권한을 특정하는 byte 숫자로 매칭되는 사전 속성값입니다. ASF에서 현재 가능한 봇 권한은 다음과 같습니다.

값	이름	설명
0	없음(None)	No special permission, this is mainly a reference value that is assigned to steam IDs missing in this dictionary - there is no need to define anybody with this permission
1	가족 공유(FamilySharing)	가족 공유 사용자에 대한 최소한의 접근만 제공합니다. 이 또한 참조용 값입니다. ASF는 라이브러리를 허용한 Steam ID를 자동으로 발견할 수 있습니다.
2	운영자(Operator)	주로 라이선스 추가와 키 등록과 같은 봇 인스턴스에 대한 기본적인 권한을 제공합니다.
3	주인(Master)	봇 인스턴스에 대한 전체 권한을 제공합니다.

간단하게 말하면 주어진 사용자에 대해 권한을 부여하는 속성값입니다. 권한은 ASF 명령어 에 접근할 때 중요하지만, 거래를 수락하는 것 같은 많은 ASF 기능을 활성화하는데도 중요합니다. For example you may want to set your own account as Master, and give Operator access to 2-3 of your friends so they can easily redeem keys for your bot with ASF, while not being eligible e.g. for stopping it. 사용자에게 권한을 쉽게 줄수 있으므로 당신의 봇을 특정행동을 하도록 허용할 수 있습니다.

정확히 한 사용자만을 주인(Master)으로, 그리고 필요한 만큼을 운영자(Operator) 및 그 이하로 설정하기를 권장합니다. While it's technically possible to set multiple Masters and ASF will work correctly with them, for example by accepting all of their trades sent to the bot, ASF will use only one of them (with lowest steam ID) for every action that requires a single target, for example a loot request, so also properties like SendOnFarmingFinished preference in FarmingPreferences or SendTradePeriod. If you perfectly understand those limitations, especially the fact that loot request will always send items to the Master with lowest steam ID, regardless of the Master that actually executed the command, then you can define multiple users with Master permission here, but we still recommend a single master scheme.

소유자(Owner) 권한이 또 하나 있습니다. 일반 환경설정의 SteamOwnerID 속성값에 선언되어 있습니다. SteamUserPermissions 속성값은 ASF 프로세스가 아니라 봇 인스턴스와 관련된 권한만 정의하므로 소유자(Owner) 권한을 여기에서 할당할 수 없습니다. 봇과 관련된 작업에서 SteamOwnerID는 주인(Master)과 동일하게 취급되므로 여기에서 SteamOwnerID를 설정하는 것은 꼭 필요하지는 않습니다.

---

TradeCheckPeriod

byte 타입으로 기본값은 60입니다. Normally ASF handles incoming trade offers right after receiving notification about one, but sometimes because of Steam glitches it can't do it at that time, and such trade offers remain ignored until next trade notification or bot restart occurs, which may lead to trades being cancelled or items not available at that later time. If this parameter is set to a non-zero value, ASF will additionally check for such outstanding trades every TradeCheckPeriod minutes. Default value is selected with balance between additional requests to steam servers and losing incoming trades in mind. However, if you are just using ASF to farm cards, and don't plan to automatically process any incoming trades, you may set it to 0 to disable this feature completely. On the other hand, if your bot participates in public ASF's STM listing or provides other automated services as a trade bot, you may want to decrease this parameter to 15 minutes or so, to process all trades in a timely manner.

---

TradingPreferences

byte flags 타입으로 기본값은 0입니다. 이 속성값은 거래에서 ASF 봇의 행동을 아래와 같이 정의합니다.

값	이름	설명
0	없음(None)	No special trading preferences, default
1	기부 수락(AcceptDonations)	잃는 것이 없다면 거래를 수락합니다.
2	SteamTradeMatcher	STM 과 같은 거래에 수동적으로 참여합니다. 자세한 사항은 거래 를 참고하십시오.
4	전부 매칭(MatchEverything)	SteamTradeMatcher 가 설정되어 있어야 합니다. 좋음, 중립, 나쁨 거래를 수락합니다.
8	봇거래수락안함(DontAcceptBotTrades)	다른 봇의 loot 거래를 자동으로 수락하지 않습니다.
16	능동적 매칭(MatchActively)	STM 과 같은 거래에 능동적으로 참여합니다. Visit ItemsMatcherPlugin for more info

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. Check out json mapping if you'd like to learn more. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

ASF의 거래 논리, 가능한 모든 플래그의 설명 등에 대한 자세한 내용은 거래 항목에서 확인할 수 있습니다.

---

TransferableTypes

ImmutableHashSet<byte> 타입으로 기본값은 1, 3, 5 Steam 아이템 타입입니다. This property defines which Steam item types will be considered for transfering between bots, during transfer command. ASF는 TransferableTypes에 있는 아이템만 거래 제안에 포함할 것이므로, 이 속성값은 당신의 봇 중 하나에게 보내진 거래 제안에서 무엇을 받을지 결정할 수 있게 해줍니다.

값	이름	설명
0	알 수 없음(Unknown)	아래의 어느것에도 해당하지 않는 모든 타입
1	부스터 팩(BoosterPack)	한 게임의 무작위 카드 3장이 들어있는 부스터 팩
2	이모티콘(Emoticon)	Steam 대화에서 사용하는 이모티콘
3	은박 트레이딩 카드(FoilTradingCard)	트레이딩 카드(TradingCard)의 은박 버전
4	프로필 배경(ProfileBackground)	Steam 프로필에서 사용하는 프로필 배경
5	트레이딩 카드(TradingCard)	Steam 트레이딩 카드. 배지 제작에 사용. 은박 아님
6	Steam 보석(SteamGems)	부스터 팩 제작에 사용되는 Steam 보석. 보석 더미 포함
7	판매 아이템(SaleItem)	Steam 할인기간동안 획득하는 특별한 아이템
8	소모품(Consumable)	사용하면 사라지는 특별한 소모 아이템
9	프로필 수정(ProfileModifier)	Steam 프로필 모양을 수정할 수 있는 특별한 아이템
10	Sticker	Special items that can be used on Steam chat
11	ChatEffect	Special items that can be used on Steam chat
12	MiniProfileBackground	Special background for Steam profile
13	AvatarProfileFrame	Special avatar frame for Steam profile
14	AnimatedAvatar	Special animated avatar for Steam profile
15	KeyboardSkin	Special keyboard skin for Steam deck
16	StartupVideo	Special startup video for Steam deck

Please note that regardless of the settings above, ASF will only ask for Steam community items (appID of 753, contextID of 6), so all game items, gifts and likewise, are excluded from the trade offer by definition.

Default ASF setting is based on the most common usage of the bot, with transfering only booster packs, and trading cards (including foils). 여기 정의된 속성값은 당신을 만족시킬수 있도록 어떻게든 행동을 변경할 수 있게 합니다. 위에 정의되지 않은 모든 타입은 알 수 없음(Unknown) 타입으로 표시됨을 명심하십시오. Valve가 새로운 Steam 아이템을 내놓았을때 특히 중요한데, 향후 릴리스에서 여기에 추가되기 전까지는 ASF에서 알 수 없음(Unknown) 으로 표시될 것입니다. 이것이 당신이 무엇을 하고 있는지를 알고 있고, 만약 Steam 네트워크가 깨져서 모든 아이템을 알 수 없음(Unknown)으로 표시한다면 ASF는 전체 보관함을 거래 제안으로 보낼것이라는 점도 이해하고 있지않는 한, 일반적으로 알 수 없음(Unknown) 타입을 TransferableTypes에 포함시키는 것을 권장하지 않는 이유입니다. 모든 것을 전송하고 싶더라도 알 수 없음(Unknown) 타입을 TransferableTypes에 포함하지 않는 것을 강력하게 권장합니다.

---

UseLoginKeys

bool 타입으로 기본값은 true입니다. This property defines if ASF should use login keys mechanism for this Steam account. Login keys mechanism works very similar to official Steam client's "remember me" option, which makes it possible for ASF to store and use temporary one-time use login key for next logon attempt, effectively skipping a need of providing password, Steam Guard or 2FA code as long as our login key is valid. Login key is stored in BotName.db file and updated automatically. This is why you don't need to provide password/SteamGuard/2FA code after logging in successfully with ASF just once.

Login keys are used by default for your convenience, so you don't need to input SteamPassword, SteamGuard or 2FA code (when not using ASF 2FA) on each login. It's also superior alternative since login key can be used only for a single time and does not reveal your original password in any way. Exactly the same method is being used by your original Steam client, which saves your account name and login key for your next logon attempt, effectively being the same as using SteamLogin with UseLoginKeys and empty SteamPassword in ASF.

However, some people could be concerned even about this little detail, therefore this option is available here for you if you'd like to ensure that ASF won't store any kind of token that would allow resuming previous session after being closed, which will result in full authentication being mandatory on each login attempt. Disabling this option will work exactly the same as not checking "remember me" in official Steam client. Unless you know what you're doing, you should keep it with default value of true.

---

UserInterfaceMode

byte 타입으로 기본값은 0입니다. This property specifies user interface mode that the bot will be announced with after logging in to the Steam network. It might influence how the account is visible e.g. on the Steam chat, if your presence allows that through OnlineStatus. Currently you can choose one of below modes:

값	이름	설명
0	VGUI	Default Steam client mode
1	Tenfoot	Big picture mode
2	Mobile	Steam mobile app
3	Web	Web browser session
5	MobileChat	Steam mobile chat app

The underlying EUIMode type that this property is based on includes more available values, however, to the best of our knowledge they have absolutely no effect as of today, therefore they were cut for visibility. Also, you might be interested in checking GamingDeviceType, since some additional features are enabled there.

이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 0으로 두십시오.

---

WebProxy

string 타입으로 기본값은 null입니다. This property defines a web proxy address that will be used for bot-specific internal http-related communication, especially to services such as api.steampowered.com, steamcommunity.com and store.steampowered.com. If not set, ASF will use global WebProxy setting specified above instead. Proxying ASF requests could be exceptionally useful for bypassing various kinds of firewalls, especially the great firewall in China.

이 속성값은 아래와 같은 uri 문자열로 정의됩니다.

A URI string is composed of a scheme (supported: http/https/socks4/socks4a/socks5), a host, and an optional port. 다음은 완전한 uri 문자열의 예시입니다. "http://contoso.com:8080".

프록시가 인증을 필요로 하면, WebProxyUsername과 WebProxyPassword를 설정해야 합니다. 그럴 필요가 없다면 이 속성값을 설정하는 것만으로 충분합니다.

If you require proxying internal Steam network communication (CMs) as well, then you should ensure to configure SteamProtocols bot's property to a value that allows only websocket transport, i.e. a value of 4, as only websockets are supported for proxying.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

WebProxyPassword

string 타입으로 기본값은 null입니다. 이 속성값은 프록시 기능을 제공하는 대상 WebProxy 기기에서 지원하는 기본, digest, NTLM, Kerberos 인증에 사용되는 암호 필드를 정의합니다. 프록시가 사용자 자격증명을 필요로 하지 않는다면 여기에 아무것도 넣을 필요가 없습니다. WebProxy가 사용될 때 이 옵션의 사용도 의미가 있고, 그외에는 효과가 없습니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

WebProxyUsername

string 타입으로 기본값은 null입니다. 이 속성값은 프록시 기능을 제공하는 대상 WebProxy 기기에서 지원하는 기본, digest, NTLM, Kerberos 인증에 사용되는 사용자이름 필드를 정의합니다. 프록시가 사용자 자격증명을 필요로 하지 않는다면 여기에 아무것도 넣을 필요가 없습니다. WebProxy가 사용될 때 이 옵션의 사용도 의미가 있고, 그외에는 효과가 없습니다.

이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

---

파일 구조

ASF는 꽤 간단한 파일구조를 사용합니다.

├── 📁 config
│     ├── ASF.json
│     ├── ASF.db
│     ├── Bot1.json
│     ├── Bot1.db
│     ├── Bot2.json
│     ├── Bot2.db
│     └── ...
├── ArchiSteamFarm.dll
├── log.txt
└── ...

ASF를 다른 PC 등 새로운 위치로 옮기려면 config 디렉토리 하나만을 이동/복사하는 것으로 충분합니다. 그리고 이것이 "ASF 백업"으로 권장되는 방법입니다. 잘못된 백업 등으로 ASF 내부파일을 오염시킬 위험을 감수하지 않고 프로그램 등 다른 부분은 GitHub에서 항상 다운받을 수 있기 때문입니다.

log.txt 파일은 마지막 ASF 실행으로 생성된 로그를 담고 있습니다. 이 파일은 어떠한 민감한 정보도 포함하고 있지 않으며, 이슈나 충돌, 혹은 지난번 ASF 실행에서 무슨일이 있었는지 정보로써도 굉장히 가치가 있습니다. 이슈나 버그가 발생하면 우리는 이 파일을 자주 요청하게 될 것입니다. ASF automatically manages this file for you, but you can further tweak ASF logging module if you're advanced user.

config 디렉토리는 ASF와 모든 봇의 환경설정을 담고있는 곳입니다.

ASF.json은 ASF의 일반 환경설정 파일입니다. 이 환경설정은 모든 봇과 프로그램 자체에 영향을 주는 ASF 프로세스 행동을 특정하는데 사용됩니다. ASF 프로세스 소유자, 자동업데이트, 디버깅 등 일반 속성값이 있습니다.

봇이름.json은 봇 인스턴스의 환경설정입니다. 이 환경설정은 봇 인스턴스가 어떻게 행동할지를 특정하는데 사용됩니다. 따라서 설정은 그 봇에만 특정되고 다른 봇에 공유되지 않습니다. 이렇게 해서 여러 봇을 다양하고 다르게 설정할 수 있으며 정확하게 동일하게 동작하도록 할 필요가 없습니다. 모든 봇은 유일한 식별자를 이름으로 사용해야 합니다. 이는 봇이름에 들어갑니다.

환경설정 파일과 별도로 ASF는 config 디렉토리를 데이터베이스를 저장하는데도 사용합니다.

ASF.db는 일반 ASF 데이터베이스 파일입니다. 일반 영구 저장소 역할을 하며 Steam 서버의 IP 등 ASF 프로세스와 관련된 다양한 정보를 저장하는데 사용됩니다. 이 파일을 수정해서는 안됩니다.

봇이름.db는 봇 인스턴스의 데이터베이스입니다. 이 파일은 봇 인스턴스와 관련된 로그인 키나 ASF 2단계 인증과 같은 영구 저장소의 중요한 데이터를 저장하는데 사용됩니다. 이 파일을 수정해서는 안됩니다.

BotName.keys is a special file that can be used for importing keys into background games redeemer. 이 파일은 필수사항도 아니고 생성되지도 않지만 ASF가 인식은 합니다. 이 파일은 키를 성공적으로 불러온 다음 자동으로 삭제됩니다.

BotName.maFile is a special file that can be used for importing ASF 2FA. 이 파일은 필수사항도 아니고 생성되지도 안지만 봇이름이 ASF 2단계 인증을 사용하지 않는경우 ASF가 인식합니다. 이 파일은 ASF 2단계 인증을 성공적으로 불러온 다음 자동으로 삭제됩니다.

---

JSON 매핑

모든 환경설정 속성값은 타입이 있습니다. 속성값의 타입은 유효한 값을 정의합니다. 주어진 타입에 유효한 값만 사용할 수 있습니다. 유효하지 않은 값을 사용하면 ASF는 환경설정을 수행할 수 없습니다.

환경설정을 생성하기 위해 ConfigGenerator를 사용하는 것을 강력하게 권장합니다. 타입 유효성 검증 등의 로우 레벨 대부분을 다루므로 적절한 값을 넣기만 하면 되고, 아래에 명시된 변수 타입을 이해할 필요가 없습니다. 이 항목은 주로 수동으로 환경설정을 생성하거나 변경하는 사람을 위한 것으로, 이 사람들은 사용할 수 있는 값이 어떤 것인지 압니다.

ASF가 사용하는 타입은 네이티브 C# 타입으로, 아래에 설명되어 있습니다.

---

bool - true와 false 값만 받는 불린타입입니다.

예: "Enabled": true

---

byte - 0부터 255 까지의 정수만 받는 Unsigned 바이트 타입입니다.

예: "ConnectionTimeout": 90

---

ushort - 0부터 65535 까지의 정수만 받는 Unsigned short 타입입니다.

예: "WebLimiterDelay": 300

---

uint - 0부터 4294967295 까지의 정수만 받는 Unsigned 정수 타입입니다.

---

ulong - 0부터 18446744073709551615 까지의 정수만 받는 Unsigned long 정수 타입입니다.

예: "SteamMasterClanID": 103582791440160998

---

string - ""의 빈 문자열과 null 값을 포함하는 어떠한 일련의 문자를 받는 문자열 타입입니다. Empty sequence and null value are treated the same by ASF, so it's up to your preference which one you want to use (we stick with null).

예: "SteamLogin": null, "SteamLogin": "", "SteamLogin": "MyAccountName"

---

Guid? - Nullable UUID type, in JSON encoded as string. UUID is made out of 32 hexadecimal characters, in range from 0 to 9 and a to f. ASF accepts variety of valid formats - lowercase, uppercase, with and without dashes. In addition to valid UUID, since this property is nullable, a special value of null is accepted to indicate lack of UUID to provide.

Examples: "LicenseID": null, "LicenseID": "f6a0529813f74d119982eb4fe43a9a24"

---

ImmutableList<valueType> - Immutable collection (list) of values in given valueType. JSON에서는 주어진 valueType을 요소로 하는 배열의 형태로 정의됩니다. ASF uses List to indicate that given property supports multiple values and that their order might be relevant.

Example for ImmutableList<byte>: "FarmingOrders": [15, 11, 7]

---

ImmutableHashSet<valueType> - Immutable collection (set) of unique values in given valueType. JSON에서는 주어진 valueType을 요소로 하는 배열의 형태로 정의됩니다. ASF uses HashSet to indicate that given property makes sense only for unique values and that their order doesn't matter, therefore it'll intentionally ignore any potential duplicates during parsing (if you happened to supply them anyway).

ImmutableHashSet<uint>의 예: "Blacklist": [267420, 303700, 335590]

---

ImmutableDictionary<keyType, valueType> - Immutable dictionary (map) that maps a unique key specified in its keyType, to value specified in its valueType. JSON에서는 키-값 쌍으로 된 오브젝트로 정의됩니다. 이 경우 keyType는 심지어 ulong같은 타입이더라도 항상 따옴표로 표시함을 명심하십시오. There is also a strict requirement of the key being unique across the map, this time enforced by JSON as well.

ImmutableDictionary<ulong, byte>의 예: "SteamUserPermissions": { "76561198174813138": 3, "76561198174813137": 1 }

---

flags - 플래그는 여러 다른 속성값을 비트 연산을 통해 하나의 최종값으로 조합합니다. 이렇게 해서 동시에 허용된 여러 다른 값을 가능한 어느 조합이라도 선택할 수 있습니다. 최종값은 모든 활성화된 옵션 값의 합계로 만들어집니다.

For example, given following definition:

값	이름
0	없음(None)
1	A
2	B
4	C

There are exactly 3 meaningful, available flags to switch on/off (A, B, C), and therefore 8 possible valid combinations overall:

Final value	Enabled flags
0	없음(None)
1	A
2	B
3	A + B
4	C
5	A + C
6	B + C
7	A + B + C

By definition, in order to make the above possible, each standalone flag must therefore be the power of two. This is why additional flag in above example, D, would need to carry value of 8 or greater.

Usually, graphical tools will do the calculation for you. If you're editing configs manually, you can always use calculator and simply add together underlying values of all the flags you want to enable - like in example above.

Example: "SteamProtocols": 7 (which enables flags with value of 1, 2 and 4, as explained above)

---

호환성 매핑

Due to JavaScript limitations of being unable to properly serialize simple ulong fields in JSON when using web-based ConfigGenerator, ulong fields will be rendered as strings with s_ prefix in the resulting config. This includes for example "SteamOwnerID": 76561198006963719 that will be written by our ConfigGenerator as "s_SteamOwnerID": "76561198006963719". ASF는 이 문자열 매핑을 자동으로 처리할 수 있는 적절한 논리구조를 가지고 있으며, 환경설정의 s_ 항목은 실제로 유효하고 정확하게 생성된 것입니다. 만약 환경설정을 스스로 생성한다면, 가능하면 원래의 ulong 항목을 사용하기를 권장하지만 그럴수 없다면 이름에 s_ 접두사를 붙여서 문자열로 인코딩하는 방식을 사용할 수도 있습니다. 이 자바 스크립트 한계가 해결되기를 바랍니다.

---

환경설정 호환성

It's top priority for ASF to remain compatible with older configs. As you should already know, missing config properties are treated the same as they would be defined with their default values. 따라서 새 환경설정 속성값이 ASF 새버전에 도입되면, 당신의 모든 환경설정은 새 버전과 호환됩니다. ASF는 새로운 환경설정 속성값을 기본값으로 정의된 것으로 처리합니다. 언제나 필요에 따라 환경설정 속성값을 추가하고, 제거하고, 변경할 수 있습니다.

정의된 환경설정 속성값을 변경하기를 원하는 것으로만 제한하는 것을 권장합니다. 이렇게 해서 자동으로 다른 모든 속성값을 기본값으로 상속받을 수 있고, 환경설정을 깨끗하게 유지하고 당신이 스스로 명시적으로 설정하고 싶지 않은 속성값을 우리가 기본값으로 변경하길 원하는 경우에 호환성을 증가시킬 수 있습니다(예: WebLimiterDelay).

Due to above, ASF will automatically migrate/optimize your configs by reformatting them and removing fields that hold default value. You can disable this behaviour with --no-config-migrate command-line argument if you have a specific reason, for example you're providing read-only config files and you don't want ASF to modify them.

---

자동 재시작

ASF is aware of configs being modified "on-the-fly" - thanks to that, ASF will automatically:

• 새로운 봇 환경설정을 만드는 경우 그 봇 인스턴스의 생성 및 시작(필요한 경우)
• 예전 봇 환경설정을 삭제하는 경우 그 봇 인스턴스의 중지(필요한 경우) 및 제거
• 봇 환경설정을 수정하는 경우 그 봇 인스턴스의 중지 및 시작(필요한 경우)
• 봇 환경설정 이름을 변경하는 경우 새 이름으로 봇 재시작(필요한 경우)

위의 모든 것은 투명하고 프로그램의 재시작이나 다른 영향이 없는 봇 인스턴스의 중지 없이 자동으로 수행됩니다.

In addition to that, ASF will also restart itself (if AutoRestart permits) if you modify core ASF ASF.json config. Likewise, program will quit if you delete or rename it.

You can disable this behaviour with --no-config-watch command-line argument if you have a specific reason, for example you don't want from ASF to react to file changes in config folder.