コンテンツにスキップ
Komugi

ショップアラート (/shop_alert)

/shop_alert は、経済サーバー等でプレイヤーショップやチャットに流れる出品メッセージを Komugi がリアルタイムに監視し、探しているアイテムが出品された際に即座にトースト通知と効果音で知らせる機能です。

クライアント側に特別な MOD やリソースパックを追加することなく利用できます。

コマンド構文

Section titled “コマンド構文”
/shop_alert add <アイテム名> [上限価格]
/shop_alert remove <アイテム名>
/shop_alert list

主な使い方

Section titled “主な使い方”

1. 監視アイテムの登録 (add)

Section titled “1. 監視アイテムの登録 (add)”

欲しいアイテムの名前（および購入可能な上限価格）を指定して登録します。上限価格を指定しない（または 0）にした場合は、価格に関わらず出品された時点で通知されます。

/shop_alert add ダイヤモンド 500

「ダイヤモンド」（上限価格: 500以下）が出品された際にアラートが鳴るようになります。

2. 登録アイテムの確認 (list)

Section titled “2. 登録アイテムの確認 (list)”

現在アラート登録されているアイテムの一覧を表示します。1セッション（プレイヤー）あたり最大 20 件まで登録可能です。

/shop_alert list

3. 監視アイテムの削除 (remove)

Section titled “3. 監視アイテムの削除 (remove)”

不要になったアイテムの監視を解除します。

/shop_alert remove ダイヤモンド

通知時の動作

Section titled “通知時の動作”

条件に合致する出品メッセージがパケットストリーム内（Text パケット）で検出されると、Komugi は以下の通知を即座にクライアントへ送ります:

  1. トースト通知: 画面上部にアイテム名と価格、出品者の情報をポップアップ表示
  2. チャットメッセージ: チャット欄にハイライト付きで通知テキストを表示
  3. 効果音: 成功音 (random.levelup) を再生

データの永続化

Section titled “データの永続化”

登録したアラート情報はサーバー側の SQLite データベース (komugi.db) 内の shop_watches テーブルに XUID (Xbox 固有 ID) ごとに保存されます。

ログアウトやサーバーの再起動を行っても、次回ログイン時に自動的に監視リストが復元されます。