Learn · concepts

ヤーン vs. モジュマップ：Minecraft マッピング比較 (2026)

YarnとMojmapの違い：名前、ライセンス、ツールに関して、2つのMinecraftマッピングセットがどのように異なるか、そしてFabric modに適した方を選ぶには.

TRtrolPublished 1 min read

YarnとMojmap：違いは何？

Yarnは、Fabric向けのコミュニティ主導のオープンソースマッピングであり、記述的な名前と完全なメソッドパラメータを提供します。Mojmapは、Mojangが公式に公開している命名規則で、1.14.4からすべてのリリースに同梱されています。パラメータ名とJavadocを備えた、無料で十分にドキュメント化された命名規則が必要な場合はYarnを選びましょう。Mojang自身の命名規則に準拠し、変化しない名前を求める場合はMojmapを選びましょう。

どちらが正しいかという選択ではありません。どちらも正しいのです。重要なのは、プロジェクトがどの命名規則に従い、どのエコシステムを構築するかということです。

それぞれが何であるか

YarnはFabricMCによって維持されているマッピングセットです。ボランティアがMinecraftの難読化されたクラス、フィールド、メソッドに読みやすい名前を割り当て、それらの名前は安定したIntermediaryレイヤーの上に配置されるため、コンパイルされたMODを壊すことなく名前を変更できます。

Mojmapは、Mojangが1.14.4以降のすべてのリリースとともに公開している公式のマッピングテーブルです。名前はMojang自身のソースコードから直接取得されているため、開発者が内部で呼んでいるものと一致します。MCPとSeargeに代わり、最新バージョンを対象とする新しいプロジェクトのデフォルトとして採用されました.

  1. 不明瞭な名称

    Minecraft 船舶が不明瞭：クラス名はa.a.a、メソッド名はb、c、d.

  2. 毛糸やモジュマップの地図を

    各マッピングセットは、a.a.aをEntityPlayerに、bを移動に、cを攻撃に変換します.

  3. あなたのMODはどちらか一方を使用します

    Yarn や Mojmap の名前に対してコードを書くんだ。難読化された名前に対してじゃない.

  4. 安定した下の層

    糸用の中間マッピング、またはMojmap用の難読化マップは、コンパイルされたMODをリネームしても互換性を保つ.

違い

この違いは、誰が名前を選び、ライセンスがそれらをどのように扱うかに帰着します。Yarnの名前はコミュニティによって選択され、自由に利用および共有できます。Mojmapの名前はMojangのものであり、ライセンスは歴史的にコンパイル時利用に対して寛容でしたが、再配布についてはより慎重でした。最新のローダーはそれを自動的に処理します。

YarnMojmap
名前を付けるのはFabricMCコミュニティMojang (公式)
最初に利用可能Fabric時代1.14.4以降
メソッドパラメータ名前付きでドキュメント化されている頻繁に欠落している
ライセンスオープン、共有可能コンパイル時に許可的
下にある安定レイヤー中間層リリースごとの難読化マップ
最適な用途ドキュメントを必要とするFabric製ModMojangのソースコードに一致するプロジェクト

Yarnは、逆コンパイルされたコードを読むことなく、メソッドが何をするのかを理解したい場合に役立ちます。メソッドパラメータには名前（エンティティ、速度、ダメージなど）が付けられており、Javadocも含まれていることがよくあります。Mojmapは、Mojang自身のソースコードとのクロスリファレンスや、公式の名前になじみのある開発者と作業する場合に役立ちます。

どちらを選ぶか

Fabricをベースにしており、説明的な名前、名前付きのメソッドパラメータ、インラインドキュメントが必要な場合はYarnを選択してください。Fabricエコシステムの長年のデフォルトであり、ほとんどのサードパーティ製Modがそれをターゲットにしています.

もしMojang自身のソースコードと一致する名前が欲しい場合、他のローダーを使用する人々とコードを共有する予定がある場合、または公式のマッピングが一般的な基準となる1.21以降をターゲットにしている場合は、Mojmapを選択してください。Mojang自身の逆コンパイルされたソースコードから学習したり、複数のローダータイプで作業したりする場合は、Mojmapがあなたの状態を維持します。

多くのFabricプロジェクトは現在、MojmapをベースにしてYarnのリマッピングを重ねて構築しているため、必ずしもどちらか一方を選択する必要はありません。あなたのビルドツールはそれらを重ねることができます。

他のマッピングとの接続方法

両者はより長い歴史の中に存在します。Mojangがマッピングを公開する以前は、モディングシーンはMCPとSeargeを使用して難読化された名前を逆転させていました。1.14.4から、Mojmapは公式の命名規則を提供し、YarnはIntermediaryの上に重ねられたオープンソースのFabricの代替として成長しました。Intermediaryのレイヤーが、マッピングのリネームを介してmodの互換性を維持します.

YarnとMojmapの利用

新しいFabric modを始める場合、Mojmapを使う理由がないのであれば、Yarnが安全なデフォルトです。エコシステムはYarnを前提としており、ドキュメントもYarnを対象としています。また、コミュニティが維持する名前には、役立つ説明がよく含まれています。

もし、他のローダーが依存するライブラリを維持している場合、あるいはForgeのmodderとコードを共有する場合（彼らはMojmapを好むことが多い）、Mojmapを使うのは理にかなっています。公式の名前は共通認識となりやすいです。

迷っている場合は、Yarnを使用してください。後で切り替えることも可能ですし、移行のためのツールも存在します。マッピング自体は細部であり、重要なのは良いmodを書くことです。

よくある質問

Terminus は Fabric を基盤とし、これらのマッピングも同様です。