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 버전에는 아직 패치되지 않은 버그, 개발 중인 기능, 또는 새로 작성된 구현이 포함되어 있는 경우가 많습니다. 스스로를 고급 사용자라고 생각하지 않는다면, 기본값인 1(Stable) 업데이트 채널을 유지하시기 바랍니다. PreRelease 채널은 버그를 신고하는 법을 알고, 문제를 처리하며, 피드백을 줄 수 있는 사용자를 위한 채널입니다 - 기술 지원은 제공되지 않습니다. 더 알고 싶다면 ASF의 릴리스 주기 를 참고하십시오. 모든 버전확인을 완전히 제거하고 싶다면 UpdateChannel을 0(없음(None))으로 설정할 수도 있습니다. UpdateChannel을 0으로 설정하면 update 명령을 포함한 업데이트와 관련된 모든 기능을 모두 비활성화합니다. 아래의 UpdatePeriod 설명에서 언급하는 모든 종류의 문제에 노출되므로 없음(None) 채널은 하지 않기를 강력하게 권고합니다.

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

`UpdatePeriod`

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

업데이트 과정에서는 ASF가 사용 중인 폴더 구조 전체가 갱신되지만, config 디렉토리에 있는 사용자 본인의 설정 파일이나 데이터베이스는 건드리지 않습니다 - 즉, ASF 디렉토리 내에 있는 ASF와 관련 없는 추가 파일들은 업데이트 과정에서 손실될 수 있습니다. 기본값인 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을 넘지 않을 것입니다.

일반적으로 WebLimiterDelay를 기본값보다 낮추는 것은 강력히 권장되지 않습니다. IP 관련 차단으로 이어질 수 있으며, 이 중 일부는 영구적일 수 있습니다. 기본값은 서버에서 단일 ASF 인스턴스를 실행하는데도 충분하고, 원본 Steam 클라이언트와 함께 ASF를 정상적인 시나리오대로 사용하는데도 충분합니다. 대부분의 경우 기본값이 적절하며, 값을 조정해야 한다면 낮추지 말고 늘리기만 해야 합니다. 즉, 단일 IP에서 단일 Steam 도메인으로 보내지는 모든 요청의 전체 숫자는 절대 300 ms 당 1개 요청을 초과해서는 안됩니다.

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

`WebProxy`

string 타입으로 기본값은 null입니다. 이 속성은 내부 http 관련 통신, 특히 github.com, api.steampowered.com, steamcommunity.com, store.steampowered.com과 같은 서비스에 사용될 웹 프록시 주소를 정의합니다. 이 설정은 일반(봇에 국한되지 않는) 통신뿐만 아니라, 해당 봇의 WebProxy 설정 속성이 지정되어 있지 않은 경우 봇별 통신에도 적용됩니다. ASF 요청을 프록시를 통해 전달하는 것은 다양한 종류의 방화벽, 특히 중국의 만리방화벽을 우회하는 데 매우 유용할 수 있습니다.

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

URI 문자열은 스킴(프로토콜)(지원 형식: http/https/socks4/socks4a/socks5), 호스트, 그리고 선택 사항인 포트로 구성됩니다. 다음은 완전한 uri 문자열의 예시입니다. "http://contoso.com:8080".

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

내부 Steam 네트워크 통신(CM)도 프록시로 우회시키고자 한다면, 봇의 SteamProtocols 속성을 오직 websocket 전송만 허용하는 값, 즉 4로 설정해야 합니다. 프록시로는 websocket만 지원되기 때문입니다.

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

`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)	특별한 봇 동작 없음, 무난한 기본 설정
1	유효하지 않은 친구초대 거절(RejectInvalidFriendInvites)	ASF는 유효하지 않은 친구 초대를 거절합니다.(무시 아님)
2	유효하지 않은 거래 거절(RejectInvalidTrades)	ASF는 유효하지 않은 거래 제안을 거절합니다.(무시 아님)
4	유효하지 않은 그룹 초대 거절(RejectInvalidGroupInvites)	ASF는 유효하지 않은 그룹 초대를 거절합니다.(무시 아님)
8	보관함 알림 해제(DismissInventoryNotifications)	ASF가 모든 보관함 알림을 자동으로 해제합니다.
16	받은 메시지 읽은상태로 표시(MarkReceivedMessagesAsRead)	ASF가 모든 도착한 메시지를 자동으로 읽은 상태로 표시합니다.
32	봇 메시지 읽은상태로 표시 (MarkBotMessagesAsRead)	ASF가 (같은 인스턴스에서 실행 중인) 다른 ASF 봇으로부터 온 메시지를 자동으로 읽음 처리하도록 합니다.
64	들어오는 거래 파싱 비활성화 (DisableIncomingTradesParsing)	ASF가 들어오는 거래 제안(trade offer)을 절대 처리하지 않도록 합니다.

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 자세히 알고 싶다면 **json mapping**을 참고하세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

일반적으로 봇 활동과 관련된 다양한 자동화 설정을 변경하고자 할 때 이 속성을 수정하게 됩니다. 기본 설정은 ASF가 비침해적(non-invasive) 모드로 실행되도록 되어 있으며, 이는 사용자의 의사에 반하지 않는 유익한 자동화만을 허용합니다.

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

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

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

DismissInventoryNotifications는 새 아이템 수신에 대한 Steam 알림이 계속 떠서 거슬리기 시작할 때 매우 유용합니다. 이 알림은 Steam 클라이언트에 내장되어있기 때문에 ASF가 이 알림을 없앨수는 없지만, 알림을 받은 후 이를 자동으로 클리어 할 수는 있으며, "새로운 보관함 항목" 알림을 놔두지 않아도 됩니다. 수신한 모든 아이템(특히 ASF로 파밍한 카드)을 직접 확인할 계획이라면, 당연히 이 옵션을 활성화해서는 안 됩니다. 미쳐가고 있다면 이 옵션이 있음을 기억하십시오.

MarkReceivedMessagesAsRead는 ASF가 실행 중인 계정이 수신하는 모든 메시지(개인 및 그룹 채팅 포함)를 자동으로 읽음 처리합니다. 이는 보통 부계정에서 ASF 명령어 수행중에 자신이 보낸 "새로운 메시지"를 클리어하기 위해서만 사용합니다. 당신은 오프라인이지만 ASF는 여전히 알림을 해제하고 있었던 메시지를 포함한 모든 종류의 새로운 메시지 알림을 잘라내버리고 싶지 않는 한, 이 옵션을 주 계정에서 사용하는 것을 권장하지 않습니다.

MarkBotMessagesAsRead는 이와 유사한 방식으로 작동하지만, 봇 메시지만 읽음 처리합니다. 다만, 봇과 다른 사용자가 함께 있는 그룹 채팅에서 이 옵션을 사용할 경우, Steam의 채팅 메시지 확인(acknowledge) 방식은 읽음 처리하려는 메시지 이전에 발생한 모든 메시지 또한 함께 확인 처리한다는 점에 유의하세요. 따라서 그 사이에 발생한 관련 없는 메시지를 놓치고 싶지 않다면, 일반적으로 이 기능을 사용하지 않는 것이 좋습니다. 당연히, 같은 ASF 인스턴스에서 여러 개의 주 계정(예: 서로 다른 사용자의 계정)을 운용 중인 경우에도 위험할 수 있습니다. ASF와 무관한 일반 메시지를 놓칠 수 있기 때문입니다.

DisableIncomingTradesParsing는 ASF가 들어오는 거래 제안을 파싱하지 않도록 합니다. 즉, 이와 관련된 거래 기능 전체가 작동하지 않게 됩니다. ASF는 기본적으로 최소 침해 모드로 동작하여 Master 이상 권한의 사용자가 보낸 거래 제안만 수락하고 그 외의 거래 제안은 건드리지 않습니다 - 따라서 들어오는 거래 파싱은 기본적으로 활성화되어 있습니다. 이 설정은 거래 파싱과 관련된 추가 요청/오버헤드가 발생하지 않도록 관련 로직 전체를 비활성화하고 싶은 사용자에게 가장 적합합니다. 예를 들어, 자신의 봇이 master로부터 거래 요청을 받을 일이 전혀 없어서 거래 활동에 ASF가 관여할 필요가 아예 없다는 것을 아는 경우가 이에 해당합니다. 이 옵션을 지정하면 AcceptDonations나 SteamTradeMatcher처럼 들어오는 거래에 의존하는 다른 옵션들도 모두 함께 비활성화된다는 점에 유의하세요 - 커스텀 플러그인 또한 들어오는 거래 제안을 평소 방식대로 처리할 수 없게 됩니다.

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

`CompleteTypesToSend`

ImmutableHashSet<byte> 타입으로 기본값은 비어있습니다. ASF가 여기서 지정한 아이템 타입의 세트를 완성하면, Master 권한을 가진 사용자에게 완성된 세트 전체를 Steam 거래로 자동 전송할 수 있습니다. 예를 들어 해당 봇 계정을 STM 매칭 용도로 활용하면서 완성된 세트는 다른 계정으로 옮기고 싶을 때 매우 편리합니다. 이 옵션은 loot 명령어와 동일하게 작동합니다. 따라서 Master 권한이 설정된 사용자가 필요하며, 유효한 SteamTradeToken이 필요할 수도 있고, 애초에 거래가 가능한 계정을 사용해야 한다는 점에 유의하세요.

현재 이 설정에서 지원되는 아이템 타입은 다음과 같습니다:

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

위 설정과 관계없이 ASF는 Steam 커뮤니티 아이템(appID 753, contextID 6)만 요청한다는 점에 유의하세요. 따라서 게임 아이템, 선물 등은 거래 제안 대상에서 원래부터 제외됩니다.

이 옵션은 추가적인 오버헤드가 발생하므로, 세트를 스스로 완성할 가능성이 실질적으로 있는 봇 계정에만 사용하는 것을 권장합니다 - 예를 들어, 이미 FarmingPreferences의 SendOnFarmingFinished 설정이나 SendTradePeriod, 혹은 loot 명령어를 평소에 사용하고 있다면 이 옵션을 활성화하는 것은 의미가 없습니다.

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

`CustomGamePlayedWhileFarming`

string 타입으로 기본값은 null입니다. ASF가 농사를 짓는 동안 현재 농사짓는 게임 대신 "CustomGamePlayedWhileFarming을 플레이중"으로 표시합니다. 이것은 친구들에게 자신이 농사를 짓는 중이라고 알려주고는 싶지만 기본 OnlineStatus를 오프라인으로 사용하고 싶지는 않을때 유용합니다. ASF는 Steam 네트워크의 실제 표시 순서를 보장하지 않습니다. 정확하게, 혹은 부정확하게 표시될 수 있는 제안일 뿐입니다. 특히, ASF가 32개 슬롯을 모두 시간 누적이 필요한 게임으로 채우는 경우, Complex 파밍 알고리즘에서는 커스텀 이름이 표시되지 않습니다. 기본값 null은 이 기능을 비활성화 합니다.

ASF는 텍스트에 선택적으로 사용할 수 있는 몇 가지 특수 변수를 제공합니다. {0}은 ASF에 의해 현재 파밍 중인 게임의 AppID로 대체되며, {1}은 현재 파밍 중인 게임의 GameName으로 대체됩니다.

`CustomGamePlayedWhileIdle`

string 타입으로 기본값은 null입니다. CustomGamePlayedWhileFarming와 비슷하지만 농사가 끝난 계정 등 ASF가 할 일이 없을 경에 사용합니다. ASF는 Steam 네트워크의 실제 표시 순서를 보장하지 않습니다. 정확하게, 혹은 부정확하게 표시될 수 있는 제안일 뿐입니다. 이 옵션과 함께 GamesPlayedWhileIdle을 사용하는 경우, GamesPlayedWhileIdle이 우선순위를 가진다는 점에 유의하세요. 따라서 31개를 초과해서 지정할 수 없으며, 그렇지 않으면 CustomGamePlayedWhileIdle이 커스텀 이름을 위한 슬롯을 차지할 수 없게 됩니다. 기본값 null은 이 기능을 비활성화 합니다.

`Enabled`

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

`FarmingOrders`

ImmutableList<byte> 타입이며 기본값은 빈 상태입니다. 이 속성값은 해당 봇 계정에서 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 측의 일시적인, 혹은 심지어 영구적인 차단과 같은 원치 않는 결과를 초래할 수도 있습니다. 따라서 미리 경고드리며, 이 옵션은 그 어떤 보증도 제공하지 않습니다. 사용은 전적으로 본인의 책임입니다.

AutoUnpackBoosterPacks는 새 아이템 수신 알림을 받는 즉시 모든 부스터 팩을 자동으로 개봉합니다. 이를 통해 추가 카드 드롭을 즉시 획득할 수 있으며, 특히 SteamTradeMatcher나 CompleteTypesToSend와 같은 다른 옵션과 함께 사용할 경우 유용한 시나리오가 될 수 있습니다.

`GamesPlayedWhileIdle`

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. ASF가 농사지을 것이 없다면 대신 특정 게임(appIDs)을 플레이할 수 있습니다. 이 방법으로 플레이하면 "플레이한 시간"을 늘릴 수 있지만, 그게 끝입니다. 이 기능이 제대로 작동하려면, 사용자의 Steam 계정이 여기서 지정한 모든 appID에 대한 유효한 라이선스를 반드시 보유하고 있어야 합니다. 이는 F2P 게임도 포함됩니다. 이 기능은 Steam 네트워크에서 사용자정의 상태를 보여주면서 선택한 게임을 플레이하기 위해 CustomGamePlayedWhileIdle와 동시에 활성화 될 수 있습니다. 하지만 이 경우 CustomGamePlayedWhileFarming의 경우와 같이 실제 표시 순서는 보장하지 않습니다. Steam은 ASF가 총 32개의 appIDs를 플레이 할 수 있도록 허락하고 있으며, 따라서 이 속성값에 그만큼을 넣을 수 있습니다.

`GamingDeviceType`

ushort 타입이며 기본값은 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	Steam 채팅에서 사용할 수 있는 특수 아이템
11	ChatEffect	Steam 채팅에서 사용할 수 있는 특수 아이템
12	MiniProfileBackground	Steam 프로필용 특수 배경화면
13	아바타 액자(AvatarProfileFrame)	Steam 프로필용 특수 아바타 액자
14	움직이는 아바타(AnimatedAvatar)	Steam 프로필용 특수 움직이는 아바타
15	KeyboardSkin	Steam Deck용 특수 키보드 스킨
16	StartupVideo	Steam Deck용 특수 부팅 영상

위 설정과 관계없이 ASF는 Steam 커뮤니티 아이템(appID 753, contextID 6)만 요청한다는 점에 유의하세요. 따라서 게임 아이템, 선물 등은 거래 제안 대상에서 원래부터 제외됩니다.

ASF의 기본 설정은 봇의 가장 일반적인 사용 방식을 기준으로 하며, 부스터 팩과 (foil 포함) 트레이딩 카드만을 loot 대상으로 합니다. 여기 정의된 속성값은 당신을 만족시킬수 있도록 어떻게든 행동을 변경할 수 있게 합니다. 위에 정의되지 않은 모든 타입은 알 수 없음(Unknown) 타입으로 표시됨을 명심하십시오. Valve가 새로운 Steam 아이템을 내놓았을때 특히 중요한데, 향후 릴리스에서 여기에 추가되기 전까지는 ASF에서 알 수 없음(Unknown) 으로 표시될 것입니다. 이것이 당신이 무엇을 하고 있는지를 알고 있고, 만약 Steam 네트워크가 깨져서 모든 항목을 알 수 없음(Unknown)으로 표시한다면 ASF는 전체 보관함을 거래 제안으로 보낼것이라는 점도 이해하고 있지않는 한, 일반적으로 알 수 없음(Unknown) 타입을 LootableTypes에 포함시키는 것을 권장하지 않는 이유입니다. 다른 모든 것을 loot 대상으로 하고 싶더라도, LootableTypes에 Unknown 타입은 포함하지 않을 것을 강력히 권장합니다.

`MachineName`

string 타입으로 기본값은 null입니다. ASF는 Steam 네트워크에 로그인할 때 이 속성을 사용하며, 예를 들어 **여기**처럼 현재 로그인된 기기 목록을 표시할 때 Steam이 ASF 기기와 세션을 정확히 어떻게 표시할지 사용자화하는 데 활용할 수 있습니다.

ASF는 텍스트에 선택적으로 사용할 수 있는 몇 가지 특수 변수를 제공합니다. {0}은 OS가 제공하는 기기 이름으로, {1}은 ASF의 공개 식별자로, {2}는 ASF의 버전으로 대체됩니다.

정확히 무엇을 하는지 알고 있는 경우가 아니라면, 기본값인 null을 그대로 유지해야 합니다. 이 경우 ASF가 내부적으로 적절한 값을 결정하며, 현재 기준으로는 {0} ({1}/{2}) 형식입니다. 이는 어디까지나 제안일 뿐이며, Steam 네트워크가 이를 완전히 반영할 수도, 반영하지 않을 수도 있다는 점에 유의하세요.

`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)	Steam 채팅에서 사용할 수 있는 특수 아이템
11	채팅 효과(ChatEffect)	Steam 채팅에서 사용할 수 있는 특수 아이템
12	미니 프로필 배경(MiniProfileBackground)	Steam 프로필용 특수 배경화면
13	아바타 액자(AvatarProfileFrame)	Steam 프로필용 특수 아바타 액자
14	움직이는 아바타(AnimatedAvatar)	Steam 프로필용 특수 움직이는 아바타
15	키보드 스킨(KeyboardSkin)	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	`BadActivationCode` 키를 `CannotRedeemCodeFromClient`와 동일한 것으로 간주하여, 지갑 키(wallet key)로 등록을 시도합니다.

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 자세히 알고 싶다면 **json mapping**을 참고하세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

Forwarding은 등록할 수 없는 키를 해당 게임을 보유하지 않은 다른 연결되어 로그인 중인 봇에게 전달합니다 (확인이 가능한 경우). 가장 흔한 경우는 AlreadyPurchased(이미 구매한 게임)를 해당 게임이 없는 다른 봇에게 전달하는 것이지만, 이 옵션은 DoesNotOwnRequiredApp, RateLimited, RestrictedCountry 등 다른 상황도 함께 처리합니다.

Distributing은 봇이 받은 모든 키를 자기 자신과 다른 봇들에게 나누어 분배하도록 합니다. 즉, 각 봇이 배치(batch)에서 키를 하나씩 받게 됩니다. 이는 일반적으로 여러 가지 다른 게임의 키를 등록하는 경우가 아니라, 동일한 게임의 키를 여러 개 등록하면서 봇들에게 고르게 분배하고 싶을 때만 사용됩니다. 이 기능은 한 번의 redeem 작업에서 키를 단 하나만 등록하는 경우에는 의미가 없습니다 (분배할 추가 키가 없기 때문입니다).

KeepMissingGames는 등록 중인 키가 실제로 본인의 봇이 보유한 것인지 확실하지 않은 경우 Forwarding을 건너뛰도록 합니다. 즉, Forwarding은 DoesNotOwnRequiredApp, RateLimited, RestrictedCountry 등 다른 경우도 함께 처리하는 대신, AlreadyPurchased 키만 적용됩니다. 일반적으로 이 옵션은 주 계정에서 사용하며, 봇이 일시적으로 RateLimited 상태가 되더라도 해당 계정에서 등록 중인 키가 다른 곳으로 전달되지 않도록 보장하기 위한 용도입니다. 설명에서 짐작할 수 있듯이, Forwarding이 활성화되어 있지 않으면 이 필드는 아무런 효과가 없습니다.

AssumeWalletKeyOnBadActivationCode는 BadActivationCode 키를 CannotRedeemCodeFromClient로 간주하도록 하여, ASF가 이를 지갑 키(wallet key)로 등록을 시도하게 만듭니다. 이는 Steam이 지갑 키를 (기존처럼 CannotRedeemCodeFromClient가 아니라) BadActivationCode로 알리는 경우가 있어서, 이로 인해 ASF가 해당 키를 아예 등록 시도조차 하지 않게 되는 것을 방지하기 위해 필요합니다. 다만, 이 설정을 사용하지 않을 것을 권장합니다. 모든 유효하지 않은 키를 지갑 코드로 등록 시도하게 되어, (잠재적으로 유효하지 않은) 과도한 요청이 Steam 서비스로 전송되며 그로 인한 여러 잠재적 문제가 발생할 수 있기 때문입니다. 대신, 지갑 키를 등록한다는 것을 알고 있는 경우에는 ForceAssumeWalletKey redeem^ 모드를 사용할 것을 권장합니다. 이 모드는 필요한 경우에만, 필요한 만큼만 해당 우회 처리를 활성화합니다.

Forwarding과 Distributing을 둘 다 활성화하면 forwarding 기능 위에 distributing 기능이 추가되어, ASF가 하나의 키를 모든 봇에 순서대로 먼저 등록 시도한 뒤(forwarding) 다음 키로 넘어가게 됩니다(distributing). 이 옵션은 일반적으로 Forwarding을 사용하고 싶지만, 매번 순서대로 모든 키를 처리하는 대신(이는 Forwarding만 사용할 때의 동작입니다) 키가 사용될 때마다 봇을 전환하는 방식으로 동작을 변경하고 싶을 때만 사용하면 됩니다. 이 동작 방식은 대부분 혹은 모든 키가 동일한 게임에 연결되어 있다는 것을 알고 있을 때 유용합니다. 이런 경우 Forwarding만 사용하면 먼저 한 봇에게 모든 것을 등록 시도하게 되는데(이는 각 키가 서로 다른 게임인 경우에 적합합니다), Forwarding + Distributing을 함께 사용하면 다음 키를 처리할 때 봇을 전환하여 새 키 등록 작업을 처음 봇이 아닌 다른 봇에게 "분배"합니다(이는 키가 모두 같은 게임인 경우, 키마다 발생하는 불필요한 시도 한 번을 건너뛸 수 있어 적합합니다).

모든 등록 시나리오에서 실제 봇 순서는 알파벳순이며, 사용할 수 없는 봇(연결되지 않음, 중지됨 등)은 제외됩니다. IP별 및 계정별로 시간당 등록 시도 횟수 제한이 있으며, OK로 끝나지 않은 모든 등록 시도는 실패한 시도로 집계된다는 점에 유의하세요. ASF는 AlreadyPurchased 실패 횟수를 최소화하기 위해 최선을 다합니다. 예를 들어 이미 해당 게임을 보유한 다른 봇에게 키를 전달하지 않도록 시도하지만, Steam의 라이선스 처리 방식으로 인해 항상 보장되지는 않습니다. Forwarding이나 Distributing과 같은 등록 플래그를 사용하면 RateLimited에 걸릴 가능성이 항상 높아집니다.

또한 접근 권한이 없는 봇에게는 키를 전달하거나 배포할 수 없다는 점도 유의하세요. 당연한 이야기지만, 예를 들어 status ASF **명령어**를 사용해서 등록 과정에 포함하려는 모든 봇에 대해 최소 Operator 권한을 가지고 있는지 확인하세요.

`RemoteCommunication`

byte flags 타입으로 기본값은 3입니다. 이 속성은 원격 제3자 서비스와의 통신에 대한 봇별 ASF 동작을 정의하며, 다음과 같이 구성됩니다:

값	이름	설명
0	없음(None)	제3자와의 통신이 전혀 허용되지 않으며, 이로 인해 일부 ASF 기능을 사용할 수 없게 됩니다.
1	SteamGroup	ASF의 Steam 그룹과의 통신을 허용합니다
2	PublicListing	사용자가 `TradingPreferences`에서 `SteamTradeMatcher`도 활성화한 경우, 등록(listing)을 위해 ASF의 STM listing과의 통신을 허용합니다

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 자세히 알고 싶다면 **json mapping**을 참고하세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

이 옵션은 ASF가 제공하는 모든 제3자 통신을 포함하지는 않으며, 다른 설정에서 암시적으로 포함되지 않는 통신만을 대상으로 합니다. 예를 들어, ASF의 자동 업데이트를 활성화한 경우, ASF는 설정에 따라 GitHub(다운로드용)와 저희 서버(체크섬 검증용) 양쪽 모두와 통신하게 됩니다. 마찬가지로, **TradingPreferences**에서 MatchActively를 활성화하면 등록된 봇 목록을 가져오기 위해 저희 서버와 통신하게 되며, 이는 해당 기능에 필수적입니다.

이 주제에 대한 자세한 설명은 remote communication 섹션에서 확인할 수 있습니다. 이 속성값을 변경해야 할 이유가 있지 않다면 기본값을 그대로 유지해야 합니다.

`SendTradePeriod`

byte 타입으로 기본값은 0입니다. 이 속성은 FarmingPreferences의 SendOnFarmingFinished 설정과 매우 유사하게 작동하지만, 한 가지 차이가 있습니다 - 파밍이 끝났을 때 거래를 보내는 대신, 남은 파밍량과 관계없이 SendTradePeriod 시간마다 거래를 보낼 수도 있습니다. 부계정의 농사가 끝날때까지 기다리는 대신 평소에 루팅 하고 싶은 경우 유용합니다. 기본값인 0은 이 기능을 비활성화합니다. 예를 들어 봇이 매일 거래를 보내길 원한다면 여기에 24를 넣으십시오.

일반적으로 이 기능은 **ASF 2FA**와 함께 사용하는 것이 권장되지만, 2FA 확인을 수동으로 제때 처리할 계획이라면 필수는 아닙니다. 이 속성값을 어떻게 설정해야 할지 모르겠다면, 기본값인 0으로 두십시오.

`SteamLogin`

string 타입으로 기본값은 null입니다. 이 속성값은 당신이 Steam에 로그인할때 사용하는 Steam 로그인 아이디를 정의합니다. 여기서 Steam 로그인 정보를 지정하는 대신, config에 저장하지 않고 ASF를 시작할 때마다 직접 입력하고 싶다면 기본값인 null을 유지해도 됩니다. 민감한 정보를 config 파일에 저장하고 싶지 않은 경우 유용할 수 있습니다.

`SteamMasterClanID`

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

`SteamParentalCode`

string 타입으로 기본값은 null입니다. 이 속성은 Steam 보호자 PIN을 정의합니다. ASF는 Steam 보호자 기능으로 보호된 리소스에 접근해야 하므로, 이 기능을 사용 중이라면 정상적으로 작동할 수 있도록 보호자 잠금 해제 PIN을 ASF에 제공해야 합니다. 기본값인 null은 이 계정을 잠금 해제하는 데 Steam 보호자 PIN이 필요하지 않다는 뜻이며, Steam 보호자 기능을 사용하지 않는다면 대체로 이 값을 그대로 두면 됩니다.

제한된 상황에서는 ASF가 유효한 Steam 보호자 코드를 직접 생성할 수도 있지만, 이는 과도한 OS 리소스와 추가 시간이 소요되며 성공이 보장되지도 않습니다. 따라서 이 기능에 의존하지 말고, ASF가 사용할 수 있도록 config에 유효한 SteamParentalCode를 직접 입력하는 것을 권장합니다. ASF가 PIN이 필요하다고 판단했지만 스스로 생성할 수 없는 경우, 사용자에게 입력을 요청합니다.

`스팀 암호(SteamPassword)`

string 타입으로 기본값은 null입니다. 이 속성값은 당신이 Steam에 로그인할때 사용하는 Steam 암호를 정의합니다. 여기서 Steam 비밀번호를 지정하는 대신, config에 저장하지 않고 ASF를 시작할 때마다 직접 입력하고 싶다면 기본값인 null을 유지해도 됩니다. 민감한 정보를 config 파일에 저장하고 싶지 않은 경우 유용할 수 있습니다.

`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)	특별한 권한 없음. 이는 주로 이 딕셔너리에 없는 Steam ID에 부여되는 기준값이며, 이 권한으로 누군가를 별도로 지정할 필요는 없습니다.
1	가족 공유(FamilySharing)	가족 공유 사용자에 대한 최소한의 접근만 제공합니다. 이 또한 참조용 값입니다. ASF는 라이브러리를 허용한 Steam ID를 자동으로 발견할 수 있습니다.
2	운영자(Operator)	주로 라이선스 추가와 키 등록과 같은 봇 인스턴스에 대한 기본적인 권한을 제공합니다.
3	주인(Master)	봇 인스턴스에 대한 전체 권한을 제공합니다.

간단하게 말하면 주어진 사용자에 대해 권한을 부여하는 속성값입니다. 권한은 ASF 명령어 에 접근할 때 중요하지만, 거래를 수락하는 것 같은 많은 ASF 기능을 활성화하는데도 중요합니다. 예를 들어 본인 계정을 Master로 설정하고, 친구 2~3명에게는 Operator 권한을 부여하여 ASF로 봇의 키를 쉽게 등록할 수 있게 하되, 봇을 중지시키는 것과 같은 작업은 할 수 없도록 할 수 있습니다. 사용자에게 권한을 쉽게 줄수 있으므로 당신의 봇을 특정행동을 하도록 허용할 수 있습니다.

정확히 한 사용자만을 주인(Master)으로, 그리고 필요한 만큼을 운영자(Operator) 및 그 이하로 설정하기를 권장합니다. 기술적으로는 여러 명의 Master를 설정할 수 있으며, ASF는 예를 들어 봇에게 전송된 모든 Master의 거래를 수락하는 방식으로 이들과 정상적으로 작동합니다. 다만 단일 대상이 필요한 작업(예: loot 요청, 그리고 FarmingPreferences의 SendOnFarmingFinished 설정이나 SendTradePeriod와 같은 속성)에서는 이들 중 (Steam ID가 가장 낮은) 한 명만 사용합니다. 이러한 제약사항, 특히 loot 요청이 실제로 명령을 실행한 Master와 관계없이 항상 Steam ID가 가장 낮은 Master에게 아이템을 전송한다는 점을 완전히 이해하고 있다면, 여기에 여러 명의 Master 권한 사용자를 지정할 수 있습니다. 다만 단일 master 방식을 여전히 권장합니다.

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

`TradeCheckPeriod`

byte 타입으로 기본값은 60입니다. 일반적으로 ASF는 거래 제안 알림을 받은 직후 이를 처리하지만, 간혹 Steam 오류로 인해 그 시점에 처리하지 못하는 경우가 있습니다. 이 경우 다음 거래 알림이나 봇 재시작이 발생할 때까지 해당 거래 제안이 처리되지 않고 방치되며, 이로 인해 거래가 취소되거나 이후 시점에 아이템을 사용할 수 없게 될 수 있습니다. 이 매개변수를 0이 아닌 값으로 설정하면, ASF는 TradeCheckPeriod분마다 이러한 미처리 거래를 추가로 확인합니다. 기본값은 Steam 서버에 대한 추가 요청과 들어오는 거래를 놓칠 가능성 사이의 균형을 고려하여 선택되었습니다. 다만, ASF를 단순히 카드 파밍 용도로만 사용하고 들어오는 거래를 자동으로 처리할 계획이 없다면, 이 기능을 완전히 비활성화하기 위해 0으로 설정해도 됩니다. 반대로, 봇이 공개 ASF의 STM listing에 참여하거나 거래 봇으로서 다른 자동화 서비스를 제공하는 경우, 모든 거래를 적시에 처리할 수 있도록 이 매개변수를 15분 정도로 낮추는 것이 좋을 수 있습니다.

`TradingPreferences`

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

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

이 속성값은 flags 항목이므로, 가능한 여러 값을 조합할 수 있습니다. 더 자세히 알고 싶다면 **json mapping**을 참고하세요. 플래그를 활성화 하지 않으면 없음(None)과 같습니다.

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

`TransferableTypes`

ImmutableHashSet<byte> 타입으로 기본값은 1, 3, 5 Steam 아이템 타입입니다. 이 속성은 transfer 명령어 실행 시 봇 간 전송 대상으로 고려할 Steam 아이템 타입을 정의합니다. 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)	Steam 채팅에서 사용할 수 있는 특수 아이템
11	채팅방 효과(ChatEffect)	Steam 채팅에서 사용할 수 있는 특수 아이템
12	미니 프로필 배경(MiniProfileBackground)	Steam 프로필용 특수 배경
13	아바타 액자(AvatarProfileFrame)	Steam 프로필용 특수 아바타 액자
14	움직이는 아바타(AnimatedAvatar)	Steam 프로필용 특수 움직이는 아바타
15	키보드 스킨(KeyboardSkin)	Steam Deck용 특수 키보드 스킨
16	부팅 영상(StartupVideo)	Steam Deck용 특수 부팅 영상

위 설정과 관계없이 ASF는 Steam 커뮤니티 아이템(appID 753, contextID 6)만 요청한다는 점에 유의하세요. 따라서 게임 아이템, 선물 등은 거래 제안 대상에서 원래부터 제외됩니다.

ASF의 기본 설정은 봇의 가장 일반적인 사용 방식을 기준으로 하며, 부스터 팩과 (foil 포함) 트레이딩 카드만을 전송 대상으로 합니다. 여기 정의된 속성값은 당신을 만족시킬수 있도록 어떻게든 행동을 변경할 수 있게 합니다. 위에 정의되지 않은 모든 타입은 알 수 없음(Unknown) 타입으로 표시됨을 명심하십시오. Valve가 새로운 Steam 아이템을 내놓았을때 특히 중요한데, 향후 릴리스에서 여기에 추가되기 전까지는 ASF에서 알 수 없음(Unknown) 으로 표시될 것입니다. 이것이 당신이 무엇을 하고 있는지를 알고 있고, 만약 Steam 네트워크가 깨져서 모든 아이템을 알 수 없음(Unknown)으로 표시한다면 ASF는 전체 보관함을 거래 제안으로 보낼것이라는 점도 이해하고 있지않는 한, 일반적으로 알 수 없음(Unknown) 타입을 TransferableTypes에 포함시키는 것을 권장하지 않는 이유입니다. 모든 것을 전송하고 싶더라도 알 수 없음(Unknown) 타입을 TransferableTypes에 포함하지 않는 것을 강력하게 권장합니다.

`UseLoginKeys`

bool 타입으로 기본값은 true입니다. 이 속성은 해당 Steam 계정에 대해 ASF가 로그인 키(login key) 메커니즘을 사용할지 여부를 정의합니다. 로그인 키 메커니즘은 공식 Steam 클라이언트의 "로그인 정보 저장" 옵션과 매우 유사하게 작동합니다. 이를 통해 ASF는 다음 로그인 시도를 위해 일회용 임시 로그인 키를 저장하고 사용할 수 있으며, 해당 로그인 키가 유효한 동안에는 비밀번호, Steam Guard, 또는 2FA 코드를 입력할 필요가 사실상 없어집니다. 로그인 키는 BotName.db 파일에 저장되며 자동으로 업데이트됩니다. 이 때문에 ASF로 한 번만 성공적으로 로그인하면 그 이후에는 비밀번호/SteamGuard/2FA 코드를 다시 입력할 필요가 없습니다.

편의를 위해 로그인 키는 기본적으로 사용되며, 이를 통해 로그인할 때마다 SteamPassword, SteamGuard, 또는 (**ASF 2FA**를 사용하지 않는 경우) 2FA 코드를 입력할 필요가 없습니다. 로그인 키는 단 한 번만 사용할 수 있고 원래 비밀번호를 어떤 방식으로도 노출하지 않기 때문에 더 우수한 대안이기도 합니다. 이는 원래 Steam 클라이언트가 사용하는 방식과 정확히 동일합니다. Steam 클라이언트는 다음 로그인 시도를 위해 계정 이름과 로그인 키를 저장하며, 이는 ASF에서 UseLoginKeys와 함께 SteamLogin을 사용하고 SteamPassword를 비워두는 것과 사실상 동일합니다.

다만, 이런 사소한 부분까지 우려하는 사용자도 있을 수 있어, 이전 세션 종료 후 재개를 허용하는 어떠한 종류의 토큰도 ASF가 저장하지 않도록 보장하고 싶은 경우를 위해 이 옵션을 제공합니다. 이 경우 로그인을 시도할 때마다 전체 인증 절차가 필수가 됩니다. 이 옵션을 비활성화하면 공식 Steam 클라이언트에서 "로그인 정보 저장"을 체크하지 않은 것과 정확히 동일하게 작동합니다. 정확히 무엇을 하는지 알고 있는 경우가 아니라면, 기본값인 true를 그대로 유지해야 합니다.

`UserInterfaceMode`

byte 타입으로 기본값은 0입니다. 이 속성은 봇이 Steam 네트워크에 로그인한 후 알릴 사용자 인터페이스 모드를 지정합니다. OnlineStatus를 통해 접속 상태가 표시되도록 설정되어 있는 경우, 이 설정은 예를 들어 Steam 채팅에서 계정이 어떻게 표시되는지에 영향을 줄 수 있습니다. 현재 아래 모드 중 하나를 선택할 수 있습니다:

값	이름	설명
`0`	VGUI	기본 Steam 클라이언트 모드
`1`	Tenfoot	Big Picture 모드
`2`	Mobile	Steam 모바일 앱
`3`	Web	웹 브라우저 세션
`5`	MobileChat	Steam 모바일 채팅 앱

이 속성이 기반으로 하는 EUIMode 타입에는 더 많은 값이 존재하지만, 저희가 아는 한 현재로서는 아무런 효과가 없는 값들이라 가독성을 위해 제외했습니다. 또한, 추가 기능들이 활성화되어 있는 GamingDeviceType도 함께 확인해보시는 것을 추천드립니다.

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

`WebProxy`

string 타입으로 기본값은 null입니다. 이 속성은 봇별 내부 http 관련 통신, 특히 api.steampowered.com, steamcommunity.com, store.steampowered.com과 같은 서비스에 사용될 웹 프록시 주소를 정의합니다. 설정하지 않으면, ASF는 위에서 지정한 전역 WebProxy 설정을 대신 사용합니다. ASF 요청을 프록시로 우회시키는 것은 다양한 종류의 방화벽, 특히 중국의 만리방화벽을 우회하는 데 매우 유용할 수 있습니다.

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

URI 문자열은 스킴(프로토콜)(지원 형식: http/https/socks4/socks4a/socks5), 호스트, 그리고 선택 사항인 포트로 구성됩니다. 다음은 완전한 uri 문자열의 예시입니다. "http://contoso.com:8080".

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

내부 Steam 네트워크 통신(CM)도 프록시로 우회시키고자 한다면, 봇의 SteamProtocols 속성을 오직 websocket 전송만 허용하는 값, 즉 4로 설정해야 합니다. 프록시로는 websocket만 지원되기 때문입니다.

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

`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는 이 파일을 자동으로 관리해주지만, 고급 사용자라면 ASF 로깅 모듈을 추가로 조정할 수 있습니다.

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

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

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

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

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

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

BotName.keys는 **백그라운드 게임 등록기(background games redeemer)**에 키를 가져오는 데 사용할 수 있는 특수 파일입니다. 이 파일은 필수사항도 아니고 생성되지도 않지만 ASF가 인식은 합니다. 이 파일은 키를 성공적으로 불러온 다음 자동으로 삭제됩니다.

BotName.maFile은 **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 값을 포함하는 어떠한 일련의 문자를 받는 문자열 타입입니다. 빈 시퀀스와 null 값은 ASF에서 동일하게 처리되므로, 둘 중 어느 것을 사용할지는 개인 취향에 달려 있습니다 (저희는 null을 사용합니다).

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

Guid? - null을 허용하는(nullable) UUID 타입이며, JSON에서는 문자열로 인코딩됩니다. UUID는 0부터 9까지, 그리고 a부터 f까지의 32개 16진수 문자로 구성됩니다. ASF는 소문자, 대문자, 대시(-) 포함 여부 등 다양한 유효 형식을 허용합니다. 유효한 UUID 외에도, 이 속성은 nullable이므로 제공할 UUID가 없음을 나타내는 특수 값인 null도 허용됩니다.

예시: "LicenseID": null, "LicenseID": "f6a0529813f74d119982eb4fe43a9a24"

ImmutableList<valueType> - 지정된 valueType의 값들로 이루어진 불변(immutable) 컬렉션(리스트)입니다. JSON에서는 주어진 valueType을 요소로 하는 배열의 형태로 정의됩니다. ASF는 해당 속성이 여러 값을 지원하며 순서가 의미를 가질 수 있음을 나타내기 위해 List를 사용합니다.

ImmutableList<byte>의 예시: "FarmingOrders": [15, 11, 7]

ImmutableHashSet<valueType> - 지정된 valueType의 고유한(중복되지 않는) 값들로 이루어진 불변(immutable) 컬렉션(집합)입니다. JSON에서는 주어진 valueType을 요소로 하는 배열의 형태로 정의됩니다. ASF는 해당 속성이 고유한(중복되지 않는) 값에만 의미가 있으며 순서가 중요하지 않다는 것을 나타내기 위해 HashSet을 사용합니다. 따라서 (혹시라도 중복된 값을 입력했다면) 파싱 과정에서 이를 의도적으로 무시합니다.

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

ImmutableDictionary<keyType, valueType> - keyType으로 지정된 고유 키와 valueType으로 지정된 값을 매핑하는 불변 딕셔너리(맵)입니다. JSON에서는 키-값 쌍으로 된 오브젝트로 정의됩니다. 이 경우 keyType는 심지어 ulong같은 타입이더라도 항상 따옴표로 표시함을 명심하십시오. 맵 전체에서 키가 고유해야 한다는 엄격한 요구 사항이 있으며, 이번에는 JSON에 의해서도 강제됩니다.

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

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

예를 들어, 다음과 같은 정의가 있다고 가정해봅시다:

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

켜고 끌 수 있는 유효한 플래그는 정확히 3개(A, B, C)이며, 따라서 전체적으로 8가지의 유효한 조합이 가능합니다:

최종 값	활성화된 플래그
0	`없음(None)`
1	`A`
2	`B`
3	`A` + `B`
4	`C`
5	`A` + `C`
6	`B` + `C`
7	`A` + `B` + `C`

위 내용이 성립하려면, 정의상 각 개별 플래그는 반드시 2의 거듭제곱 값이어야 합니다. 이런 이유로 위 예시에서 추가되는 플래그인 D는 8 이상의 값을 가져야 합니다.

보통 그래픽 도구가 이 계산을 대신 해줍니다. config를 수동으로 편집하는 경우, 위 예시처럼 계산기를 사용해 활성화하려는 모든 플래그의 값을 단순히 더하면 됩니다.

예시: "SteamProtocols": 7 (위에서 설명한 대로 값이 1, 2, 4인 플래그를 활성화합니다)

호환성 매핑

웹 기반 ConfigGenerator 사용 시 JavaScript가 단순 ulong 필드를 JSON으로 제대로 직렬화하지 못하는 한계로 인해, ulong 필드는 결과 config에서 s_ 접두사가 붙은 문자열로 표시됩니다. 예를 들어 "SteamOwnerID": 76561198006963719는 저희 ConfigGenerator에 의해 "s_SteamOwnerID": "76561198006963719"로 작성됩니다. ASF는 이 문자열 매핑을 자동으로 처리할 수 있는 적절한 논리구조를 가지고 있으며, 환경설정의 s_ 항목은 실제로 유효하고 정확하게 생성된 것입니다. 만약 환경설정을 스스로 생성한다면, 가능하면 원래의 ulong 항목을 사용하기를 권장하지만 그럴수 없다면 이름에 s_ 접두사를 붙여서 문자열로 인코딩하는 방식을 사용할 수도 있습니다. 이 자바 스크립트 한계가 해결되기를 바랍니다.

환경설정 호환성

기존 config와의 호환성을 유지하는 것은 ASF의 최우선 과제입니다. 이미 알고 계시겠지만, config에 없는 속성은 기본값으로 정의된 것과 동일하게 처리됩니다. 따라서 새 환경설정 속성값이 ASF 새버전에 도입되면, 당신의 모든 환경설정은 새 버전과 호환됩니다. ASF는 새로운 환경설정 속성값을 기본값으로 정의된 것으로 처리합니다. 언제나 필요에 따라 환경설정 속성값을 추가하고, 제거하고, 변경할 수 있습니다.

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

이로 인해 ASF는 config를 다시 포맷하고 기본값을 가진 필드를 제거함으로써 자동으로 마이그레이션/최적화합니다. 특정한 이유가 있는 경우, 예를 들어 읽기 전용 config 파일을 사용 중이라 ASF가 이를 수정하지 않기를 원하는 경우, --no-config-migrate **명령줄 인수**로 이 동작을 비활성화할 수 있습니다.

자동 재시작

ASF는 config가 "실시간으로(on-the-fly)" 수정되는 것을 감지할 수 있으며, 이 덕분에 ASF는 자동으로 다음을 수행합니다:

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

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

또한, ASF의 핵심 config인 ASF.json을 수정하면 (AutoRestart가 허용하는 경우) ASF가 자동으로 재시작됩니다. 마찬가지로, 파일을 삭제하거나 이름을 변경하면 프로그램이 종료됩니다.

특정한 이유가 있는 경우, 예를 들어 config 폴더 내 파일 변경에 ASF가 반응하지 않기를 원하는 경우, --no-config-watch **명령줄 인수**로 이 동작을 비활성화할 수 있습니다.

Uh oh!

Uh oh!

Configuration ko KR

환경설정

소개

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

ASF-ui 설정

수동 환경설정

일반 환경설정

AutoRestart

Blacklist

CommandPrefix

ConfirmationsLimiterDelay

ConnectionTimeout

CurrentCulture

Debug

DefaultBot

FarmingDelay

FilterBadBots

GiftsLimiterDelay

Headless

IdleFarmingPeriod

InventoryLimiterDelay

IPC

IPCPassword

IPCPasswordFormat

LicenseID

LoginLimiterDelay

MaxFarmingTime

MaxTradeHoldDuration

MinFarmingDelayAfterBlock

OptimizationMode

PluginsUpdateList

PluginsUpdateMode

ShutdownIfPossible

SteamMessagePrefix

SteamOwnerID

SteamProtocols

UpdateChannel

UpdatePeriod

WebLimiterDelay

WebProxy

WebProxyPassword

WebProxyUsername

봇 환경설정

AcceptGifts

BotBehaviour

CompleteTypesToSend

CustomGamePlayedWhileFarming

CustomGamePlayedWhileIdle

Enabled

FarmingOrders

FarmingPreferences

GamesPlayedWhileIdle

GamingDeviceType

HoursUntilCardDrops

LootableTypes

MachineName

MatchableTypes

OnlineFlags

OnlineStatus

PasswordFormat

RedeemingPreferences

RemoteCommunication

SendTradePeriod

SteamLogin

SteamMasterClanID

SteamParentalCode

스팀 암호(SteamPassword)

SteamTradeToken

SteamUserPermissions

TradeCheckPeriod

TradingPreferences

TransferableTypes

UseLoginKeys

UserInterfaceMode

WebProxy

WebProxyPassword

WebProxyUsername

파일 구조

`AutoRestart`

`Blacklist`

`CommandPrefix`

`ConfirmationsLimiterDelay`

`ConnectionTimeout`

`CurrentCulture`

`Debug`

`DefaultBot`

`FarmingDelay`

`FilterBadBots`

`GiftsLimiterDelay`

`Headless`

`IdleFarmingPeriod`

`InventoryLimiterDelay`

`IPC`

`IPCPassword`

`IPCPasswordFormat`

`LicenseID`

`LoginLimiterDelay`

`MaxFarmingTime`

`MaxTradeHoldDuration`

`MinFarmingDelayAfterBlock`

`OptimizationMode`

`PluginsUpdateList`

`PluginsUpdateMode`

`ShutdownIfPossible`

`SteamMessagePrefix`

`SteamOwnerID`

`SteamProtocols`

`UpdateChannel`

`UpdatePeriod`

`WebLimiterDelay`

`WebProxy`

`WebProxyPassword`

`WebProxyUsername`

`AcceptGifts`

`BotBehaviour`

`CompleteTypesToSend`

`CustomGamePlayedWhileFarming`

`CustomGamePlayedWhileIdle`

`Enabled`

`FarmingOrders`

`FarmingPreferences`

`GamesPlayedWhileIdle`

`GamingDeviceType`

`HoursUntilCardDrops`

`LootableTypes`

`MachineName`

`MatchableTypes`

`OnlineFlags`

`OnlineStatus`

`PasswordFormat`

`RedeemingPreferences`

`RemoteCommunication`

`SendTradePeriod`

`SteamLogin`

`SteamMasterClanID`

`SteamParentalCode`

`스팀 암호(SteamPassword)`

`SteamTradeToken`

`SteamUserPermissions`

`TradeCheckPeriod`

`TradingPreferences`

`TransferableTypes`

`UseLoginKeys`

`UserInterfaceMode`

`WebProxy`

`WebProxyPassword`

`WebProxyUsername`