ItemsMatcherPlugin ko KR

ItemsMatcherPlugin

ItemsMatcherPlugin은 ASF에 ASF STM 리스팅 기능을 추가하는 공식 ASF **플러그인**입니다. 구체적으로는 **RemoteCommunication**의 PublicListing과 **TradingPreferences**의 MatchActively 기능을 포함합니다. ASF는 릴리스 시 ItemsMatcherPlugin이 기본으로 번들되어 함께 제공되므로, 바로 사용하실 수 있습니다.

---

PublicListing

Public listing은 이름 그대로, 현재 이용 가능한 ASF STM 봇들의 목록입니다. 이는 **저희 웹사이트**에 위치해 있으며, 자동으로 관리되고, MatchActively를 사용하는 ASF 사용자뿐만 아니라 수동 매칭을 원하는 ASF/비ASF 사용자 모두를 위한 공개 서비스로 활용됩니다.

리스팅에 등록되려면, 충족해야 할 일련의 요구사항이 있습니다. 최소한, RemoteCommunication에서 PublicListing이 허용된 상태여야 하고(기본 설정값), TradingPreferences에서 SteamTradeMatcher가 활성화되어 있어야 하며, 공개(public) 인벤토리 개인정보 설정, 제한 없는(unrestricted) 계정, 그리고 **ASF 2FA**가 활성화되어 있어야 합니다. 추가 요구사항으로는 2FA가 활성화된 지 최소 15일이 지나야 하고, 마지막 비밀번호 변경이 5일 이상 지나야 하며, 계정 잠금(lockdown)이나 경제적 제재(economical ban), 거래 제재(trade ban)와 같은 계정 제한이 없어야 합니다. 당연하게도, 지정된 MatchableTypes(예: 거래 카드)에 해당하는 (거래 가능한) 아이템이 인벤토리에 최소 하나 이상 있어야 합니다. 이에 더해, 아이템이 500000개를 초과하는 봇은 과도한 오버헤드로 인해 등록이 허용되지 않으므로, 이런 경우에는 인벤토리를 여러 계정으로 분산시키는 것을 권장드립니다.

PublicListing은 기본적으로 활성화되어 있지만, 위 요구사항을 모두 충족하지 못하는 경우, 특히 기본적으로 활성화되어 있지 않은 SteamTradeMatcher를 활성화하지 않은 경우에는 웹사이트에 표시되지 않는다는 점을 유의하시기 바랍니다. 요구사항을 충족하지 못하는 사용자의 경우, PublicListing을 활성화해두었더라도 ASF는 서버와 어떠한 방식으로도 통신하지 않습니다. Public listing은 최신 안정 버전의 ASF와만 호환되며, 최신 버전에서만 확인 가능한 핵심 기능이 없는 오래된 버전의 봇은 표시가 거부될 수 있습니다.

정확한 작동 방식

ASF는 로그인 직후 한 번, public listing이 사용하는 모든 속성을 담은 초기 데이터를 전송합니다. 이후 10분마다, 봇이 여전히 정상적으로 실행 중이라는 것을 저희 서버에 알리는 매우 작은 크기의 "하트비트(heartbeat)" 요청을 전송합니다. 만약 네트워크 문제 등의 이유로 이 하트비트가 도착하지 않았다면, 서버가 이를 등록할 때까지 ASF는 매 분마다 재전송을 시도합니다. 이런 방식을 통해 저희 서버는 현재 어떤 봇이 실행 중이고 거래 제안을 수락할 준비가 되어 있는지 정확히 파악할 수 있습니다. ASF는 필요에 따라 초기 공지(announcement)도 전송합니다. 예를 들어 이전과 비교하여 인벤토리가 변경된 것을 감지한 경우입니다.

저희는 최근 15분 이내에 활동한 자격을 갖춘 모든 ASF 계정을 표시합니다. 사용자들은 상대적인 유용성 기준으로 정렬됩니다 - 모든 1:1 거래를 수락하는 Any 배너가 표시되는 MatchEverything 봇이 먼저 표시되고, 그다음으로는 보유한 고유 게임 수, 마지막으로는 아이템 개수 순으로 정렬됩니다.

API

ASF STM 리스팅은 현재로서는 ASF 봇만 등록을 허용합니다. 저희가 제3자 봇의 코드를 쉽게 검토하여 저희의 전체 거래 로직을 충족하는지 확인할 방법이 없기 때문에, 현재로서는 제3자 봇을 저희 리스팅에 등록할 방법이 없습니다. 따라서 리스팅에 참여하려면 최신 안정 버전의 ASF가 필요하며, 다만 커스텀 **플러그인**을 함께 사용하는 것은 가능합니다.

리스팅 이용자를 위해, 사용 가능한 매우 간단한 /Api/Listing/Bots 엔드포인트를 제공하고 있습니다. 여기에는 MatchActively 기능을 사용하는 사용자의 인벤토리를 제외한, 저희가 보유한 모든 데이터가 포함됩니다.

개인정보 처리방침

SteamTradeMatcher를 활성화하고 위에서 명시한 대로 PublicListing을 거부하지 않음으로써 저희 리스팅에 등록되는 것에 동의하신 경우, 예상되는 기능을 제공하기 위해 귀하의 Steam 계정 세부 정보 일부를 저희 서버에 임시로 저장합니다.

공개 정보(Steam이 모든 관심 있는 당사자에게 공개하는 정보)에는 다음이 포함됩니다:

• 귀하의 Steam 식별자(링크 생성용, 64비트 형식)
• 귀하의 닉네임(표시용)
• 귀하의 아바타(표시용 해시값)

조건부 공개 정보(리스팅 요구사항을 충족하는 경우 Steam이 모든 관심 있는 당사자에게 공개하는 정보)에는 다음이 포함됩니다:

• 귀하의 인벤토리(다른 사람이 이를 대상으로 MatchActively를 사용할 수 있도록)

비공개 정보(기능 제공을 위해 필요한 선별된 데이터)에는 다음이 포함됩니다:

• 귀하의 거래 토큰(친구 목록 외부의 사람이 귀하에게 거래를 보낼 수 있도록)
• 귀하의 MatchableTypes 설정(표시 및 매칭 목적)
• 귀하의 MatchEverything 설정(표시 및 매칭 목적)
• 귀하의 MaxTradeHoldDuration 설정(상대방이 귀하의 거래를 수락할 수 있는지 알 수 있도록)

리스팅 사용(공지)을 중단하는 순간부터, 귀하의 데이터는 최대 15분 이내에 일반에 공개되지 않게 되며, 그렇지 않은 경우에도 저희 서버에는 최대 2주간만 보관되고 이후 자동으로 완전히 삭제됩니다. 이를 위해 귀하가 별도로 취해야 할 조치는 없습니다.

---

능동적 매칭(MatchActively)

MatchActively 설정은 **SteamTradeMatcher**의 능동형(active) 버전으로, 봇이 다른 사람에게 직접 거래를 전송하는 대화형 매칭 기능을 포함합니다. 이는 독립적으로 작동할 수도 있고, SteamTradeMatcher 설정과 함께 사용할 수도 있습니다. 이 기능은 제3자 서버와 유료 리소스를 사용하여 작동하므로 LicenseID 설정이 필요합니다.

이 옵션을 사용하려면, 충족해야 할 일련의 요구사항이 있습니다. 최소한, 제한 없는(unrestricted) 계정, **ASF 2FA**가 활성화되어 있어야 하고, MatchableTypes(예: 거래 카드)에 해당하는 유효한 타입이 최소 하나 이상 있어야 합니다. 추가 요구사항으로는 2FA가 활성화된 지 최소 15일이 지나야 하고, 마지막 비밀번호 변경이 5일 이상 지나야 하며, 계정 잠금(lockdown)이나 경제적 제재(economical ban), 거래 제재(trade ban)와 같은 계정 제한이 없어야 합니다.

위의 모든 요구사항을 충족하시면, ASF는 현재 이용 가능한 봇들을 능동적으로 매칭하기 위해 주기적으로 저희의 **공개 ASF STM 리스팅**과 통신합니다.

매칭이 진행되는 동안, ASF 봇은 자신의 인벤토리를 가져온 다음, 저희 서버와 통신하여 현재 이용 가능한 다른 봇들과 가능한 모든 MatchableTypes 매칭 항목을 찾습니다. 저희 서버와 직접 통신하는 덕분에, 이 과정은 단 한 번의 요청만으로 처리되며, 이용 가능한 봇이 저희에게 흥미로운 것을 제공하는지 즉시 파악할 수 있습니다 - 매칭이 발견되면, ASF는 자동으로 거래를 전송하고 승인합니다.

이 모듈은 투명하게 작동하도록 설계되어 있습니다. 매칭은 ASF 시작 후 약 1시간 뒤에 시작되며, (필요한 경우) 6시간마다 반복됩니다. MatchActively 기능은 세트 완성을 향해 지속적으로 나아갈 수 있도록 돕는 장기적이고 주기적인 조치로 설계되었습니다. 다만 ASF를 24시간 내내 실행하지 않는 사용자라면 match **명령어**를 사용하는 것도 고려해볼 만합니다. 이 모듈의 대상 사용자는 주 계정과 "보관용(stash)" 부계정이지만, MatchEverything으로 설정되지 않은 모든 봇에서 사용하실 수 있습니다. 이에 더해, 아이템이 500000개를 초과하는 봇은 과도한 오버헤드로 인해 매칭 대상으로 허용되지 않으므로, 이런 경우에는 인벤토리를 여러 계정으로 분산시키는 것을 권장드립니다.

ASF는 이 옵션을 사용함으로써 발생하는 요청량과 부하를 최소화하는 동시에, 매칭 효율성을 상한선까지 극대화하기 위해 최선을 다합니다. 매칭할 봇을 선택하고 전체 프로세스를 조율하는 정확한 알고리즘은 ASF의 구현 세부사항에 해당하며, 피드백, 상황, 그리고 향후 가능한 아이디어에 따라 변경될 수 있습니다.

현재 버전의 알고리즘은 ASF가 Any 봇, 특히 아이템의 게임 다양성이 더 풍부한 봇을 우선적으로 처리하도록 합니다. Any 봇이 소진되면, ASF는 동일한 다양성 규칙에 따라 Fair 봇으로 넘어갑니다. ASF는 가능한 세트 완성 진행 상황을 놓치지 않도록, 이용 가능한 모든 봇을 최소 한 번씩은 매칭 시도합니다.

MatchActively는 tbadd **명령어**를 통해 거래에서 블랙리스트로 지정한 봇들을 고려하여, 해당 봇들과는 능동적으로 매칭을 시도하지 않습니다. 이는 저희가 활용할 만한 잠재적인 중복 아이템(dupe)을 가지고 있더라도, ASF에게 특정 봇과는 절대 매칭하지 말라고 지시하는 용도로 사용할 수 있습니다.

ASF는 또한 거래 제안이 정상적으로 처리되도록 최선을 다합니다. 보통 6시간마다 실행되는 다음 실행 주기에서, ASF는 아직 수락되지 않은 대기 중인 거래 제안을 모두 취소하고, 더 활동적인 봇을 우선시할 수 있도록 해당 거래에 관련된 steamID들의 우선순위를 낮춥니다. 다만 우선순위가 낮아진 봇들이 저희가 필요로 하는 매칭 항목을 가진 마지막 봇이라면, 여전히 (다시) 그 봇과의 매칭을 시도합니다.

---

MatchActively를 사용하는 데 왜 LicenseID가 필요한가요? 예전에는 무료 아니었나요?

ASF는 2015년 10월 프로젝트 시작 당시부터 지금까지 계속 무료이며 오픈소스로 유지되고 있으며, 앞으로도 그럴 것입니다. ItemsMatcher 플러그인과 이에 따른 MatchActively 기능의 소스코드는 저희 저장소(repository)에 공개되어 있으며, ASF 프로그램은 완전히 비영리이기 때문에 저희는 이에 대한 기여, 빌드, 배포 등을 통해 어떠한 수익도 얻지 않습니다. 지난 7년 이상의 기간 동안 ASF는 엄청난 양의 개발이 이루어져 왔으며, 매월 안정 버전 릴리스마다 지금도 계속 개선 및 향상되고 있습니다. 이는 주로 단 한 명, **JustArchi**에 의해 - 아무런 대가 조건 없이 이루어지고 있습니다. 저희가 받는 유일한 자금은 사용자들로부터 받는 비강제적인(non-obligatory) 후원금입니다.

오랫동안, 2022년 10월까지는, MatchActively 기능이 ASF 코어의 일부로 포함되어 있어 누구나 무료로 사용할 수 있었습니다. 2022년 10월, Steam 운영사인 Valve가 다른 봇들의 인벤토리를 가져오는 것에 매우 엄격한 속도 제한(rate limit)을 적용했습니다 - 이로 인해 기존 기능이 완전히 망가졌으며, 이 문제를 해결할 방법이 전혀 없었습니다. 결국 이 기능은 고칠 수 있는 가능성이 전혀 없이 완전히 작동 불능 상태가 되어버렸기 때문에, ASF 코어에서 낡은(obsolete) 기능으로 제거할 수밖에 없었습니다.

MatchActively는 완전히 새롭게 재설계된 개념을 기반으로, ASF에 능동적인 카드 매칭 기능을 추가로 강화하는 공식 ItemsMatcher 플러그인의 일부로 부활했습니다. MatchActively를 되살리기 위해서는 저희 쪽에서 엄청난 양의 작업이 필요했습니다. 인벤토리 확인을 위해 수백 개의 유료 프록시가 연결된, 서버에서 호스팅되는 완전히 새로운 ASF 백엔드 서비스를 구축해야 했으며, 이는 오직 ASF 클라이언트들이 예전처럼 MatchActively를 계속 사용할 수 있도록 하기 위한 것이었습니다. 여기에 투입된 작업량과, 매월 저희가 직접 부담해야 하는 무료가 아닌 리소스(도메인, 서버, 프록시)를 고려하여, 저희는 이 기능을 후원자들, 즉 이미 매월 ASF 프로젝트를 후원해주고 계신 분들께 제공하기로 결정했습니다. 이분들 덕분에 이러한 유료 리소스를 마련할 수 있었습니다.

저희의 목표는 이를 통해 수익을 내는 것이 아니라, 이 옵션을 제공하는 데 오로지 소요되는 월간 비용을 충당하는 것뿐입니다 - 그래서 사실상 거의 무료나 다름없는 수준으로 제공하고 있지만, 매달 저희 사비로 수백 달러를 감당할 수는 없기 때문에 어느 정도는 비용을 청구할 수밖에 없습니다. 가격에 대해서도 저희가 딱히 논의할 수 있는 입장은 아닙니다. 이런 비용을 저희에게 강요한 것은 Valve이며, 대안이라고 해봐야 이 기능 자체를 아예 제공하지 않는 것뿐입니다. 물론 어떤 이유로든 이런 조건 하에서 저희 플러그인 사용을 정당화할 수 없다고 판단하신다면, 그 대안을 선택하셔도 됩니다.

어쨌든, MatchActively가 모두를 위한 기능은 아니라는 점을 저희도 이해하고 있으며, 왜 저희가 이를 무료로 제공할 수 없는지도 이해해주시기를 바랍니다. 만약 이 기능의 비용 부담을 도와줄 사람이 아무도 없었다면, 애초에 이 기능 자체가 존재하지 않았을 것입니다. 아무도 유지하고 싶어 하지 않는 월간 비용을 저희가 줄일 수밖에 없었을 것이기 때문입니다. 다행히도 저희는 그보다는 나은 상황에 있으며, 이러한 조건 하에서 MatchActively를 사용할지 말지는 본인이 직접 결정하실 수 있습니다.

---

어떻게 접근 권한을 얻을 수 있나요?

ItemsMatcher는 **JustArchi의 GitHub**에서 월 $5 이상 후원 등급의 일부로 제공됩니다. 일회성 후원자가 되는 것도 가능하지만, 이 경우 라이선스는 한 달간만 유효합니다(동일한 방식으로 연장 가능). $5 등급(또는 그 이상)의 후원자가 되신 후에는, 설정 섹션을 참고하여 LicenseID를 발급받아 입력하시면 됩니다. 이후에는 선택한 봇의 TradingPreferences에서 MatchActively를 활성화하기만 하면 됩니다.

라이선스는 서버로 보낼 수 있는 요청 수를 제한합니다. $5 등급은 봇 계정 1개에 대해 MatchActively를 사용할 수 있게 해주며(하루 4회 요청), $5가 추가될 때마다 봇 계정이 2개씩 추가됩니다(하루 8회 요청). 예를 들어, 계정 3개에서 이 기능을 사용하고 싶으시다면, $10 등급 이상이면 충분합니다.