MaLiLibは、LitematicaなどのクライアントMODが使う設定画面や複数キー操作を支えるライブラリです。不足エラーが出た場合は、Minecraft版とローダーに加え、要求元MODが指定するMaLiLibの版を合わせます。
この記事ではMinecraft Java版のFabric用1.21.1・26.3を例に、導入と版違いの確認方法を解説します。配布情報と作者資料は2026年10月15日に確認しました。実機導入やゲーム内の操作検証は行っていません。
MaLiLibは設定画面と複数キー操作を支えるライブラリ
MaLiLibの作者配布ページは、複数のクライアントMODに共通する設定処理、画面、複数キーの組み合わせなどをまとめたライブラリと説明しています。要求元MODが動くための部品です。
MaLiLib単独でLitematicaの設計図表示やTweakerooの機能が追加されるわけではありません。使いたい機能を持つMODを確認し、それが要求するライブラリとして導入します。
配布情報ではクライアント側がrequired、サーバー側がunsupportedです。ここでは自分がMinecraftを起動する環境へ入れる手順を扱います。マルチで要求元MODを使う場合は、サーバーの参加条件と利用ルールも確認してください。
Fabric用の対応版と要求元の条件を確認する
確認したFabric用releaseの例は次のとおりです。ファイル名や配布タグでゲーム版・ローダーを照合します。
追加の必須依存欄に指定がないことと、Fabricなどの起動環境が不要なことは別です。Forgeなどを使う構成では、そのゲーム版・ローダーに合う配布ファイルを確認してください。
作者はMaLiLibの変更によって要求元との版の組み合わせが重要になると説明しています。Minecraft版が一致するだけで済ませず、要求元の配布説明、変更履歴、起動エラーにある必要版も照合します。
たとえばLitematica 0.19.61の作者の依存宣言はMaLiLib 0.21.10以降を要求します。Litematica 0.29.1の公開ソースでは、0.30.2系以降・0.31.0系より前という範囲です。この条件を、ほかの要求元MODへ一律に当てはめないでください。
Minecraft公式の1.21.1情報と26.3情報は本体の版確認に使い、MOD同士の互換性は各配布元で確認します。
使うクライアントのmodsへ導入する
最初にゲームを終了し、使っているワールド、mods、configをコピーして保管します。Fabric公式のMOD導入案内に従い、対象プロフィールのゲームディレクトリを確認します。
- MaLiLibを必要としているMODと、その版を特定します。
- 正規配布元でMinecraft版・Fabric・必要版の条件を満たすMaLiLibを選びます。
- 遊ぶ環境のmodsへJARを配置します。同じMaLiLibの旧版があれば、元をmodsの外へ保管して重複を避けます。
- Fabricのプロフィールで起動し、要求元が読み込まれるかを確認します。
標準Windows環境ではmodsは%appdata%\.minecraft\modsです。保存先を変更したプロフィールや別ランチャーでは、その構成のmodsへ入れます。別のゲーム環境へ入れても、今回起動した環境の不足は解消しません。
| 作者が挙げる要求元の例 | MaLiLibとの関係 |
|---|---|
| Litematica | 設定画面・キー操作などでライブラリを使う |
| MiniHUD | 作者は0.17.0以降で必要と案内 |
| Tweakeroo | 作者は0.8.0以降で必要と案内 |
| Item Scroller | 作者は0.14.0以降で必要と案内 |
これは要求元の例です。MaLiLibを入れた後も、それぞれのMOD自身の対応版と必須依存を確認してください。
MaLiLib不足・版違いを切り分ける
| 表示・症状 | 確認するもの |
|---|---|
| MaLiLibが必要と表示される | 対象modsにあるか、必要とするMODの指定版を満たすか |
| 入れたのに版のエラーが続く | ゲーム版、ローダー、要求される版の範囲、旧版JARの重複 |
| 要求元を更新した後に止まる | 更新後の要求元が求めるMaLiLibへ条件が変わっていないか |
| 別のMOD名も不足に出る | その要求元自身の依存欄にある追加条件 |
| 起動するが期待する機能がない | MaLiLibだけでなく、機能を持つ本体MODが読み込まれているか |
エラーにある必要版と、実際のJARのゲーム版・ローダーを並べて確認します。古いMODパックの一部だけを新しくする場合も、ほかの要求元との条件を残せるかを照合してください。
作者リポジトリには開発や古いゲーム版の説明もあります。古いREADMEのJava番号などを、後のすべてのゲーム版に共通する起動条件として使わず、実際に遊ぶゲーム版とローダーの案内に従います。
バニラの操作設定にキーが出ない理由を確認する
MaLiLibは、複数のキーを組み合わせられる独自のキー設定を提供します。そのため、要求元によってはバニラの「操作設定」に専用キーが並ばず、MOD側の設定画面で変更します。
Litematica作者Wikiの例では、初期設定のM＋C→HotkeysからLitematicaのキーを設定します。別の入口としてMod Menuの各MOD設定ボタンも案内されています。これはLitematicaの操作例であり、すべてのMaLiLib利用MODをM＋Cで開けるという意味ではありません。
キーが反応しない場合は、使っている要求元の説明、現在の割り当て、キーボード配列を確認します。ライブラリを入れ直す前に、そのMODの設定画面へ入れるかを分けて調べると、起動の問題と入力の問題を整理できます。
更新・削除はMaLiLibを使うMODも確認する
更新前は終了した状態でワールド・mods・configを保管し、要求元の対応条件を確認します。MaLiLibだけを新しい世代へ入れ替えず、既存の要求元がその版を使えるかを照合してください。
変更後はコピーしたワールドで要求元の画面とキー操作を確認します。一度に複数のMODや設定を変えないと、どの変更で動作が変わったかを追いやすくなります。
MaLiLibを外す場合は、残すMODがまだ必要としていないかを確認します。LitematicaをやめてもMiniHUDやTweakerooなどが必要としていれば、ライブラリは残します。元の構成を一式保管し、取り外したコピーで起動と設定を確認してから普段の環境へ移します。
まとめ：MaLiLibは要求元と同じ構成で選ぶ
MaLiLibは、設定画面や複数キー操作を支えるクライアント用ライブラリです。ゲーム版・ローダーに合うファイルを選び、要求元が指定する版の条件を満たすことが導入の基本です。
不足エラーはmodsの保存先、版、重複を確認し、キーの問題は要求元の独自設定画面も調べましょう。更新・削除も、MaLiLibを使うMODと元の設定を含めて確認してください。
コメント