User Tools

Site Tools


tutorial:migratemappings

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
tutorial:migratemappings [2019/06/03 22:33] modmuss50tutorial:migratemappings [2019/11/27 23:54] fudge
Line 1: Line 1:
 ====== Updating Yarn mappings in a Java codebase ====== ====== 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 ==== ==== 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!     * "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,     * "inputDir" is the input directory, containing Java source code,
-    * "outputDir" is the output directory. It will be created if it is missing. //Note: You may need to specify the full paths in quotes, try this if you have issues.//+    * "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,   - Copy the remapped source code to the input directory, if everything's fine,
   - Hope for the best.   - Hope for the best.
  
-This should work across Minecraft versions as well, provided we haven't massively broken Intermediaries or done something equally silly (akamost of the time).+//NoteYou 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.) 
tutorial/migratemappings.txt · Last modified: 2022/12/22 16:23 by basil4088