Mixin競合とは何か

Mixinの仕組み

Mixinは、Modがゲームの既存クラスへ処理を差し込む仕組みです。各ModのJARには設定JSONがあり、適用するMixinクラスの一覧、パッケージ、優先度(priority)などが書かれています。実際にどのメソッドへ差し込むかはMixinクラスのアノテーションで決まるため、設定JSONだけでは完全には分かりません。

同じクラス = 競合、ではない

2つのModが同じクラスを変更していても、差し込むメソッドや位置が違えば共存できます。逆に、同じメソッドの同じ位置へ書き換えが重なると、片方が効かなくなったり起動時に失敗したりします。本ツールはMixinクラスのバイトコードに残る型参照から対象クラスを推定し、重なりを「競合の可能性」として表示します。確定判定はしません。

優先度の見方

priorityが大きいMixinほど後に適用されます。対象が重なり、かつ優先度が異なる場合は適用順序の影響を受けやすいため、本ツールでは重要度を一段上げて表示します。

切り分け手順

  1. 重なっているModを片方ずつ無効化して起動確認する。
  2. クラッシュレポートで対象クラス名とMixin名を検索する。
  3. 各ModのIssueで対象クラス名が既知の問題として報告されていないか確認する。

起動しないときの切り分け手順も合わせてどうぞ。