Differences

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

--- tutorial:migratemappings [2019/05/10 11:49] – created asie
+++ tutorial:migratemappings [2019/11/27 23:54] – fudge
@@ Line 1: / Line 1: @@
 ====== Updating Yarn mappings in a Java codebase ======
+====== Loom 0.2.6 and above ======
+Currently, this process will only affect Java files.
-===== The Hacky Way =====
+Say you want to migrate from 1.14.4 to 19w46b.
+  - Go [[https://modmuss50.me/fabric.html?&version=19w46b|here]], select ''19w46b'', and copy the ''yarn_mappings'' value, for example ''19w46b+build.1''.  DO NOT modify your gradle.properties or build.gradle yet.
+  - In the root of your gradle project, run ''gradlew migrateMappings %%--%%mappings %%"%%19w46b+build.1%%"%%''
+  - Your migrated source will appear in ''remappedSrc''. Verify your code was not nuked and copy it over.
+  - Update your gradle.properties file according to the instructions in [[https://modmuss50.me/fabric.html?&version=19w46b|this]] site.
+  - You're done.
+=== 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 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''.
+=== Reporting issues ===
+If something went wrong with the remapping process, report it [[https://github.com/CadixDev/Mercury/issues|on the source remapper Github]] or on the developers' IRC channel,   irc.esper.net #cadix.
+====== Loom 0.2.5 and below ======
 ==== Requirements ====
@@ Line 16: / Line 34: @@
     * "targetMappingsArtifact" refers to the target mappings version. It is imperative that the build.gradle be set to the current mappings version of the mod when running this command!
     * "inputDir" is the input directory, containing Java source code,
     * "outputDir" is the output directory. It will be created if it is missing.
   - Copy the remapped source code to the input directory, if everything's fine,
   - Hope for the best.
-This should work across Minecraft versions as well, provided we haven't massively broken Intermediaries or done something equally silly (aka: most of the time).
+//Note: You may need to specify the full paths in quotes, try this if you get file not found issues.//
-===== The Non-Hacky Way =====
+This should work across Minecraft versions as well, provided we haven't massively broken Intermediaries or done something equally silly (aka: most of the time).
-Coming soon! (Hopefully.)