Commands ko KR

명령어

ASF는 프로세스와 봇 인스턴스의 행동을 제어하는데 사용되는 다양한 명령어를 지원합니다.

아래의 명령어들은 다양한 방법으로 봇에게 보내질 수 있습니다.

• 대화형 ASF 콘솔을 통해
• Steam 개인/그룹 채팅을 통해
• IPC 인터페이스를 통해

ASF와의 상호 작용은 당신으로부터 ASF의 권한에 따라서 명령을 내릴 자격을 요구한다는 점을 명심하시기 바랍니다. 자세한 내용은 SteamUserPermissions과 SteamOwnerID 설정 속성들을 확인하시기 바랍니다.

Steam 채팅으로 실행된 명령어들은 기본값으로 !으로 지정된 CommandPrefix 일반 환경설정 속성값 의 영향을 받습니다. 이것은 예를 들어 status 명령어를 실행하는 경우에, 실제로 !status (또는 선택에 따라서 대신 지정된 CommandPrefix)를 입력해야 한다는 것을 의미합니다. CommandPrefix는 콘솔이나 IPC를 사용할 때는 필수가 아니며 생략가능합니다.

---

대화형 콘솔

Headless 모드로 실행하지 않는 이상, ASF는 대화형 콘솔을 지원합니다. 명령 모드를 활성화하려면 c 버튼을 누른 후 명령어를 입력하고 Enter로 확정하세요.

---

스팀 채팅

Steam 채팅을 통해서도 해당 ASF 봇에 명령을 실행할 수 있습니다. 당연히 자기 자신에게 직접 이야기할수는 없으므로 주계정을 대상으로 명령을 실행하려면 적어도 하나 이상의 다른 봇계정이 필요합니다.

비슷한 방식으로 스팀 그룹의 그룹 채팅을 사용할 수도 있습니다. 이 옵션은 SteamMasterClanID 속성이 적절하게 설정되어야 한다는 점을 명심하시기 바랍니다. 이 경우에 봇은 그룹 채팅에서도 명령어들을 기다릴 것입니다. (그리고 필요한 경우에 그룹 채팅에 합류합니다.) 이것은 개인 채팅과는 반대로 전용 봇 계정을 필요로 하지 않기 때문에, "자기 자신에게 말하기"로도 사용될 수 있습니다. 새로 만든 그룹으로 SteamMasterClanID 속성을 설정한 다음, 본인 봇의 SteamOwnerID 또는 SteamUserPermissions를 통해 본인에게 접근 권한을 부여하면 됩니다. 이렇게 하면 ASF 봇(즉, 사용자 본인)이 선택한 그룹과 채팅에 참여하며, 본인 계정에서 오는 명령어를 수신하게 됩니다. 동일한 그룹 채팅방에 참여하면 스스로에게 명령을 내릴 수 있습니다. 채팅방에 명령을 보내면, 같은 채팅방에 있는 ASF 인스턴스가 이를 수신하게 됩니다. 채팅방에는 본인 계정만 있는 것처럼 보이더라도 마찬가지입니다.

그룹 채팅에 명령을 보내는 것은 일종의 중계(relay) 역할을 한다는 점을 유의하세요. 그룹 채팅에 함께 있는 봇 3개에 redeem X라고 말하면, 각 봇에게 개별적으로(1:1로) redeem X라고 말한 것과 동일한 결과가 나옵니다. 대부분의 경우 이는 원하는 결과가 아니므로, 대신 1:1 창에서 특정 봇 하나에게 전송하는 지정 봇 명령을 사용하셔야 합니다. ASF는 그룹 채팅을 지원하며, 봇이 하나뿐인 경우 유용한 통신 수단이 될 수 있습니다. 하지만 그룹 채팅에 ASF 봇이 2개 이상 있는 경우에는, 여기 설명된 ASF 동작 방식을 완전히 이해하고 정말로 동일한 명령을 모든 봇에게 동시에 전달(relay)하고 싶은 것이 아니라면 그룹 채팅에서 명령을 실행하지 않는 것이 좋습니다.

이런 경우라 하더라도, 그룹 채팅 대신 [Bots] 구문을 사용한 1:1 채팅을 이용하시는 것이 좋습니다.

---

IPC

사용자 상호 작용(ASF-ui) 및 서드-파티 도구 또는 스크립팅(ASF API) 에 대해서 가장 적합한 명령어들을 실행하는 가장 진보적이고 유연한 방법은 ASF가 IPC 모드로 실행하는 것을 요구하고 클라이언트는 IPC 인터페이스를 통해서 명령을 실행합니다.

---

명령어

명령어	접근권한	설명
2fa [Bots]	주인(Master)	해당 봇 인스턴스에 대한 임시 2단계 인증 토큰을 생성합니다.
2fafinalize [Bots] <ActivationCode>	주인(Master)	SMS/이메일 인증 코드를 사용하여 지정된 봇 인스턴스에 새 2FA 자격 증명을 할당하는 과정을 완료합니다.
2fafinalized [Bots] <2FACodeFromApp>	주인(Master)	2FA 토큰을 사용한 검증을 통해, 이미 완료된 2FA 자격 증명을 지정된 봇 인스턴스로 가져옵니다.
2fafinalizedforce [Bots]	주인(Master)	2FA 토큰 검증을 건너뛰고, 이미 완료된 2FA 자격 증명을 지정된 봇 인스턴스로 가져옵니다.
2fainit [Bots]	주인(Master)	지정된 봇 인스턴스에 새 2FA 자격 증명을 할당하는 과정을 시작합니다.
2fano [Bots]	주인(Master)	해당 봇 인스턴스에 대해 대기중인 모든 2단계 인증 확인을 거부합니다.
2faok [Bots]	주인(Master)	해당 봇 인스턴스에 대해 대기중인 모든 2단계 인증 확인을 승인합니다.
addlicense [Bots] <Licenses>	운영자(Operator)	아래에서 설명하는 라이선스를 지정된 봇 인스턴스에서 활성화합니다 (무료 게임만 해당).
balance [Bots]	주인(Master)	해당 봇 인스턴스의 지갑 잔고를 보여줍니다.
bgr [Bots]	마스터	해당 봇 인스턴스의 백그라운드 게임 등록기 큐 정보를 표시합니다.
bgrclear [Bots]	마스터	지정된 봇 인스턴스의 BGR 대기열을 비웁니다.
encrypt <encryptionMethod> <stringToEncrypt>	소유자(Owner)	제공된 암호화 방식을 사용해 문자열을 암호화합니다 - 자세한 설명은 **아래**를 참고하세요.
exit	소유자(Owner)	모든 ASF 프로세스를 중지합니다.
farm [Bots]	마스터	해당 봇 인스턴스들의 카드 농사 모듈을 재시작합니다.
fb [Bots]	마스터	지정된 봇 인스턴스에서 자동 파밍이 차단된(블랙리스트에 등록된) 앱 목록을 표시합니다.
fbadd [Bots] <AppIDs>	마스터	지정된 appID를 지정된 봇 인스턴스의 자동 파밍 차단(블랙리스트) 목록에 추가합니다.
fbrm [Bots] <AppIDs>	마스터	지정된 봇 인스턴스의 자동 파밍 차단 목록에서 지정된 appID (또는 all)를 제거합니다.
fq [Bots]	마스터	지정된 봇 인스턴스의 우선 파밍 대기열을 표시합니다.
fqadd [Bots] <AppIDs>	마스터	지정된 appID를 지정된 봇 인스턴스의 우선 파밍 대기열에 추가합니다.
fqrm [Bots] <AppIDs>	마스터	지정된 봇 인스턴스의 파밍 대기열에서 지정된 appID (또는 all)를 제거합니다.
hash <hashingMethod> <stringToHash>	소유자(Owner)	제공된 암호화 방식을 사용해 문자열의 해시를 생성합니다 - 자세한 설명은 **아래**를 참고하세요.
help	가족 공유(FamilySharing)	도움말을 보여줍니다 (이 페이지로 연결).
input [Bots] <Type> <Value>	마스터	해당 봇 인스턴스들의 지정된 입력 형식을 주어진 값으로 설정하며, Headless 모드에서만 동작합니다 - 추가 설명은 아래.
inventory [Bots]	운영자	지정된 봇 인스턴스의 인벤토리 요약을 표시합니다.
level [Bots]	마스터	봇 인스턴스들의 스팀 계정 레벨을 보여줍니다.
loot [Bots]	주인(Master)	해당 봇 인스턴스들의 모든 LootableTypes의 스팀 커뮤니티 아이템들을 SteamUserPermissions에서 사용자 설정한 Master (하나보다 많은 경우에는 가장 낮은 steamID) 에게 모두 전달합니다.
loot@ [Bots] <AppIDs>	주인(Master)	지정된 봇 인스턴스에서 지정된 AppIDs와 일치하는 모든 LootableTypes Steam 커뮤니티 아이템을, 해당 봇의 SteamUserPermissions에 정의된 Master 사용자에게 전송합니다 (해당 사용자가 여러 명일 경우 가장 낮은 steamID를 가진 사용자에게 전송). 이는 loot%의 반대 동작입니다.
loot% [Bots] <AppIDs>	주인(Master)	지정된 봇 인스턴스에서 지정된 AppIDs를 제외한 모든 LootableTypes Steam 커뮤니티 아이템을, 해당 봇의 SteamUserPermissions에 정의된 Master 사용자에게 전송합니다 (해당 사용자가 여러 명일 경우 가장 낮은 steamID를 가진 사용자에게 전송). 이는 loot@의 반대 동작입니다.
loot^ [Bots] <AppID> <ContextID>	마스터	해당 봇 인스턴스들의 지정된 ContextID 에 있는 주어진 AppID의 스팀 아이템들을 SteamUserPermissions에서 사용자 설정한 Master (하나보다 많은 경우에는 가장 낮은 steamID) 에게 모두 전달합니다.
loot& [Bots] <AppID> <ContextID> <Rarities>	마스터	지정된 봇 인스턴스에서 ContextID 내 AppID에 속한 아이템 중, 지정된 **Rarities**와 일치하는 모든 Steam 아이템을 해당 봇의 SteamUserPermissions에 정의된 Master 사용자에게 전송합니다 (해당 사용자가 여러 명일 경우 가장 낮은 steamID를 가진 사용자에게 전송).
mab [Bots]	주인(Master)	**MatchActively**에서 자동 거래가 차단된(블랙리스트) 앱 목록을 표시합니다.
mabadd [Bots] <AppIDs>	주인(Master)	지정된 appID를 **MatchActively**의 자동 거래 차단 목록에 추가합니다.
mabrm [Bots] <AppIDs>	주인(Master)	**MatchActively**의 자동 거래 차단 목록에서 지정된 appID (또는 all)를 제거합니다.
match [Bots]	주인(Master)	**ItemsMatcherPlugin**을 위한 특수 명령어로, MatchActively 루틴을 즉시 실행합니다.
nickname [Bots] <Nickname>	주인(Master)	해당 봇 인스턴스들의 스팀 닉네임을 주어진 nickname으로 변경합니다.
owns [Bots] <Games>	운영자(Operator)	지정된 봇 인스턴스가 이미 지정된 games을 보유하고 있는지 확인합니다. 자세한 내용은 **아래**를 참고하세요.
pause [Bots]	운영자(Operator)	해당 봇 인스턴스들의 자동 카드 농사 모듈을 영구적으로 정지합니다. 수동으로 resume 하거나 프로세스를 재시작하기 전까지 ASF는 이 세션에서 해당 계정의 농사를 시도하지 않을 것입니다.
pause~ [Bots]	가족 공유	해당 봇 인스턴스들의 자동 카드 농사 모듈을 일시 정지합니다. 농사는 다음 실행 이벤트 또는 봇 연결 해제시에 자동으로 재개됩니다. 일시 정지를 해제하기 위해서 resume 할 수 있습니다.
pause& [Bots] <Seconds>	운영자(Operator)	당 봇 인스턴스들의 자동 카드 농사 모듈을 주어진 seconds의 기간 동안 일시 정지합니다. 지연 시간이 지나고, 카드 농사 모듈이 자동으로 재개됩니다.
play [Bots] <AppIDs,GameName>	주인(Master)	수동 파밍으로 전환합니다 - 지정된 봇 인스턴스에서 지정된 AppIDs를 실행하며, 선택적으로 사용자 지정 GameName도 함께 지정할 수 있습니다. 이 기능이 정상적으로 작동하려면 Steam 계정이 여기서 지정한 모든 AppIDs에 대해 유효한 라이선스를 반드시 보유하고 있어야 하며, 이는 F2P(무료 플레이) 게임도 마찬가지입니다. 원래 상태로 돌아가려면 reset 또는 resume을 사용하세요.
points [Bots]	주인(Master)	**Steam 포인트 상점**의 포인트 수를 표시합니다.
privacy [Bots] <Settings>	주인(Master)	지정된 봇 인스턴스의 **Steam 개인정보 설정**을 **아래**에 설명된 옵션에 맞게 변경합니다.
redeem [Bots] <Keys>	운영자(Operator)	지정된 봇 인스턴스에서 주어진 CD 키 또는 지갑 코드(wallet code)를 등록합니다.
redeem^ [Bots] <Modes> <Keys>	운영자(Operator)	**아래**에 설명된 modes를 사용하여, 지정된 봇 인스턴스에서 주어진 CD 키 또는 지갑 코드를 등록합니다.
redeempoints [Bots] <DefinitionIDs>	운영자(Operator)	지정된 봇 인스턴스에서 지정된 자산(asset)에 대해 **Steam 포인트**를 사용합니다. 기본적으로 무료 아이템만 허용됩니다. 유료 여부와 상관없이 무조건 사용하고 싶은 DefinitionID 끝에는 ! 문자를 붙이세요.
reset [Bots]	주인(Master)	플레이 상태를 원래(이전) 상태로 초기화합니다. 이 명령어는 play 명령어를 사용한 수동 파밍 중에 사용됩니다.
restart	소유자(Owner)	ASF 프로세스를 재시작합니다.
resume [Bots]	가족 공유(FamilySharing)	해당 봇 인스턴스들의 자동 농사를 재개합니다.
rmlicense [Bots] <Licenses>	주인(Master)	**아래**에 설명된 licenses를 지정된 봇 인스턴스에서 제거합니다.
start [Bots]	주인(Master)	해당 봇 인스턴스들을 시작합니다.
stats	소유자(Owner)	관리되는 메모리 사용량과 같은 프로세스 통계를 출력합니다.
status [Bots]	가족 공유(FamilySharing)	해당 봇 인스턴스들의 상태를 출력합니다.
std [Bots]	주인(Master)	**SteamTokenDumperPlugin**을 위한 특수 명령어로, 선택한 봇의 갱신과 데이터 제출을 즉시 실행합니다.
stop [Bots]	주인(Master)	해당 봇 인스턴스들을 중지합니다.
tb [Bots]	주인(Master)	해당 봇 인스턴스들의 거래 모듈에서 블랙리스트에 등록된 유저 목록을 보여줍니다.
tbadd [Bots] <SteamIDs64>	주인(Master)	해당 봇 인스턴스들의 거래 모듈에서 해당 steamIDs를 블랙리스트에 등록합니다.
tbrm [Bots] <SteamIDs64>	주인(Master)	지정된 봇 인스턴스의 거래 모듈에서 지정된 steamID (또는 all)에 대한 차단(블랙리스트)을 해제합니다.
transfer [Bots] <TargetBot>	주인(Master)	지정된 봇 인스턴스에서 모든 TransferableTypes Steam 커뮤니티 아이템을 대상 봇 인스턴스로 전송합니다.
transfer@ [Bots] <AppIDs> <TargetBot>	주인(Master)	지정된 봇 인스턴스에서 지정된 AppIDs와 일치하는 모든 TransferableTypes Steam 커뮤니티 아이템을 대상 봇 인스턴스로 전송합니다. 이는 transfer%의 반대 동작입니다.
transfer% [Bots] <AppIDs> <TargetBot>	주인(Master)	지정된 봇 인스턴스에서 지정된 AppIDs를 제외한 모든 TransferableTypes Steam 커뮤니티 아이템을 대상 봇 인스턴스로 전송합니다. 이는 transfer@의 반대 동작입니다.
transfer^ [Bots] <AppID> <ContextID> <TargetBot>	주인(Master)	지정된 봇 인스턴스에서 ContextID 내 지정된 AppID에 속한 모든 Steam 아이템을 대상 봇 인스턴스로 전송합니다.
transfer& [Bots] <AppID> <ContextID> <TargetBot> <Rarities>	주인(Master)	지정된 봇 인스턴스에서 ContextID 내 AppID에 속한 아이템 중, 지정된 **Rarities**와 일치하는 모든 Steam 아이템을 대상 봇 인스턴스로 전송합니다.
unpack [Bots]	주인(Master)	해당 봇 인스턴스들의 보관함에 있는 모든 부스터팩을 뜯습니다.
update [Channel]	소유자(Owner)	GitHub에서 새로운 ASF 릴리스를 확인하고, 있을 경우 업데이트합니다. 이는 보통 UpdatePeriod마다 자동으로 수행됩니다. 선택적인 Channel 인수는 **UpdateChannel**을 지정하며, 지정하지 않을 경우 전역 설정에 지정된 값을 기본값으로 사용합니다. Channel 끝에 ! 문자를 붙이면, 예를 들어 다운그레이드를 포함해 해당 채널에서 사용 가능한 업데이트를 강제로 적용합니다.
updateplugins [Channel] [Plugins]	소유자(Owner)	선택한 플러그인을 업데이트합니다. 선택적인 Channel 속성을 사용하면, 플러그인이 여러 **UpdateChannel**을 지원하는 경우 플러그인 업데이트에 사용할 채널을 다르게 지정할 수 있습니다. Channel 끝에 ! 문자를 붙이면, 예를 들어 다운그레이드를 포함해 해당 채널에서 사용 가능한 업데이트를 강제로 적용합니다. 다만 정확한 동작 방식은 플러그인에 따라 다를 수 있습니다. Plugins를 지정하지 않으면, **PluginsUpdateList**와 **PluginsUpdateMode**을 통해 자동 업데이트 대상으로 지정된 모든 플러그인이 업데이트됩니다. 특정 플러그인만 업데이트하고 싶다면(특히 기본적으로 자동 업데이트가 비활성화된 플러그인의 경우), 업데이트할 Channel과 Plugins를 함께 지정해야 합니다. 그러면 ASF는 자동 업데이트 설정과 무관하게 해당 플러그인들을 업데이트합니다.
version	가족 공유(FamilySharing)	ASF의 버전을 출력합니다.

---

주의

모든 명령어들은 대소문자 구별이 없지만, 그것들의 요소들(예를 들어 봇 이름들) 은 일반적으로 대소분자를 구별합니다.

인수는 UNIX 철학을 따르며, 대괄호 [Optional]는 해당 인수가 선택적임을, 꺾쇠괄호 <Mandatory>는 해당 인수가 필수임을 나타냅니다. [Bots]나 <Nickname> 같은 지정하고자 하는 인수는, 괄호 표시를 생략하고 명령어 실행에 사용할 실제 값으로 바꾸셔야 합니다.

대괄호로 표시된 [Bots] 인수는 모든 명령어에서 선택 사항입니다. 지정된 경우, 명령어는 주어진 봇들에게서 실행됩니다. 생략할 경우, 명령을 수신한 현재 봇(Steam 채팅의 경우)이나 설정된 DefaultBot 속성(IPC 및 대화형 콘솔의 경우)을 기준으로 명령이 실행됩니다.

예를 들어, 봇 B에게 보낸 status A는 봇 A에게 status를 보낸 것과 동일하며, 이 경우 봇 B는 단순히 중계(proxy) 역할만 합니다. 이 방식은 다른 방법으로는 접근할 수 없는 봇에게 명령을 보낼 때도 사용할 수 있습니다. 예를 들어 정지된 봇을 시작하거나, 명령을 실행하는 데 사용 중인 메인 계정에서 직접 작업을 수행할 때 활용할 수 있습니다.

명령어의 Access는 해당 명령어를 사용하는 데 필요한 SteamUserPermissions의 최소 EPermission을 나타냅니다. 다만 전역 설정 파일에 정의된 SteamOwnerID인 Owner는 예외이며(가장 높은 권한을 가짐).

[Bots], <Keys>, <AppIDs>처럼 복수형으로 표시된 인수는, 해당 명령어가 쉼표로 구분된 여러 개의 동일한 유형 인수를 지원한다는 의미입니다. 예를 들어, status [Bots]는 status MyBot,MyOtherBot,Primary와 같은 형식으로 사용할 수 있습니다. 이렇게 하면 지정된 명령어가 모든 대상 봇에서 실행되며, 이는 각 봇에게 개별 채팅창에서 status를 각각 보낸 것과 동일한 효과를 냅니다. 쉼표 , 뒤에는 공백을 넣지 않는다는 점을 유의하세요.

ASF는 공백 문자와 줄바꿈 문자 등 모든 공백 문자를 명령어 구분자로 사용할 수 있습니다. 즉, 인수를 구분할 때 반드시 공백을 사용할 필요는 없으며, 탭이나 줄바꿈 등 다른 공백 문자도 얼마든지 사용할 수 있습니다.

ASF는 범위를 벗어난 추가 인수를 마지막 범위 내 인수의 복수형(plural) 인수에 "합쳐서" 처리합니다. 즉, redeem [Bots] <Keys>에 대해 redeem bot key1 key2 key3을 입력하면 redeem bot key1,key2,key3을 입력한 것과 완전히 동일하게 작동합니다. 줄바꿈을 명령어 구분자로 허용하는 것과 결합하면, redeem bot이라고 입력한 후 줄바꿈 등 허용되는 구분자(또는 표준 , ASF 구분자)로 구분된 키 목록을 붙여넣는 것도 가능합니다. 다만 이 방법은 인수를 가장 많이 사용하는 명령어 형태에서만 사용할 수 있다는 점을 유의하세요. 따라서 이 경우 [Bots]를 반드시 지정해야 하며, 그렇지 않으면 첫 번째 키가 명령을 실행할 대상 봇으로 잘못 해석됩니다.

앞서 설명드린 대로, 공백 문자는 명령어의 구분자로 사용되기 때문에 인수 내에서는 사용할 수 없습니다. 다만 앞서 설명드린 대로 ASF는 범위를 벗어난 인수를 합쳐서 처리할 수 있으므로, 해당 명령어의 마지막 인수로 정의된 항목에서는 실제로 공백 문자를 사용할 수 있습니다. 예를 들어, nickname bob Great Bob을 입력하면 bob 봇의 닉네임이 "Great Bob"으로 정상적으로 설정됩니다. 같은 방식으로 owns 명령어에서도 공백이 포함된 이름을 확인할 수 있습니다.

AppID나 SubID를 요구하는 명령어는 store.steampowered.com 링크에서도 해당 정보를 알아서 추출할 수 있습니다.

---

일부 명령어는 별칭(alias)으로도 사용할 수 있으며, 주로 타이핑을 줄이거나 다양한 표현 방식을 지원하기 위한 것입니다:

명령어	별칭
addlicense	al, addlicence
addlicense ASF	ala
owns ASF	oa
status ASF	sa
redeem	r
redeem^	r^
redeempoints	rp
rmlicense	rl, rmlicence

---

[Bots] 인수

[Bots] 인수는 복수형 인수의 특수한 형태로, 여러 값을 받을 수 있을 뿐 아니라 추가 기능도 제공합니다.

가장 먼저, [Bots] 인수는 미리 정의된 "봇 그룹(bot groups)"을 지원하며, 이는 아래와 같이 정의됩니다:

이름	설명
@all, ASF	인스턴스에 정의된 모든 봇
@농사	현재 파밍 중인 봇
@idle	현재 파밍 중이 아닌 봇
@오프라인	현재 Steam 네트워크에 연결되어 있지 않은 봇
@온라인	현재 Steam 네트워크에 연결되어 있는 봇

예를 들어, status ASF 명령어는 status all,your,bots,listed,here와 동일합니다. 이 방법은 접근 권한이 있는 봇을 쉽게 파악하는 데도 사용할 수 있습니다. ASF 키워드는 모든 봇을 대상으로 하지만, 실제로 명령을 보낼 수 있는 봇에서만 응답이 오기 때문입니다. 특정 조건을 만족하는 봇에게만 더 쉽게 명령을 실행할 수 있도록, 다른 그룹들도 사용할 수 있습니다.

[Bots] 인수는 특수한 "범위(range)" 구문도 지원하여, 봇의 범위를 더 쉽게 선택할 수 있습니다. 이 경우 [Bots]의 일반적인 구문은 [FirstBot]..[LastBot]입니다. 두 인수 중 최소 하나는 반드시 지정해야 합니다. <FirstBot>..를 사용하면 FirstBot부터 시작하는 모든 봇이 대상이 됩니다. ..<LastBot>를 사용하면 LastBot까지의 모든 봇이 대상이 됩니다. <FirstBot>..<LastBot>를 사용하면 FirstBot부터 LastBot까지 범위 내의 모든 봇이 대상이 됩니다. 예를 들어, A, B, C, D, E, F라는 이름의 봇이 있다면 status B..E를 실행할 수 있으며, 이는 이 경우 status B,C,D,E와 동일합니다. 이 구문을 사용하면 ASF는 알파벳 순 정렬을 기준으로 지정된 범위에 어떤 봇들이 포함되는지 결정합니다. 인수는 ASF가 인식할 수 있는 유효한 봇 이름이어야 하며, 그렇지 않으면 범위 구문 전체가 무시됩니다.

위의 범위 구문 외에도, [Bots] 인수는 정규표현식(regex) 매칭도 지원합니다. 봇 이름 자리에 r!<Pattern>를 사용하면 정규표현식 패턴을 활성화할 수 있습니다. 여기서 r!는 정규표현식 매칭을 위한 ASF 활성 키워드이고, <Pattern>는 사용자가 지정하는 정규표현식 패턴입니다. 정규표현식 기반 봇 명령어의 예로 status r!^\d{3}가 있으며, 이는 이름이 숫자 3자리로 이루어진 봇(예: 123, 981)에게 status 명령을 전송합니다. 더 자세한 설명과 사용 가능한 정규표현식 패턴 예시는 **문서**를 참고해 주세요.

---

privacy 설정

<Settings> 인수는 최대 7개의 서로 다른 옵션을 받을 수 있으며, 평소와 같이 표준 쉼표 ASF 구분자로 구분합니다. 순서대로 다음과 같습니다:

인자	이름	선행 조건
1	Profile
2	OwnedGames	Profile
3	Playtime	OwnedGames
4	FriendsList	Profile
5	Inventory	Profile
6	InventoryGifts	Inventory
7	Comments	Profile

위 항목들에 대한 설명은 **Steam 개인정보 설정**을 참고해 주세요.

이 항목들에 유효한 값은 다음과 같습니다:

값	이름
1	Private
2	FriendsOnly
3	Public

대소문자를 구분하지 않는 이름이나 숫자 값 중 하나를 사용할 수 있습니다. 생략된 인수는 기본값으로 Private로 설정됩니다. 위에서 설명한 종속 관계를 유의하시는 것이 중요합니다. 특정 항목이 종속된 속성은 해당 항목이 가질 수 있는 가장 개방적인(open) 권한을 결정하기 때문입니다.

예를 들어, 소유 게임 설정이 Private인 상태에서 플레이타임 설정을 Public으로 할 수는 없지만, 프로필이 Public인 상태에서 소유 게임 설정을 Private로 두는 것은 전혀 문제없습니다.

예시

Main이라는 이름의 봇의 모든 개인정보 설정을 Private로 지정하고 싶다면, 아래 중 하나를 사용할 수 있습니다:

privacy Main 1
privacy Main Private

이는 ASF가 다른 모든 설정을 자동으로 Private로 간주하기 때문이며, 따라서 별도로 입력할 필요가 없습니다. 반대로 모든 개인정보 설정을 Public으로 지정하고 싶다면, 아래 중 하나를 사용하시면 됩니다:

privacy Main 3,3,3,3,3,3,3
privacy Main Public,Public,Public,Public,Public,Public,Public

이런 방식으로 원하는 대로 각각의 옵션을 독립적으로 설정할 수도 있습니다:

privacy Main Public,FriendsOnly,Private,Public,Public,Private,Public

위 명령은 프로필을 공개로, 소유 게임을 친구만 공개로, 플레이타임을 비공개로, 친구 목록을 공개로, 인벤토리를 공개로, 인벤토리 선물을 비공개로, 프로필 댓글을 공개로 설정합니다. 원하신다면 숫자 값을 사용해서도 동일하게 설정할 수 있습니다.

---

라이선스

addlicense와 rmlicense 명령어는 두 가지 서로 다른 라이선스 유형을 지원하며, 다음과 같습니다:

유형	별칭	예시	설명
app	a	app/292030	고유한 appID로 식별되는 게임.
sub	s	sub/47807	고유한 subID로 식별되는, 하나 이상의 게임을 포함하는 패키지.

이 구분은 중요합니다. ASF는 앱(app)에는 Steam 네트워크 방식을, 패키지(package)에는 Steam 스토어 방식을 사용하기 때문입니다. 이 두 방식은 서로 호환되지 않습니다.

새 라이선스를 활성화할 때, 일반적으로 무료 주말/영구 무료(F2P) 게임에는 app을, 그 외의 경우에는 package를 지정하시면 됩니다.

기존 라이선스를 제거할 때는 두 방식 모두 사용할 수 있지만, 확정적이고 명확한 요청을 위해 패키지 단위로 제거하는 것을 권장합니다. 그렇지 않으면 Steam이 의도치 않은 패키지까지 제거할 수 있는데, 특히 계정에 동일한 앱에 접근 권한을 부여하는 패키지가 두 개 이상 있는 경우 더욱 그렇습니다. 이는 내부적으로 라이선스가 항상 접근 권한을 부여하는 패키지 단위로 식별되기 때문입니다. 따라서 appID로 제거를 요청하면, 어떤 subID를 제거할지는 Steam이 결정하게 됩니다.

모호한 결과를 피하기 위해 각 항목의 유형을 명시적으로 지정하는 것을 권장합니다. 다만 하위 호환성을 위해 유형을 아예 생략할 경우, ASF는 이 경우 sub를 요청한 것으로 간주합니다. 표준 ASF , 구분자를 사용하여 하나 이상의 라이선스를 동시에 조회할 수도 있습니다.

전체 명령어 예시:

addlicense ASF app/292030
addlicense ASF sub/303386
rmlicense ASF app/292030,sub/303386

---

owns 게임

owns 명령어는 <games> 인수에 사용할 수 있는 여러 다른 게임 유형을 지원하며, 다음과 같습니다:

유형	별칭	예시	설명
app	a	app/292030	고유한 appID로 식별되는 게임.
sub	s	sub/47807	고유한 subID로 식별되는, 하나 이상의 게임을 포함하는 패키지.
regex	r	regex/^\d{4}:	게임 이름에 적용되는 **정규표현식(Regex)**이며, 대소문자를 구분합니다. 전체 구문과 더 많은 예시는 **문서**를 참고하세요.
이름	n	name/Witcher	게임 이름의 일부이며, 대소문자를 구분하지 않습니다.

모호한 결과를 피하기 위해 각 항목의 타입을 명시적으로 지정하는 것을 권장합니다. 다만 하위 호환성을 위해, 잘못된 타입을 입력하거나 아예 생략할 경우 ASF는 입력값이 숫자이면 app, 그렇지 않으면 name을(를) 요청한 것으로 간주합니다. 표준 ASF , 구분자를 사용하여 하나 이상의 게임을 동시에 조회할 수도 있습니다.

전체 명령어 예시:

owns ASF app/292030,name/Witcher

---

redeem^ 모드

redeem^ 명령어를 사용하면 단일 redeem 시나리오에 사용될 모드를 세밀하게 조정할 수 있습니다. 이는 RedeemingPreferences **bot config property**를 일시적으로 재정의(override)하는 방식으로 작동합니다.

<Modes> 인자는 여러 개의 모드 값을 받을 수 있으며, 일반적인 방식대로 쉼표로 구분합니다. 사용 가능한 모드 값은 아래와 같습니다:

값	이름	설명
FAWK	ForceAssumeWalletKey	AssumeWalletKeyOnBadActivationCode redeeming preference를 강제로 활성화합니다
FD	ForceDistributing	Distributing redeeming preference를 강제로 활성화합니다
FF	ForceForwarding	Forwarding redeeming preference를 강제로 활성화합니다
FKMG	ForceKeepMissingGames	KeepMissingGames redeeming preference를 강제로 활성화합니다
SAWK	SkipAssumeWalletKey	AssumeWalletKeyOnBadActivationCode redeeming preference를 강제로 비활성화합니다
SD	SkipDistributing	Distributing redeeming preference를 강제로 비활성화합니다
SF	SkipForwarding	Forwarding redeeming preference를 강제로 비활성화합니다
SI	SkipInitial	초기 봇에서 키 redemption을 건너뜁니다
SKMG	SkipKeepMissingGames	KeepMissingGames redeeming preference를 강제로 비활성화합니다
V	Validate	키의 형식이 올바른지 검증하고, 유효하지 않은 키는 자동으로 건너뜁니다

예를 들어, 아직 게임을 보유하지 않은 봇들에 대해 키 3개를 redeem하고 싶지만, primary 봇은 제외하고 싶다고 가정해보겠습니다. 이를 위해 다음과 같이 사용할 수 있습니다:

redeem^ primary FF,SI key1,key2,key3

advanced redeem은 RedeemingPreferences 중에서도 명령어에서 지정한 것만 재정의한다는 점에 유의해야 합니다. 예를 들어, RedeemingPreferences에서 Distributing을 이미 활성화한 상태라면, FD 모드를 사용하든 안 하든 차이가 없습니다. 사용 중인 RedeemingPreferences에 의해 distributing이 이미 활성화되어 있기 때문입니다. 이러한 이유로 강제 활성화(forcibly enabled) override에는 각각 강제 비활성화(forcibly disabled) 버전도 존재하며, 비활성화된 것을 활성화로 재정의할지 혹은 그 반대로 할지는 직접 결정할 수 있습니다.

---

encrypt 명령어

encrypt 명령어를 사용하면 ASF의 암호화 방식을 이용해 임의의 문자열을 암호화할 수 있습니다. <encryptionMethod>은(는) security 섹션에 명시되고 설명된 암호화 방식 중 하나여야 합니다. 이 명령어는 보안 채널(ASF 콘솔 또는 전용 API 엔드포인트가 있는 IPC 인터페이스)을 통해 사용하시길 권장합니다. 그렇지 않으면 민감한 정보가 여러 제3자에 의해 기록될 수 있습니다(예: Steam 서버에 기록되는 채팅 메시지 등).

---

hash 명령어

hash 명령어를 사용하면 ASF의 해싱 방식을 이용해 임의의 문자열에 대한 해시를 생성할 수 있습니다. <hashingMethod>은(는) security 섹션에 명시되고 설명된 해싱 방식 중 하나여야 합니다. 이 명령어는 보안 채널(ASF 콘솔 또는 전용 API 엔드포인트가 있는 IPC 인터페이스)을 통해 사용하시길 권장합니다. 그렇지 않으면 민감한 정보가 여러 제3자에 의해 기록될 수 있습니다(예: Steam 서버에 기록되는 채팅 메시지 등).

---

input 명령어

input 명령어는 Headless 모드에서만 사용할 수 있으며, ASF가 사용자 상호작용을 지원하지 않는 상태로 실행 중일 때 IPC 또는 Steam 채팅을 통해 주어진 데이터를 입력하는 데 사용됩니다.

일반적인 구문은 input [Bots] <Type> <Value>입니다.

<Type>은(는) 대소문자를 구분하지 않으며, ASF가 인식하는 입력 타입을 정의합니다. 현재 ASF는 다음 타입들을 인식합니다:

타입	설명
Login	설정에 없을 경우 SteamLogin 봇 설정 속성.
비밀번호	설정에 없을 경우 SteamPassword 봇 설정 속성.
SteamGuard	2FA를 사용하지 않는 경우 이메일로 전송되는 인증 코드입니다.
SteamParentalCode	설정에 없을 경우, 봇 설정의 SteamParentalCode 속성 값을 사용합니다.
TwoFactorAuthentication	2FA를 사용 중이지만 ASF 2FA를 사용하지 않는 경우, 모바일에서 생성된 2FA 토큰입니다.

<Value>는 지정된 유형에 대해 설정된 값입니다. 현재 모든 값은 문자열(string)입니다.

예시

비-2FA 모드의 SteamGuard로 보호되고 있는 봇이 있다고 가정해 보겠습니다. 이 봇을 Headless 값을 true로 설정한 상태로 실행하고 싶습니다.

이를 위해서는 다음 명령어를 실행해야 합니다:

start MySteamGuardBot -> 봇이 로그인을 시도하지만 AuthCode가 필요해 실패하고, Headless 모드로 실행 중이므로 중지됩니다. 이 과정이 필요한 이유는 Steam 네트워크가 이메일로 인증 코드를 보내도록 하기 위해서입니다 - 이 과정이 필요 없다면 이 단계는 완전히 건너뛰어도 됩니다.

input MySteamGuardBot SteamGuard ABCDE -> MySteamGuardBot 봇의 SteamGuard 입력값을 ABCDE로 설정합니다. 물론 여기서 ABCDE는 이메일로 받은 인증 코드입니다.

start MySteamGuardBot -> (중지된) 봇을 다시 시작합니다. 이번에는 이전 명령어에서 설정한 인증 코드를 자동으로 사용하여 정상적으로 로그인한 후, 해당 코드를 삭제합니다.

같은 방식으로, ASF 2FA를 사용하지 않는 2FA로 보호된 봇에도 접근할 수 있으며, 실행 중 필요한 다른 속성들도 설정할 수 있습니다.

---

인식되는 희귀도(rarity)

ASF는 다음 희귀도를 인식합니다:

희귀도	별칭
알 수 없음(Unknown)
Common
Uncommon
Rare
Mythical	Epic
Legendary	Exotic
Ancient	Extraordinary
Immortal	Contraband
Arcana
Unusual

위에 정의된 것 외의, ASF가 인식하지 못하는 희귀도는 Unknown(으)로 정의됩니다.