Puzzles Libは、Minecraft Java版でFuzsのMODが利用する共通機能を提供する前提ライブラリです。導入を求めるMODのゲーム版・ローダー・要求版に合わせ、必要な依存ファイルをそろえます。
今回確認したFabric用は、Fabric APIとForge Config API Portの双方が必須です。マルチでは作者の両側導入の案内と、参加先パックの構成を確認します。
配布条件と公式・作者資料は2026年10月14日に確認しました。実機導入やゲーム内動作・マルチ接続の検証は行っていません。
Puzzles Libは要求元MODの共通機能を支える
作者の正規配布説明は、設定・通信・イベント・登録などの共通機能を、対応するMODへ提供するライブラリとしてPuzzles Libを紹介しています。
単体でブロックやアイテム、Mobなどのゲーム内容を追加するものではありません。必要とするMODの依存欄に指定があれば、そのMODと組み合わせて導入し、有効な状態で使います。
既存パックに含まれている場合は、その版を先に確認します。起動に必要なライブラリを追加する作業と、利用側MODの設定や操作を確認する作業を分けます。
Fabric用は二つの必須依存もそろえる
正規配布ファイル一覧で、Minecraft版とFabricを選びます。2026年10月14日に確認したreleaseの例は次のとおりです。
| Minecraft Java版 | Puzzles Lib | required依存 |
|---|---|---|
| 1.21.1 | 21.1.64 | Fabric API、Forge Config API Port |
| 26.3 | 26.3.15 | Fabric API、Forge Config API Port |
Forge Config API Portは、Forge・NeoForge形式の設定処理を他のローダーでも利用するためのライブラリです。任意のForge用MODをFabric上で動かす変換器としては使えません。
Fabric APIとForge Config API Portも、対象Minecraft版のファイルを選びます。Puzzles Libの要求版や範囲を利用側MODが指定している場合は、その条件も満たす構成にします。
作者リポジトリの対応表では、1.21.1をMaintained、26.3をPrimaryとして区別しています。プレイヤーが導入するファイルは、配布一覧でゲーム版・ローダー・依存欄を照合します。
Minecraft公式の26.3公開情報に合わせて本体を変更する場合も、要求元MODを含む対応がそろってから進めます。
対象プロファイルのmodsへ導入する
ゲーム・サーバーを停止し、MOD・設定・ワールドをコピーします。Fabricでの導入例は、次の順に進めます。
- Puzzles Libを要求するMODと、そのゲーム版・ローダー・要求版を確認します。
- 対象版のFabric構成を選び、パックがあれば指定された構成へ合わせます。
- 正規配布元から、対応するPuzzles Libと二つのrequired依存を選びます。
- 対象構成のmodsへ、JARを展開せずに置きます。
- 置き換える旧JARはmodsの外へ保管し、新旧の重複を避けます。
- コピーした環境で起動し、要求元MODの機能を確認します。
Fabric公式のMOD導入資料が示す標準クライアントの場所は以下です。別ランチャーや変更したゲームディレクトリ、専用サーバーでは、その構成の保存先を確認します。
| OS | Fabric標準クライアントのmods |
|---|---|
| Windows | %appdata%\.minecraft\mods |
| macOS | ~/Library/Application Support/minecraft/mods |
| Linux | ~/.minecraft/mods |
NeoForgeを使うパックでは、そのローダー用のPuzzles Libと依存条件を選びます。Fabric用の依存一式をそのまま別ローダーへ転記しません。
マルチは作者と要求元の導入条件を確認する
作者の配布本文は、クライアントとサーバーの双方への導入を案内しています。専用サーバーでは管理者がサーバー側、参加者が配布パックなどのクライアント側を照合します。
必要なゲーム版・ローダー・Puzzles Lib・利用側MODを同じ指定構成にそろえます。パックに含まれているライブラリを、参加者の判断で最新のものへ置き換える前に、管理者の案内を確認します。
接続時だけ問題が出る場合は、クライアントの起動成功だけで判断せず、サーバー側の構成と要求元MODの条件を比べます。
不足・版違い・重複を切り分ける
起動時は、エラーにある依存名と要求範囲を読みます。Puzzles Lib自体の不足と、その依存が不足する状況を分けて確認します。
| 表示・状況 | 確認するもの |
|---|---|
| Puzzles Libが不足している | 実際に起動する構成のmodsとJAR |
| 要求版に合わない | 要求元MODの指定範囲と導入した版 |
| Fabric APIが不足している | APIの有無と対象ゲーム版 |
| Forge Config API Portが不足している | 対象版のファイルとrequired欄 |
| 同じMODが重複している | 新旧JARや二重に追加したファイル |
| 起動するが利用側の機能が使えない | 要求元MODの操作・設定・対象環境 |
変更は一つずつ行い、元の構成のコピーと比べます。問題が続く場合は、作者のIssuesへゲーム版・ローダー・要求元と各ライブラリの版・症状を添えられます。
更新・削除は要求元の構成と合わせる
更新前はゲーム・サーバーを停止し、旧JAR・設定・ワールドを同じ組で保管します。新しいPuzzles Libが要求元MODの条件を満たすか、依存ファイルも対象版に合うかを確認します。
利用をやめる場合は、Puzzles Libを必要とするMODが残るかを確認します。要求元が残る構成で前提だけを取り外すと、起動条件を満たせなくなる場合があります。
取り外すJARはmodsの外へ保管し、コピーした環境で残す機能を確認します。Fabric APIやForge Config API Portを他のMODが使う場合は、その要求を調べて扱います。
まとめ：Puzzles Libは要求元と依存一式を合わせる
Puzzles Libは、要求元MODと同じゲーム版・ローダー・要求範囲で選びます。確認したFabric用ではFabric APIとForge Config API Portもそろえ、導入後は利用側の機能を確認します。
マルチは管理者が指定する両側の構成を照合し、更新・削除では元の環境と共有依存を確認して進めます。
コメント