- Conventions and Terminology
- Development Tools
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.
Note: This automated process currently does not handle Mixins or reflection, instances of these will need to be manually updated.
Say you want to migrate from 1.14.4 to 19w46b.
yarn_mappingsvalue, for example
19w46b+build.1. DO NOT modify your gradle.properties or build.gradle yet.
gradlew migrateMappings --mappings "19w46b+build.1"
remappedSrc. Verify that the migration produced valid migrated code.
remappedSrcto the original folder. Keep the original sources backed up just in case.
--input path/to/source. Default:
--output path/to/output. Default: 'remappedSrc'.
--mappings some_group:some_artifact:some_version:some_qualifier. Default:
Some assembly required.
gradle migrateMappings -PtargetMappingsArtifact="net.fabricmc:yarn:1.14.1 Pre-Release 2+build.2" -PinputDir=src/main/java -PoutputDir=remappedSrc, where:
Note: You may need to specify the full paths in quotes, try this if you get file not found issues.
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).