JamLib — 他のMinecraft MODを動かすための技術ライブラリ

JamLib — 他のMinecraft MODを動かすための技術ライブラリ

JamLibはMinecraft用のライブラリMODであり、それ自体はアイテムもブロックもモブも構造物もゲームに追加しません。これは他のMOD作者に次のものを提供するユーティリティラッパーです。ローダー間のプラットフォーム抽象化、既製の設定ファイルシステム、そして再パッケージされたjarファイルの検出機能です。このライブラリがなければ、それを必要とするMODは単純に起動しません。

このMODの機能

このライブラリは、開発者にとっての3つの課題を同時に解決します。

• Architectuaryに基づくプラットフォーム抽象化 — 同じコードがFabric、Forge、NeoForge、Quiltで、個別の分岐なしに動作します。

• ゲーム内で自動生成される設定画面を備えた、JSON5形式の設定API。

• 海賊版«ミラー»からの再パッケージの兆候について、MODのjarファイルをチェックする機能。

プレイヤーの視点から見ると、このライブラリはゲームプレイに何も追加しません。唯一気づく可能性があるのは、設定にJamLibを使用しているMODのMODメニューに新しい項目が現れることです。そのようなMODがパックに含まれている場合、対応するウィンドウにはスライダー、トグル、入力欄を備えた自動生成のページが表示されます。

JSON5設定

標準のJSONはコード内にコメントを許可しません。ライブラリがJanksonという依存関係を通じて扱うJSON5はそれを許可します。実際には、JamLibをベースに構築されたMODの設定ファイルは.json5のように見え、各パラメータをそのデフォルト値とともに直上に説明するコメントをすでに含んでいるということです。

ファイルは上書き時にユーザーの編集内容を保持します。//で始まる独自のメモを追加した場合、設定が次回保存された後もそのまま残ります。標準のJSONライブラリにはこれができません。

設定画面は別途生成されます。FabricとQuiltでは標準のMODメニューを通じてインターフェースが表示され、ForgeとNeoForgeではローダー組み込みの設定画面APIを通じて表示されます。MOD作者は手作業でGUIを書く必要はありません。JamLibは設定クラスからフィールドを取得し、それらに対して検証付きのウィジェットを構築します — 数値の範囲、文字列用の正規表現、ゲームの再起動が必要な旨の警告などです。

再パッケージMOD検出機能

別の機能として、インストールされたMODの.jarファイルが公式ソースからダウンロードされたものかどうかをチェックします。一部のサイトはMODを自分たちの名前で再パッケージし、時にはサードパーティ製ソフトウェアを同梱することもあります。JamLibは実際のファイル名を、マニフェスト内のJamLib-File-Nameフィールドと比較します。一致しない場合、ワールド読み込み後にチャットに警告が表示されます。このメッセージは疑わしいファイルごとに一度だけ表示され、その後はその.jarの名前が記憶されます。

このチェックは、作者が意図的にJamLib-File-Nameをマニフェストに追加したMOD(つまり同じ開発者によるMOD、またはこの機能を手動で組み込んだMOD)にのみ適用されます。ライブラリはmodsフォルダ内のすべての.jarファイルをウイルスや悪意のあるコードについてスキャンするわけではありません — これはアンチウイルスソフトではありません。

まとめ

JamLibは、MOD開発者を4つのローダー向けに同時に設定システムとプラットフォーム抽象化を手作業で書く手間から解放します。JamLibをインストールする意味が生まれるのは、それを必要とする依存MODと組み合わせた場合だけです。パック内にJamCoreModding製、またはこのライブラリをベースにしたサードパーティ作者のMODが1つもない場合、JamLibの.jarは単にmodsフォルダ内でアクティブな役割を持たないまま置かれることになります。