Differences

This shows you the differences between two versions of the page.

--- tutorial:migratemappings [2021/07/01 12:58] – [Loom 0.2.6 and above] update fabric versions link upcraftlp
+++ tutorial:migratemappings [2021/08/22 10:16] – Simplified instructions and mojmap details florens
@@ Line 7: / Line 7: @@
 ===== Loom 0.2.6 and above =====
-Say you want to migrate from 1.14.4 to 19w46b.
+Say you want to migrate from 1.16.5 to 1.17.1.
-  - Go [[https://fabricmc.net/versions.html|here]], select the version to migrate to, and copy the ''yarn_mappings'' value, for example ''19w46b+build.1''.  DO NOT modify your gradle.properties or build.gradle yet.
+  - Go [[https://fabricmc.net/versions.html|here]], select the version to migrate to, and copy the Gradle command under "Mappings Migration", for example ''gradlew migrateMappings %%--%%mappings %%"%%1.17.1+build.40%%"%%''.  DO NOT modify your gradle.properties or build.gradle yet.
-  - In the root of your gradle project, run ''gradlew migrateMappings %%--%%mappings %%"%%19w46b+build.1%%"%%''
+  - Run the command in the root of your Gradle project.
   - Your migrated sources will appear in ''remappedSrc''. Verify that the migration produced valid migrated code.
   - Copy the sources from ''remappedSrc'' to the original folder. Keep the original sources backed up just in case.
@@ Line 19: / Line 19: @@
 === Additional customization ===
   * Specify from where to take your Java files with ''%%--%%input path/to/source''. Default: ''src/main/java''.
-  * Specify where to output the remapped source with ''%%--%%output path/to/output''. Default: 'remappedSrc'.
+  * Specify where to output the remapped source with ''%%--%%output path/to/output''. Default: 'remappedSrc'. You can use ''src/main/java'' here to avoid having to copy the remapped classes, but make sure you have a backup.
-  * Specify a custom place to retrieve the mappings from with ''%%--%%mappings some_group:some_artifact:some_version:some_qualifier''. Default: ''net.fabricmc:yarn:<version-you-inputted>:v2''.
+  * Specify a custom place to retrieve the mappings from with ''%%--%%mappings some_group:some_artifact:some_version:some_qualifier''. Default: ''net.fabricmc:yarn:<version-you-inputted>:v2''. Use ''net.mojang.minecraft:mappings:<minecraft-version>'' to migrate to official Mojang mappings.
 === Reporting issues ===