Searchables MODは、Minecraft Java版で他のMODが使う検索・絞り込み・自動補完を支える前提ライブラリです。必要とするMODのゲーム版とローダーを確認し、対応するSearchablesと依存ファイルをそろえます。
単体で全画面に検索欄を追加するものではありません。導入後に確認する場所は、Searchablesを利用するMOD側の検索機能です。起動時の依存不足と、検索画面の対応を分けて調べます。
配布条件と公式・作者資料は2026年10月14日に確認しました。実機導入や検索操作の検証は行っていません。
Searchablesは検索と自動補完の前提ライブラリ
作者の配布説明は、要素の属性に基づく検索・絞り込みと、自動補完を他のMODへ提供するライブラリとしてSearchablesを紹介しています。作者は単体では機能せず、他のMODに使われることを明記しています。
導入を求めるMODやパックがある場合、その案内や依存欄からSearchablesの要求版を確認します。すでに含まれている構成では、同じライブラリを再度追加する前に版を照合します。
作者READMEには開発者向けの検索条件や入力欄の実装例があります。プレイヤーはコードをビルドする代わりに、対応する正規配布ファイルを選び、利用側MODの操作資料を読みます。
対象ゲーム版とFabric APIをそろえる
正規配布ファイル一覧でMinecraft版とFabricを選びます。2026年10月14日に確認したreleaseの例は以下です。
| Minecraft Java版 | Searchables | required依存 |
|---|---|---|
| 1.21.1 | 1.0.2 | Fabric API |
| 26.3 | 1.0.3 | Fabric API |
この表はFabric用です。Fabric APIも同じゲーム版のファイルを選び、Searchablesを要求するMODの版条件を満たす構成にします。
Forge・NeoForgeで遊ぶパックでは、そのローダーの対応ファイルを確認します。配布時のゲーム版とローダーを合わせ、その構成向けのJARを選びます。
Minecraft公式の26.3公開情報は本体の更新です。既存構成を変える際は、Searchablesと利用側のMODが対応する版まで確認します。
検索を使うクライアントのmodsへ導入する
Searchablesの配布ページはクライアント専用として案内しています。検索を使うプレイヤーの構成が対象です。マルチでは管理者が指定するパックと利用ルールを確認します。
ゲームを終了し、対象プロファイルのMOD・設定・ワールドをコピーします。Fabricでの導入例は次の順です。
- Searchablesを要求するMODと、対象のゲーム版・ローダー・要求版を確認します。
- 遊ぶ版のFabricプロファイルを選び、パックがあればその指定構成にそろえます。
- 正規配布元で、条件を満たすSearchablesとFabric APIを選びます。
- 対象プロファイルのmodsへ、JARを展開せずに置きます。
- 置き換える旧JARはmodsの外へ保管し、新旧の二重導入を避けます。
- 対象構成で起動し、Searchablesを使うMODの検索画面を確認します。
Fabric公式のMOD導入資料が案内する標準クライアントの場所は以下です。別ランチャーや変更したゲームディレクトリでは、その構成の保存先を使います。
| OS | Fabric標準クライアントのmods |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
導入後は利用側のMODで検索機能を確認する
まず、Searchablesを利用するMODが同じ構成へ導入されているかを確認します。次に、そのMODの作者資料が示す検索画面を開きます。
入力できる条件や検索対象、補完候補は利用側の実装に左右されます。Searchablesの開発用サンプルにある条件を、そのまま任意の画面で使える共通コマンドとして扱いません。
| 確認する段階 | 見るもの |
|---|---|
| 導入状態 | 利用側MOD・Searchables・依存ファイルの版 |
| 画面への入口 | 利用側MODの操作資料と割り当て |
| 検索できる対象 | 利用側が公開する検索条件 |
| 補完候補 | その画面が補完を実装しているか |
通常の検索語で結果を確認してから、利用側が案内する絞り込み条件を試します。画面自体が見つからない場合は、Searchablesの追加前に利用側MODの構成と操作を照合します。
起動エラーと検索画面の対応を切り分ける
ゲームが起動前に止まる問題と、起動するが検索できない問題では、確認する条件が違います。エラーにある依存名と要求範囲を読み、対象の構成へ入れたファイルを照合します。
| 状況 | 確認するもの |
|---|---|
| Searchablesが不足している | 実際に起動するプロファイルのmods |
| 要求版に合わない | 利用側MODの要求範囲とSearchablesの版 |
| Fabric API不足が表示される | APIの有無、対象Minecraft版 |
| 同じMODが重複している | 新旧JARや追加した二つのファイル |
| 検索画面が出ない | 利用側MODの導入・操作・対応機能 |
| 特定の条件だけ検索できない | 利用側が対応する条件と入力方法 |
ファイルを変更する場合は一つずつ行い、保存した元の構成と比べます。検索機能の問題は利用側MODの資料も確認し、ライブラリ単体の導入で画面が増えるとは判断しません。
続く問題は、作者のIssuesへゲーム版・ローダー・Searchablesと利用側の版・対象画面・症状を添えられます。
更新・削除は利用側の依存も確認する
更新前はゲームを終了し、JAR・設定・使用ワールドを同じ組としてコピーします。新しいSearchablesが利用側MODの要求を満たすか、Fabric APIも対象版に合うかを確認して入れ替えます。
利用をやめる場合は、Searchablesを必要とするMODが残るかを確認します。要求元が残る構成で前提だけを取り外すと、起動条件を満たせなくなる場合があります。
取り外すJARはmodsの外へ保管し、コピーした環境で起動と残す機能を確認します。Fabric APIを他のMODも使う場合は、それらの要求を確認して残します。
まとめ：Searchablesは利用MODと対応版を合わせる
Searchablesは、利用側MODの検索・絞り込み・補完を支えるライブラリです。ゲーム版とローダー、要求版、Fabric用のFabric APIをそろえて導入し、確認は利用側の検索画面で行います。
起動エラーと画面の対応を分けて調べ、更新・削除では元の構成と他のMODの依存を確認します。
コメント