Puzzles Libは、作者FuzsのMinecraft MODを支える共通ライブラリです。単体で新しいブロック・アイテム・モブを追加するためのMODではありません。利用するMODが必須依存に挙げている場合は、そのMODと同じゲーム版・ローダーに合わせて入れます。Fabric用では、作者がFabric APIとForge Config API Portも必要と案内しています。
2026年10月14日にゲーム公式情報、作者の正規配布説明、公開READMEと対応ファイルを確認しました。筆者による実機での起動や、依存するMODすべての組み合わせ検証は行っていません。本記事の対象はFuzsのPuzzles Libで、配布識別子はpuzzles-libです。
Puzzles LibはFuzsのMODを動かすための共通基盤
作者の配布ページは、Puzzles Libが主に自身のMOD向けに作られていると説明しています。設定、通信、イベント、登録処理などの共通部分を担当し、ライブラリ自身が遊びのコンテンツを追加するわけではありません。
そのため、Puzzles Libを入れても目的のMODのアイテムが見えないときは、MOD本体を導入したかを分けて確認します。ライブラリがあればFuzsの全MODが自動で入る、という仕組みではありません。必要な本体と共通部品の両方をそろえます。
Puzzles Libが必要かは、使うMODのファイルページにある必須依存を確認してください。作者名が同じだからと、すべての版で同じライブラリ条件になるとは限りません。エラーが出ているなら、要求された版の範囲と実際に入れた版をメモします。
| 確認項目 | 何を調べるか |
|---|---|
| 依存元MOD | どのMODがPuzzles Libを必要としているか |
| ゲーム版 | Minecraftの正確なバージョン |
| ローダー | Fabric・Forge・NeoForgeのどれか |
| ライブラリ版 | 依存元が要求する範囲に入るか |
| 追加依存 | 選んだローダーの必須条件 |
NeoForge用の確認版とFabric用の条件を分ける
2026年10月14日に配布ファイル一覧で、以下のNeoForge用releaseを確認しました。この二つのファイルには、追加の依存MODは記載されていません。NeoForgeローダー自体は必要です。
| Minecraft Java版 | 確認したPuzzles Lib版 | 確認ローダー |
|---|---|---|
| 1.21.1 | 21.1.64 |
NeoForge |
| 26.3 | 26.3.14 |
NeoForge |
作者の公開READMEにも、ゲーム版ごとの配布先と保守状況が分けて掲載されています。Minecraft 1.21.1と26.3は別の構成です。ライブラリの番号だけでなく、配布ページの対象ゲーム版を確認してください。
Fabric用については、作者の配布説明がFabric APIとForge Config API Portを必要と案内しています。後者にForgeという名前が含まれていても、Fabric環境で使う依存として説明されているライブラリです。名前だけを見てNeoForge用の本体JARへ混ぜないようにします。
Minecraft公式の26.3公開情報はゲーム本体の案内です。ゲームの更新に合わせる場合は、Puzzles Libだけでなく、依存元MODとローダーの対応もそろえる必要があります。上のNeoForge用表からFabric用の追加依存が不要だと判断しないでください。
導入は必要とするMODと同じプロファイルへ行う
導入先は、実際にプレイするローダーのプロファイル内のmodsです。通常のゲーム、MODパックの独立したインスタンス、専用サーバーが同じ保存先を使うとは限りません。先に対象のゲームディレクトリを確かめます。
- ゲームやサーバーを停止し、現在のMOD・設定・ワールドをコピーして残します。
- 依存元MODが求めるゲーム版、ローダー、Puzzles Libの版を確認します。
- 作者配布ページで条件に合うPuzzles Libと、必要なら追加依存を選びます。
- 対象の
modsへJARを置きます。展開する必要はなく、同じライブラリの旧版を二重に残さないようにします。 - 対応するプロファイルで起動し、依存元MODの機能と起動ログを確認します。
NeoForgeの公式案内やFabric公式の導入説明に従ってください。GitHubの開発用Maven記述を、プレイヤーがゲーム内で入力する手順として扱う必要はありません。通常の導入は対応する配布ファイルを置く作業です。
エラーは必要な側とファイルの条件から確認する
ライブラリが見つからない場合は、ファイルを増やす前に保存先を確認します。別のプロファイルのmodsに入っていれば、いま起動している構成では読まれません。複数のPuzzles Libを無条件に追加すると、重複という別の問題まで生じる可能性があります。
| エラーや状態 | 確認する点 |
|---|---|
| 必須MODがないと表示 | 対象mods内に、正しいPuzzles Libがあるか |
| 版の範囲が合わない | 依存元の要求と導入版が一致するか |
| Fabricで追加依存が足りない | Fabric APIとForge Config API Portの条件 |
| NeoForgeで読み込めない | Fabric用やForge用を混ぜていないか |
| 起動したが目的の機能がない | 依存元MOD本体とその設定 |
不具合を報告するときは、作者のIssuesへゲーム版、ローダー、Puzzles Lib、依存元MODの版を添えます。エラー文が依存元MODを指している場合もあるため、ライブラリだけが原因だと先に決めつけないことが大切です。
マルチでは管理者が指定する構成と合わせる
作者の配布説明はクライアントとサーバーへの導入を案内しています。Puzzles Libを使うMOD構成でマルチを行うなら、管理者と参加者が必要な依存を確認してください。参加者のPCへライブラリだけを入れて、サーバー側の不足を解消できるわけではありません。
共通ライブラリの導入条件と、依存元MODがどちら側で動くかも分けて調べます。クライアント専用の機能を使うために、無関係なサーバーへすべてのMODを追加する手順にはしません。管理者の配布構成にPuzzles Libが含まれていれば、その版を確認して使います。
更新・削除は依存元MODを残すかどうかで判断する
更新前には元のJARと設定、ワールドを保存します。新しいPuzzles Libが依存元の要求範囲に入るかを確認し、ゲーム版・ローダーも合わせて入れ替えてください。新旧JARを並べて置いたまま起動する方法は避けます。
使わなくなったMODを一つ削除しても、別のMODがPuzzles Libを使っていればライブラリは残します。逆に、ライブラリを外したまま依存元を残せば、起動条件を満たさなくなる場合があります。依存関係を一つずつ確認して整理してください。
ワールドへブロックやアイテムを追加した依存元MODも削除する場合は、そのMODの注意事項が必要です。Puzzles Lib自身がコンテンツを追加しないことを、依存元の追加物まで安全に外せる保証にはしません。変更はワールドのコピーで確認し、元の構成へ戻せる状態を残しましょう。
※サムネイルは編集部作成の概念図です。実際のゲーム画面や公式画像ではありません。
コメント