ItemsMatcherPlugin zh HK
This page is work-in-progress. For translators: you may want to wait a bit (until stable release), as the page is still being written and corrected.
ItemsMatcherPlugin is official ASF plugin that extends ASF with ASF STM listing features. In particular, this includes PublicListing in RemoteCommunication and MatchActively in TradingPreferences.
ๆๅ็ๅ
ฌ้ ASF STM ๆธ
ๅฎไฝไบ**ๆญค่**๏ผๅฎ่ขซ็จไฝไฝฟ็จMatchActively็ASF็จๆถ็ๅ
ฌๅ
ฑๆๅ๏ผไปฅๅๅนซๅฉASFๅ้ASF็จๆถ้ฒ่กๆๅๅน้
ใ
่ซๆณจๆ๏ผๅฆๆๆจๆช็ฌฆๅๆๆ่ฆๆฑ๏ผๆจๅฐไธๆๅจ็ถฒ็ซไธ้กฏ็คบ ใ ASF won't even bother communicating with our server in this case, so this section is entirely skipped for you if you didn't intentionally enable SteamTradeMatcher in order to help yourself match dupes. Also public listing is compatible only with latest stable version of ASF and may refuse to display outdated bots, especially if they're missing core functionality that can be found only in newer versions.
็ป้ๅพ๏ผASF ๆ็ผ้ไธๆฌกๅๅงๆธๆ๏ผๅ ถไธญๅ ๅซๅ ฌ้ๆธ ๅฎๆไฝฟ็จ็ๆๆๅฑฌๆงใ ็ถๅพ๏ผๆฏ10ๅ้๏ผASF ็ผ้ไธๅ้ๅธธๅฐ็ๅฟ่ทณ่ซๆฑ๏ผ้็ฅๆๅ็ไผบๆๅจๆฉๆขฐไบบไปๅจ้่กใ ๅฆๆ็ฑๆผๆ็จฎๅๅ ๅฟ่ทณ่จ่ๆฒๆๅฐ้๏ผไพๅฆ็ฑๆผ็ถฒ็ตกๅ้ก๏ผASF ๅฐๆฏๅ้้่ฉฆ็ผ้ไธๆฌก๏ผ็ดๅฐไผบๆๅจ่จปๅๅฎใ
้ๅ ่จฑๆๅ็็ถฒ็ซ่จ้ๅชไบๅธณๆถๅฏ็จๆผๅน้ ๏ผไปฅๅๅฎๅๆฏๅฆไป่ๆผๆดปๅ็ๆ ใ ๅค่งไบ้ไธ้ป๏ผๆๅ็็ถฒ็ซๅฏไปฅ้กฏ็คบๅจ้ๅป15ๅ้ไธญๆดป่บ็ๆๆๅ็จ ASF 2FA ๅ STM ็ๅธณๆถใ
็จๆถๆ็
งไปๅ็ๅบซๅญ๏ผๆ้ๅบๆๅบ๏ผโโ้ฆๅ
ๆฏMatchEverythingๆฉๆขฐไบบ๏ผAnyๆฉซๅน
ๆๅณ่ๅฎๆฅๅๆๆ1๏ผ1ไบคๆ๏ผ็ถๅพๆฏ็ฌฆๅMatchableTypes็้ๆฒ่จๆธ๏ผๆๅพๆฏ็ฌฆๅMatchableTypes็็ฉๅ่จๆธใ
ASF STM ๆธ ๅฎๆซๆๅชๆฅๅ ASF ๆฉๆขฐไบบใ ็ฎๅ็กๆณๅจๆๅ็ๆธ ๅฎไธญๅๅบ็ฌฌไธๆนๆฉๆขฐไบบ๏ผๅ ็บๆๅ็กๆณ่ผ้ฌๆฅ็ๅ ถไปฃ็ขผไธฆ็ขบไฟๅฎๅ็ฌฆๅๆๅ็ๆดๅไบคๆ้่ผฏ๏ผใ
If you're looking for easy way to access our listing in programmatic way, we have a very simple /Api/Listing/Bots endpoint that you can use. ้ไนๆฏASFๅจๅ
ง้จ็จๆผMatchActively็จๆถ็็ซฏ้ปใ
If you agree to being listed in our listing, by enabling SteamTradeMatcher and not refusing PublicListing, as specified above, we'll temporarily store some of your Steam account details on our server in order to provide the core functionality.
Public info (exposed by Steam to every interested party) includes:
- ๆจ็Steam่บซไปฝ้ฉ่ญๅจ๏ผ64ไฝๅฝขๅผ๏ผ็จๆผ็ๆ้ฃ็ต๏ผ
- ๆจ็ๆต็จฑ๏ผ็จๆผ้กฏ็คบ๏ผ
- ๆจ็้ ญๅ๏ผๅๅธ๏ผ็จๆผ้กฏ็คบ๏ผ
Private info (selected data required for providing the functionality) includes:
- Your inventory limited to item types that you've picked in
MatchableTypes(so people can useMatchActivelyagainst your items). - ๆจ็**ไบคๆไปฃ็ขผ**๏ผ็จๆผๅ ่จฑไธๅจๆจๅฅฝๅๅๅฎไธญ็็จๆถๅฐๆจ็ผ่ตทไบคๆ๏ผ
- Your
MaxTradeHoldDuration(so other people know whether you're willing to accept their trades) - ๆจ็
ๅน้ ้กๅ๏ผ็จๆผ้กฏ็คบๅๅน้ ๏ผ - Total number of Steam items in your inventory (for display purposes and matching)
MatchActively setting is active version of SteamTradeMatcher which includes interactive matching in which the bot will send trades to other people. It can work standalone, or together with SteamTradeMatcher setting. This feature requires LicenseID to be set, as it uses third-party server.
็บไบไฝฟ็จ่ฉฒ้ธ้
๏ผๆจๆไธ็ต้่ฆๆปฟ่ถณ็่ฆๆฑใ At the minimum you must have unrestricted account, ASF 2FA active and at least one valid type in MatchableTypes, such as trading cards.
If you meet all of the requirements above, ASF will periodically communicate with our public ASF STM listing in order to actively match bots that are currently available.
- ๅจๆฏไธ่ผชๅน้
ไธญ๏ผ ASF ๅฐ็ฒๅๆๅๅๆธ
ๅฎไธญๅฏ้ธๆฉๆขฐไบบ็็ฉๅๅบซไปฅๆพๅฐ็ฌฆๅ
ๅน้ ้กๅ็็ฉๅใ ๅฆๆๆพๅฐๅน้ ้ ๏ผASF ๅฐ่ชๅ็ผ้ไธฆ็ขบ่ชไบคๆๅ ฑๅนใ - Each set (composition of appID, type and rarity of the item) can be matched in a single round only once. ้ๆจฃๅๆฏ็บไบๆๅคง้ๅบฆๅฐ้ฟๅ ใ็ฉๅไธๅๅฏ็จใ็็ผ็๏ผไธ็ก้ๅจ็ผ้ไบคๆไนๅ็ญๅพ ๆฏๅๆฉๆขฐไบบๅๅบๅๆใ It's also the primary reason why matching is composed of rounds and not one ongoing process.
- ASF ๅจๅฎๅไบคๆไธญ็ผ้็็ฉๅไธๆ่ถ
้
255ๅ๏ผไธฆไธๅฐๅฎๅ็จๆถ็ผ้็ไบคๆๅฐไธๆ่ถ ้5ๅใ ้ๆฏ็ฑ Steam ้ๅถไปฅๅๆๅ่ชๅทฑ็่ฒ ่ผๅนณ่กกๆๆฑบๅฎ็ใ
ๆญคๆจก็ตๆฏๅฎๅ
จ้ๆ็ใ Matching will start in approximately 1 hour since ASF start, and will repeat itself each 6 hours (if needed). MatchActively ็นๆงๆจๅจไฝ็บไธๅ้ทๆ็้ฑๆๆงๆชๆฝไพไฟ้ๆๅ้้ฝๅก็็้ฒ็จๆ็บๆจ้ฒ๏ผไฝๅฆๆๆๅๅฐๅ
ถไฝ็บๅฝไปคไฝฟ็จ๏ผๅฐฑๆ้ ๆ็ญๆๅ
ง็่ณๆบๅฃๅใ The target users of this module are primary accounts and "stash" alt accounts, although it can be used by any bot that is not set to MatchEverything.
ASF does its best to minimize the amount of requests and pressure generated by using this option, while at the same time maximizing efficiency of matching to the upper limit. The exact algorithm of choosing the bots to match and otherwise organize the whole process, is ASF's implementation detail and can change in regards to feedback, situation and possible future ideas.
The current version of the algorithm makes ASF prioritize Any bots first, especially those with better diversity of games that their items are from. When running out of Any bots, ASF will move on to the fair ones upon same diversity rule, with those owning excessive number of items further deprioritized due to higher chance of possible inventory-related problems compared to other bots. Regardless of that, ASF will try to match every available bot at least once, to ensure that we're not missing on a possible set progress.
MatchActively takes into account bots that you blacklisted from trading through tbadd command and will not attempt to actively match them. ้ๅฏไปฅ็จไพๅ่จด ASF ๅฎๆฐธ้ ไธๆ่ฉฒๅน้
ๅชไบๆฉๆขฐไบบ๏ผๅณไฝฟๅฎๅๆๆฝๅจ็ๅน้
็ฉๅๅฏไพๆๅไฝฟ็จใ
ASF is, and remains, free and open-source, as it was established at the start of the project back in October 2015. Our program is also entirely non-commercial, we do not earn anything from contributions to it, building or publishing. Over those past 7+ years ASF has received tremendous amount of development, and it's still being improved and enhanced with every monthly stable release mostly by a single person, JustArchi - with no strings attached. The only funding we receive is from non-obligatory donations that come from our users.
For a very long time, until October 2022, MatchActively feature was part of ASF core and available for everyone to use. In October 2022, Valve, the company behind Steam, has put very severe rate limits that rendered previous functionality entirely broken, with no solution available. The feature therefore has been removed from ASF core in version 5.4.1.0.
MatchActively was resurrected as part of official ItemsMatcher plugin that further enhances ASF with active cards matching functionality. Resurrecting MatchActively feature required from us extraordinary amount of work to create ASF backend, entirely new service hosted on a server, with more than a thousand of proxies attached for resolving inventories, all exclusively to allow ASF clients to make use of MatchActively like before. Due to the amount of work involved, as well as resources that are not free and require to be paid on monthly basis by us (domain, server, proxies), we've decided to offer this plugin to our sponsors, that is, people that already support ASF project on monthly basis. Our goal isn't to profit from it, but rather, cover the monthly costs that are exclusively linked with offering this functionality - that's why we offer it basically for nothing, but we do have to charge a little for it as we can't pay hundreds of dollars from our own pockets just to make it available for you. We hope that you understand.
ItemsMatcher is offered as part of $5+ sponsor tier on JustArchi's GitHub. Simply become a sponsor of $5 tier (or higher), then click here to obtain your LicenseID. You'll need to sign in with GitHub for confirming your identity.
The license allows you to send limited amount of requests to the server. $5 tier allows you to use MatchActively for one account, which should be suitable for majority of people. $10 tier allows you to use it on three accounts. If you require more resources, let us know.
LicenseID is made out of 32 hexadecimal characters, such as f6a0529813f74d119982eb4fe43a9a24. Simply put it in LicenseID property of ASF global config.
 |
 |
 |
 |
|---|---|---|---|
 |
 |
 |
 |
|---|---|---|---|
- ๐ก Home
- ๐ง Configuration
- ๐ฌ FAQ
- โ๏ธ Setting up (start here)
- ๐ฅ ๅพๅฐๅบ่ๅๅๅจ
- ๐ข Commands
- ๐ ๏ธ Compatibility
- ๐งฉ ItemsMatcherPlugin
- ๐ Management
- โฑ๏ธ Performance
- ๐ก Remote communication
- ๐ช Steam ่ฆชๅๅไบซ
- ๐ Trading