Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Java コードベースで Yarn マッピングの更新 ======

Loom を使用すると、 Java コードベースで使用されるマッピングを半自動で更新できます。 Yarn は頻繁に変更されるため、これはコードベースを最新の変更で最新の状態に保つための便利なツールです。

**注意：** この自動化されたプロセスは現在、Mixin またはリフレクションを処理しません。これらのインスタンスは手動で更新する必要があります。

===== Loom 0.2.6 以降 =====

1.16.5 から 1.17.1 に移行したいとします。

  - [[https://fabricmc.net/versions.html|こちら]] から、移行先のバージョンを選択し、 "Mappings Migration" の下に Gradle コマンド（例：''gradlew migrateMappings %%--%%mappings %%"%%1.17.1+build.40%%"%%''）をコピーします。まだ ''gradle.properties'' または ''build.gradle'' を変更しないでください。
  - Gradle プロジェクトのルートでコマンドを実行します。
  - 移行されたソースは ''remappedSrc'' に表示されます。移行によって有効な移行コードが生成されたことを確認します。
  - ソースを ''remappedSrc'' から元のフォルダーにコピーします。 万が一に備えて、元のソースをバックアップしておいてください。
  - [[https://fabricmc.net/versions.html|最初のサイト]] の指示に従って、gradle.properties ファイルを更新します。
  - IDE で Gradle プロジェクトを更新します。
  - 古い可能性がある Mixin ターゲットを確認して更新します。

=== 追加のカスタマイズ === 
  * ''%%--%%input path/to/source'' を使用して、Java ファイルの取得元を指定します。デフォルト：''src/main/java''
  * ''%%--%%output path/to/output'' でリマップされたソースを出力する場所を指定します。デフォルト：''remappedSrc''。ここで ''src/main/java'' を使用して、再マップされたクラスをコピーする必要がないようにすることができますが、バックアップがあることを確認してください。
  * ''%%--%%mappings some_group:some_artifact:some_version:some_qualifier'' を使用して、マッピングを取得するカスタムの場所を指定します。デフォルト：''net.fabricmc:yarn:<version-you-inputted>:v2''。 ''net.minecraft:mappings:<minecraft-version>'' を使用して、公式の Mojang マッピングに移行します。

=== 問題の報告 ===
Loom は [[https://github.com/CadixDev/Mercury|Mercury]] を使用して Java ソースコードをリマップします。 [[https://github.com/CadixDev/Mercury/issues|Issue Tracker〔課題管理〕]]、または彼らの通信チャネル（irc.esper.net #cadix）を通じて議論してください。

===== Loom 0.2.2 から 0.2.5 まで =====

一部組み立てが必要です。

  - ターゲットマッピングのバージョンを把握します。たとえば、 "net.fabricmc:yarn:1.14.1 Pre-Release 2+build.2" です。
  - このバージョンのマッピングが作成されていることを確認してください。これは厄介な部分です。現時点では、build.gradle の"minecraft" フィールドと "mappings" フィールドを新しいバージョンに編集し、任意の Gradle コマンドを実行することが唯一の方法で（"gradle build"は、クラッシュします）、その後に**フィールドを元に戻します**。
  - 次に魔法のような奇術コマンドを実行します： ''%%gradle migrateMappings -PtargetMappingsArtifact="net.fabricmc:yarn:1.14.1 Pre-Release 2+build.2" -PinputDir=src/main/java -PoutputDir=remappedSrc%%''
    * "targetMappingsArtifact" は、ターゲットマッピングのバージョンを指します。このコマンドを実行するときは、build.gradle を Mod の現在のマッピングバージョンに設定する必要があります。
    * "inputDir" は、Java ソースコードを含む入力ディレクトリです。
    * "outputDir" は出力ディレクトリです。不足している場合は作成されます。
  - 問題がなければ、リマップしたソース コードを入力ディレクトリにコピーします。
  - 最善の結果を期待します。

//注意：ファイルが見つからないという問題が発生した場合は、フルパスを引用符で囲んで指定する必要がある場合があります。//

これは、 Intermediary を大幅に壊したり、同様にばかげたことをしたりしていない限り、Minecraft のバージョン間でも機能するはずです（※ほとんどの場合）。