SteamTokenDumperPlugin は、私たちが開発した公式 ASF プラグイン です。あなたの Steam アカウントがアクセスできるパッケージトークン、アプリトークン、デポキーを共有することで、SteamDB プロジェクトに貢献できます。 収集されるデータの詳細と、SteamDB がそれを必要とする理由については、SteamDB の Token Dumper ページで確認できます。 送信されたデータには潜在的に機密情報は含まれず、上記の説明に記載されているように、セキュリティ/プライバシーリスクはありません。

ASFには、リリースにバンドルされた SteamTokenDumperPlugin が付属していますが、プラグイン自体はデフォルトで無効になっています。 JSON構文で、 SteamTokenDumperPluginEnabled ASFグローバル設定プロパティを trueに設定することで、プラグインを有効にできます。

{
  "SteamTokenDumperPluginEnabled": true
}

ASFプログラムの起動時に、プラグインは標準のASFロギングメカニズムを通じて正常に有効化されたかどうかをお知らせします。 ウェブベースの設定ジェネレータを使用してプラグインを有効にすることもできます。

有効にすると、プラグインはASFで実行しているボットをパッケージトークンの形でデータを収集するために使用します。 あなたのボットがアクセスできるアプリトークンとデポキー。 データ収集モジュールには、データ収集によって生じる追加のオーバーヘッドを最小限に抑えることになっているパッシブルーチンとアクティブルーチンが含まれます。

計画された使用事例を満たすために、上記のデータ収集ルーチンに加えて。 送信ルーチンは、定期的にSteamDBに送信する必要があるデータを決定する責任があるとして初期化されます。 このルーチンは、ASF開始から最大 1 時間で発火し、 24 時間ごとに繰り返されます。 このプラグインは送信する必要があるデータ量を最小限に抑えるために最善を尽くします したがって、プラグインが収集するいくつかのデータは、提出するために役に立たないと判断される可能性があります したがってスキップされます (例えば、アクセストークンを変更しないアプリの更新)。

プラグインは、 config/SteamTokenDumper.cache の場所に保存された永続キャッシュデータベースを使用します。これは、ASFの config/ASF.db と同様の目的を提供します。 このファイルは、収集および送信されたデータを記録し、異なるASF実行に渡って行う必要がある作業量を最小限に抑えるために使用されます。 ファイルを削除すると、プロセスは最初から再起動され、可能であれば避けるべきです。

ASF はリクエストに貢献者の steamID を含めます。これは、ASF で設定した SteamOwnerID として判定されます。設定していない場合は、最も多くのライセンスを所有しているボットの Steam ID が使用されます。 発表された貢献者は、継続的なヘルプのためにSteamDBからいくつかの追加の特典を受け取る可能性があります(e. をクリックします。寄付者はウェブサイト上でランク付けされていますが、それは完全にSteamDBの裁量次第です。

いずれにせよ、SteamDBのスタッフはあなたの助けを事前に感謝したいと思います。 送信されたデータにより、SteamDBを操作し、特にパッケージに関する情報を追跡することができます。 アプリやデポがあれば助けが必要になります

STDプラグインには、 std [Bots]が追加されています。 これにより、オンデマンドで選択したボットのリフレッシュと送信をトリガーできます。 コマンドを使用するには、自動収集と提出をスキップし、手動でプロセスを制御することができます設定を有効にする必要はありません。 もちろん、有効な設定で実行することもできます。これは、予想よりも早く通常の収集や提出手続きを実行するだけです。

利用可能なすべてのボットの更新をトリガーするには、 !std ASF をお勧めします。 ただし、必要に応じて選択したものに対してトリガーすることもできます。

私たちのプラグインは、内部を自分の好みに合わせて調整したい人に役立つかもしれない高度な設定をサポートしています。

高度な設定は ASF.json 内に配置されます:

{
  "SteamTokenDumperPlugin": {
    "Enabled": false,
    "SecretAppIDs": [],
    "SecretDepotIDs": [],
    "SecretPackageIDs": [],
    "SkipAutoGrantPackages": true
  }
}

すべてのオプションについて以下に説明します。

bool type, デフォルト値 false. このプロパティは、上記で説明した SteamTokenDumperPluginEnabled rootレベルプロパティと同じ動作をし、代わりに使用できます。 プラグイン関連の設定全体を独自の構造にしたいと思う人々に捧げられています (おそらく、以下で説明する他の高度なプロパティをすでに使用している人々がほとんどです)。

ImmutableHashSet<uint> 型はデフォルト値が空です。 このプロパティはプラグインが解決しない appID を指定し、すでに解決済みの場合はトークンを送信しません。 このプロパティは、未公開アイテム、特に開発者、パブリッシャー、またはクローズドベータテスターに関する潜在的な機密情報にアクセスできる人に役立ちます。

ImmutableHashSet<uint> 型はデフォルト値が空です。 このプロパティは、プラグインが解決しない depotID を指定し、すでに解決されている場合は、キーを送信しません。 このプロパティは、未公開アイテム、特に開発者、パブリッシャー、またはクローズドベータテスターに関する潜在的な機密情報にアクセスできる人に役立ちます。

ImmutableHashSet<uint> 型はデフォルト値が空です。 このプロパティは、プラグインが解決しない packageID ( subIDとも呼ばれます) を指定します。 既に解決済みの場合はトークンを提出しないでください このプロパティは、未公開アイテム、特に開発者、パブリッシャー、またはクローズドベータテスターに関する潜在的な機密情報にアクセスできる人に役立ちます。

bool type, デフォルト値 true. このプロパティは SecretPackageIDs と非常によく似た動作をします。有効にすると、EPaymentMethod が AutoGrant のパッケージは、以下で説明する解決処理中にスキップされます。 AutoGrant の支払い方法は、 Steamworks が開発者アカウントにパッケージを自動的に付与するために使用します。 これは他の Secret オプションほど明示的ではないため、何かを保証するものではありません（AutoGrant 以外にも、送信したくないパッケージがある可能性があるためです）。それでも、すべてではないとしても、大半の secret パッケージをスキップするには十分なはずです。 このオプションはデフォルトで有効です。実際に AutoGrant パッケージへアクセスできる人が、それらを一般公開に漏らしたいと思うことはほとんどないため、false の値を使用する状況はかなり限られます。

ルートレベルでは、すべてのSteamアカウントがパッケージ(ライセンス、サブスクリプション)のセットを所有しています。 packageID ( subID とも呼ばれます) によって分類されます。 すべてのパッケージには、 appID によって分類されたいくつかのアプリが含まれています。 すべてのアプリは、 デポIDによって分類されたいくつかのデポを含めることができます。

├── sub/124923
web+graphie://292030
web+graphie://ka-perseus-graphie.s3.amazonaws.com/web+graphie://ja-perseus-graphie.s3.amazonaws.com/web+graphie://ja-perseus-graphie.s3.amazonaws.com/ja-perseus-graphie.s3.amazonaws.com/ja-perseus-graphie.s3.amazonaws.com/124923
web+graphie:/ka-perseus-graphie.s3.amazonaws.com/ja-perseus-graphie.s3.amazonaws.com/2030

├── app/378649
├── ...
└── ...

私たちのプラグインには、スキップされた項目を考慮する 2 つのルーチンが含まれています - 解決ルーチンと提出ルーチン。

resolve ルーチンは上記のツリーを解決する責任があります。 事前にパッケージ/アプリ/デポをブラックリストに載せることで、 ブラックリストに登録されているブランチ/リーフの代わりに、残りの部分を指定することなく、効果的にツリーをカットします。 上記の例で、124923 パッケージが SecretPackageIDs または SkipAutoGrantPackages によって無視され、それが 292030 appID にリンクしている唯一の所有パッケージだった場合、appID 292030 も解決されません。また定義上、292031 および 378648 Depot にリンクしている解決済みアプリが他に存在しない場合、それらも解決されません。 ただし、プラグインがすでにツリーを解決している場合、効果的には与えられた項目が更新されないようにすることに注意してください。 新しいアプリが追加されました)、既に解決された既存のアイテムについてプラグインを「忘れる」ことはありません(e. を選択します。 スキップ系のオプションを有効にしたばかりで、ASF がすでに解決済みのツリーをたどらないようにしたい場合は、プラグインがキャッシュを保持している config/SteamTokenDumper.cache ファイルを一度削除することを検討してください。

提出ルーチンは、(上記の resolve ルーチンによって)すでに解決されたアイテムのパッケージトークン、アプリトークン、デポキーを送信する責任があります。 ここでは、ブラックリストは、プラグインがすでに情報を解決している場合でも、即時の効果があります。 ブラックリストに登録されている場合、解決されているかどうかに関わらず、提出ルーチンはSteamDBに送信しません。 しかし、私たちはもうこの時点で木について話していないことを覚えておいてください。 このアプリの情報がこのパッケージから来ているかどうかは分かりませんが ブラックリストに載っているアイテムの情報は他との関係を問わず省略されます

ほとんどの開発者やパブリッシャーにとっては、SkipAutoGrantPackages を有効にしておくだけで十分なはずです。必要に応じて SecretPackageIDs のみを併用して強化できます。これにより、ツリーを開始分岐の時点で効果的に切り落とし、同じアプリにリンクしている他のパッケージが存在しない限り、その先に含まれるアプリや Depot が送信されないことを保証できます。 確認したい場合は、それに加えて、 SecretAppIDを使用することもできます。 ブラックリストに登録していないライセンスがあっても、アプリの解決を飛ばします。 特定の値がない限り、 SecretDepotID を使用する必要はありません。 特定の必要性 (パッケージやアプリに関する情報を送信中に特定のデポのみをスキップするなど) さらに別の層を追加してトリプルセーフにしたい場合にも。