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 revision Previous revision
Next revision
Previous revision
tutorial:migratemappings [2019/07/01 20:06]
modmuss50
tutorial:migratemappings [2020/01/13 20:38] (current)
jamie rewrite mercury section
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 === 
 +Loom uses [[https://​github.com/​CadixDev/​Mercury|Mercury]] to remap mods' source code, for problems with remapping please report issues to their [[https://​github.com/​CadixDev/​Mercury/​issues|issue tracker]], or discuss it through their communications channel (irc.esper.net #cadix). 
 + 
 +====== Loom 0.2.5 and below ======
  
 ==== Requirements ==== ==== Requirements ====
Line 24: Line 42:
 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). 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).
  
-===== The Non-Hacky Way ===== 
- 
-Coming soon! (Hopefully.) 
tutorial/migratemappings.1562011603.txt.gz · Last modified: 2019/07/01 20:06 by modmuss50