Bookshelf MODは、Minecraft Java版で他のMODが使う共通コードや機能を提供する前提ライブラリです。導入を求めるMODやパックの条件を確認し、同じゲーム版・ローダーに対応するBookshelfをそろえます。
Fabric用で確認した1.21.1・26.3のファイルは、Fabric APIも必要です。起動エラーでは「不足」「要求版との違い」「ローダーの違い」「重複」を分けて確認します。
配布条件と公式・作者資料は2026年10月14日に確認しました。実機導入やマルチ接続の検証は行っていません。
Bookshelfは他のMODを支える前提ライブラリ
作者の正規配布説明は、共通コード、フレームワーク、ユーティリティなどを他のMODが利用するライブラリとしてBookshelfを紹介しています。プレイヤーが導入する際は、どのMODから要求されているかを確認します。
作者Wikiにも、複数のMODで使う共通処理と、データパック機能の拡張が説明されています。デバッグ用コマンドもありますが、通常の導入では要求元MODの動作に必要な構成をそろえることが先です。
Bookshelfを必要とするMODやパックがすでに自動導入している場合は、その版を確認します。同じライブラリを重ねて追加する必要はありません。
要求元のMODと対応する配布ファイルを選ぶ
正規配布ファイル一覧でMinecraft版とFabricを選びます。2026年10月14日に確認したreleaseの例は、次のとおりです。
| Minecraft Java版 | Bookshelf | required依存 |
|---|---|---|
| 1.21.1 | 21.1.81 | Fabric API |
| 26.3 | 26.3.0.4 | Fabric API |
この表はFabric用の例です。Forge・NeoForgeを使うパックでは、そのローダーの対応ファイルと条件を確認します。ライブラリの名前が同じでも、対象版とローダーが違うファイルを流用しません。
要求元のMODがBookshelfの特定の版や範囲を指定していれば、その指定も満たす必要があります。配布一覧の新しいファイルを選ぶ前に、要求元のゲーム版・ローダー・依存条件と照合します。
Fabric APIも同じMinecraft版のファイルを選びます。Minecraft公式の26.3公開情報に合わせて本体を更新する場合は、Bookshelfを使う他のMODまで対応をそろえます。
対象プロファイルのmodsへ導入する
ゲーム・サーバーを停止し、MOD・設定・ワールドをコピーします。対象の起動構成と、実際にJARを置く保存先を合わせます。
Fabricの導入例は次の手順です。
- Bookshelfを要求するMODと、そのゲーム版・ローダー・要求版を確認します。
- 対象版のFabric構成を用意し、既存パックなら指定された構成にそろえます。
- 正規配布元で、条件を満たすBookshelfとrequired依存を選びます。
- 対象構成のmodsへ、JARを展開せずに置きます。
- 置き換える旧JARはmodsの外へ保管し、同じMODの新旧を重複させないようにします。
- コピーした環境で起動し、Bookshelfを必要とするMODの動作を確認します。
Fabric公式のMOD導入資料が案内する標準クライアントの場所は以下です。別ランチャーや変更したゲームディレクトリ、専用サーバーでは、その構成のmodsを使います。
| OS | Fabric標準クライアントのmods |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
マルチは要求元とサーバー側の構成を確認する
正規配布ページは、Bookshelfをクライアントとサーバーの双方に対応するライブラリとして扱っています。導入先は要求元MODやパックの案内に合わせ、管理者と参加者で構成を照合します。
作者Wikiは、Bookshelfのデータパック拡張を使う条件として、クライアントとサーバーへの導入を説明しています。共有環境でその機能を使う場合も、管理者が採用する構成を確認します。
| 環境 | 確認する条件 |
|---|---|
| シングルのMODパック | パックが含むBookshelfと要求元の版 |
| 専用サーバー | サーバー上の要求元MOD・Bookshelf・依存ファイル |
| マルチ参加者 | 配布されたパックや管理者が指定する構成 |
自分のPCだけを更新して接続できなくなった場合は、サーバー側と指定パックの版を照合します。共有サーバーの構成変更は管理者と合わせて進めます。
不足・版違い・重複のエラーを切り分ける
起動時のエラーでは、Bookshelfという名前だけで判断せず、要求するMOD名と版条件を読みます。追加前に、対象プロファイル内にあるファイルを確認します。
| 表示・状況 | 確認するもの |
|---|---|
| Bookshelfが不足している | 実際に起動する構成のmodsとJARの有無 |
| Bookshelfの版が合わない | 要求元が指定する版・範囲と導入した版 |
| 対応ローダーが違う | Fabric・Forge・NeoForgeの選択条件 |
| Fabric APIも不足している | 選んだBookshelfのrequired欄とAPIの対象版 |
| 同じMODが重複している | 新旧JARや二重に追加したファイル |
| 起動するが要求元の機能が使えない | 要求元MODの設定・利用条件・対象環境 |
版をそろえても続く問題は、元の構成のコピーと比較し、変更を一つずつ確認します。ライブラリを複数の版で追加して解決しようとせず、要求を満たす構成を調べます。
作者のIssuesへ相談する場合は、ゲーム版・ローダー・Bookshelfと要求元の版・エラーの条件を添えられます。
更新・削除はBookshelfを使うMODも確認する
更新前はゲーム・サーバーを停止し、JAR・設定・ワールドを同じ組としてコピーします。Bookshelfだけを新しい版へ変える前に、それを使うMODの対応と要求範囲を確認します。
利用をやめる場合は、Bookshelfを必要とするMODが残るかを確認します。要求元が残る構成では、前提を取り外すと起動条件を満たせなくなるため、要求元と一緒に構成を判断します。
取り外すJARはmodsの外へ保管し、コピーした環境で起動と残したMODを確認します。Fabric APIなどの共有依存は、他のMODからの要求を調べて扱います。
データパック機能を使っている構成では、その機能とワールドも含めて元の環境を保存します。普段使う世界へ変更を採用する前に、保存したコピーで確認します。
まとめ：Bookshelfは要求元と対応版をそろえる
Bookshelfは、他のMODが使う前提ライブラリです。要求元のゲーム版・ローダー・要求範囲に合わせてファイルを選び、Fabric用では確認したFabric APIの条件もそろえます。
起動エラーは不足・版違い・重複を分けて確認します。マルチの構成は管理者と合わせ、更新・削除は要求元MODと元の環境を保管して進めます。
コメント