tutorial:migratemappings
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
tutorial:migratemappings [2019/05/10 11:49] – created asie | tutorial:migratemappings [2022/12/22 16:20] – change versions url to /develop to keep it consistent basil4088 | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Updating Yarn mappings in a Java codebase ====== | ====== Updating Yarn mappings in a Java codebase ====== | ||
- | ===== The Hacky Way ===== | + | Loom allows semi-automatic updating of the mappings used in a Java codebase. Due to frequent changes in Yarn, this can be a useful tool for keeping a codebase up-to-date with the newest changes. |
- | ==== Requirements ==== | + | **Note:** This automated process currently does not handle Mixins or reflection, instances of these will need to be manually updated. |
- | * Fabric-Loom 0.2.2 or above | + | ===== Loom 0.2.6 and above ===== |
- | * A Java codebase - Kotlin and Scala will not, currently, do. | + | |
- | * Some assembly required | + | |
- | ==== Instructions | + | Say you want to migrate from 1.16.5 yarn to 1.17.1 yarn. |
+ | |||
+ | - Go [[https:// | ||
+ | - Run the command in the root of your Gradle project. | ||
+ | - Your migrated sources will appear in '' | ||
+ | - Copy the sources from '' | ||
+ | - Update your gradle.properties file according to the instructions in [[https:// | ||
+ | - Refresh the Gradle project in your IDE. | ||
+ | - Check and update any Mixin targets that may be outdated. | ||
+ | |||
+ | If you want to go from Mojang' | ||
+ | |||
+ | === Additional customization | ||
+ | * Specify from where to take your Java files with '' | ||
+ | * Specify where to output the remapped source with '' | ||
+ | * Specify a custom place to retrieve the mappings from with '' | ||
+ | |||
+ | === Reporting issues === | ||
+ | Loom uses [[https:// | ||
+ | |||
+ | ===== Loom 0.2.2-0.2.5 ===== | ||
+ | |||
+ | Some assembly required. | ||
- Figure out your target mappings version. For example, " | - Figure out your target mappings version. For example, " | ||
Line 16: | Line 36: | ||
* " | * " | ||
* " | * " | ||
- | * " | + | * " |
- | - Copy the remapped source code to the input directory, if everything' | + | - Copy the remapped source code to the input directory, if everything' |
- Hope for the best. | - Hope for the best. | ||
- | This should work across Minecraft versions as well, provided we haven' | + | //Note: You may need to specify |
- | ===== The Non-Hacky Way ===== | + | This should work across Minecraft versions as well, provided we haven' |
- | Coming soon! (Hopefully.) |
tutorial/migratemappings.txt · Last modified: 2022/12/22 16:23 by basil4088