koishi-plugin-apexrankwatch
koishi-plugin-apexrankwatch は、Koishi向けのApex Legendsクエリ＆モニタリングプラグインです。
プレイヤーのランク、スコア、レベル、オンラインステータス、シーズン終了時刻、マスター/プレデター数とプレデターカットオフスコアの取得に対応しています。また、グループチャットでプレイヤーのスコア変動を継続的に自動監視し、通知をプッシュすることも可能です。
機能特徴
- プレイヤーの現在のランク、RP、レベル、オンラインステータス、現在のヒーロー、UIDを取得
uid:/uuid:プレフィックスによるクエリに対応- プラットフォーム自動フォールバック:
PC -> PS4 -> X1 -> SWITCH - 現在のシーズン終了時刻の取得に対応
- マスター/プレデター数とプレデターカットオフスコアの取得に対応
- グループチャットでのプレイヤースコア継続監視と自動通知に対応
- 旧バージョンのKoishiプラグインの使用習慣と履歴データディレクトリとの互換性を維持
- 異常なスコア低下やAPI異常に対する保護機能を実装し、誤ったデータによる元の記録の上書きを防止
インストール
yarn add koishi-plugin-apexrankwatch
インストール後、Koishiでプラグインを有効にし、利用可能なApex API Keyを入力してください。
よく使うコマンド
/apextest/apexhelp/apexrank <プレイヤー名|uid:...> [プラットフォーム]/apexrankwatch <プレイヤー名|uid:...> [プラットフォーム]/apexranklist/apexrankremove <プレイヤー名|uid:...> [プラットフォーム]/apexpredator/apexseason/apexblacklist <add|remove|list|clear> <プレイヤーID>/シーズン終了/シーズン開始
コマンドエイリアス
apexヘルプapexrankhelpapexクエリクエリapex監視継続クエリapexリストapex削除継続クエリ解除apexプレデターapexシーズン新シーズンapexテストapexブラックリストクエリ禁止apexban
使用例
プレイヤーのクエリ:
/apexrank moeneri
/apexrank moeneri pc
/apexrank uid:1010153800824
グループ監視の追加:
/apexrankwatch moeneri
/apexrankwatch moeneri ps4
監視リストの確認:
/apexranklist
監視の削除:
/apexrankremove moeneri
シーズン情報のクエリ:
/apexseason
/新シーズン
プレデターカットオフスコアのクエリ:
/apexpredator
使用上の注意
- プラットフォームが指定されていない場合、プラグインは自動的に複数のプラットフォームを試行します
- 同名プレイヤーが複数のプラットフォームで監視されている場合、削除時には明示的にプラットフォームを指定することを推奨します
- シーズン情報は公開サイト
apexseasons.onlineから取得します - プレイヤークエリ、監視、プレデターカットオフスコアは
api.mozambiquehe.reに依存します - 利用可能なAPI Keyが設定されていない場合、プラグインはロード可能ですが、オンラインクエリ機能は利用できません
データディレクトリ
デフォルトのデータディレクトリ:
./data/apexrankwatch
主要ファイル:
groups.json: グループ監視データsettings.json: 動的ブラックリストとシーズンキーワードのオン/オフ
ライセンス
MIT