依存関係とバージョン範囲の読み方

Fabric / Quiltの宣言

fabric.mod.json の depends は必須条件で、満たさないとLoaderが起動を止めます。breaks は「この条件に合う相手がいたら起動を止める」という宣言、conflicts は警告レベル、recommends は推奨です。Quiltの quilt.mod.json も考え方は近く、quilt_loader.depends に同じような宣言を持ちます。

Forge / NeoForgeの宣言

mods.toml 系では [[dependencies.モッドID]] に modId、versionRange、必須かどうかを書きます。旧Forgeは mandatory の真偽、NeoForgeは type(required / optional / incompatible / discouraged)で表します。ordering は読み込み順序の制約です。

バージョン範囲の記法

Fabric系は >=1.5.0、~1.21.1(同じマイナーまで)、^2.0.0(同じメジャーまで)、1.21.x のような書き方を使います。Forge系はMaven記法で、[1.20,1.21) は「1.20以上、1.21未満」、[1.20] は完全一致、[1.20,) は「1.20以上」を意味します。角括弧はその値を含む、丸括弧は含まない、と覚えると読みやすくなります。

循環は即エラーではない

必須依存が循環していても、Loaderの解決方法によっては動く場合があります。本ツールでも循環は「競合の可能性」として扱い、確定とは表示しません。

チェッカーで実際に診断する