検索オプション

概要

検索オプション（プロファイル）は、プレイヤーごとに検索の挙動（並び順・件数上限・在庫表示など）を個別に設定できる仕組みです。これにより、利用者は好みに合わせた検索結果を得られ、UX が向上します。設定は JSON 形式で保存されます。

設定ファイルは各プレイヤーごとに次の場所へ保存されます。初回利用時に自動生成されます。

plugins/AdvancedShopFinder/playerdata/<player-uuid>/config.json

ゲーム内での編集

このページで説明する各プロファイルは、ファイルを直接編集しなくても、ゲーム内から編集・選択できます。

• /sf setting で GUI（チェストインベントリ）を開き、並び順・件数上限・在庫表示などを操作できます。保存すると config.json に書き込まれます。
• 検索コマンドに -p <プロファイル名> / --profile <プロファイル名> を付けると、そのプロファイルを一時的に適用して検索できます（例: sf search diamond -p mining）。

操作方法の詳細は検索プロファイル設定を参照してください。以降のセクションでは、これらの操作で読み書きされる JSON ファイルの構造を説明します。

ファイル構造

トップレベルは PlayerFindOption で、次のフィールドを持ちます。

各プロファイルの実体は FindOption で、次のフィールドを持ちます。

設定例

{
  "setting": "default",
  "findOptions": {
    "default": {
      "version": 1,
      "limitAmountOption": {
        "buyFindLimit": -1,
        "sellFindLimit": -1
      },
      "sortOption": {
        "buySortTypes": ["DESC_PRICE_PER_ITEM"],
        "sellSortTypes": ["ASC_PRICE_PER_ITEM"]
      },
      "showNoStockShop": false,
      "showOwnerNotHasEnoughMoneyShop": false
    }
  }
}

SortType 一覧

buySortTypes / sellSortTypes の各要素には次のいずれかの値を指定できます。リストは優先順位順で、先頭が第一ソート基準、値が同じショップ同士は次の要素で比較されます（多段ソート）。

:::tip 多段ソートの例 "sellSortTypes": ["ASC_DISTANCE", "ASC_PRICE_PER_ITEM"] とすると、まず距離が近い順に並び、距離が同じショップはアイテム単価が安い順に並びます。GUI（/sf setting）では優先度スロットを Shift クリックで上下に並べ替えできます。 :::