Loom 1.9

• Update minimum supported Gradle version to 8.11
• Support Kotlin 2.1+ by using the kotlin-metadata library included with Kotlin 2
  • Minimum supported Kotlin version is now 2.0
• Initial support for project isolation and configure on demand
  • Injected interfaces and transitive access wideners from other sub projects currently wont be applied.
  • Mixin AP mappings from other sub projects wont be used when remapping.
  • Expect further work on to be done on this in the future
• Add some Gradle properties to control the decompile cache
• Add option to configure datagen using the client
• Allow datagen tasks to be skipped when up to date (depends on a FAPI change) and run in parallel.
• A handful of smaller bug fixes

Loom 1.8

• Configuration cache support (modmuss50)
  • Remove the advanced multi project optimisation option, it only provided a small benefit to specific projects and is fundamentally incompatible with config cache.
  • Gen sources task no longer rebuilds the input jar, now uses a pre cached input jar
• RISC-V Linux support (modmuss50)
• Update to Gradle 8.10 (modmuss50)
• Add hash suffix to custom intermediaries (Wyvest)
• Fix inner class detection in JarWalker, for older Minecraft versions (SpaceWalkerRS)
• Use Minecraft manifest name in file name instead of url hash (SpaceWalkerRS)
• Fix conflicts caused by MappingsMerger when used with pre-1.3 Minecraft (SpaceWalkerRS)
• Fix a an edge case issue with generic injected interfaces (FirstMegaGame4)
• Setup the test sourceset better when using split sources. (modmuss50)
• Include dev jars from other projects in classpath groups (Juuxel)
• Many other smaller fixes and changes

Configuration cache is an opt-in Gradle feature that will be enabled by default in Gradle 9, this version of Loom contains full support for it. This is something I have been working towards supporting for sometime. For now I would only recommend Gradle veterans try it out, as it imposes a range of restrictions on how your build script is setup. Unfortunately in my limited testing the performance improvements are minimal for Fabric projects, so don't feel like you are missing out if you don't enable it just yet.

Loom 1.7

• Update to Gradle 8.8
• Workaround a Java bug causing the closed zip file system errors
• Add manifest entry allowing deps to define known bsms
• Make Vineflower the default decompiler
• Improve error message when failing to parse FMJ json files
• Improve the code behind include
• Improvements to the decompiler cache
• Fix Mojang mappings with noIntermediateMappings
• More work towards Gradle configuration caching support, full support to come later
• Misc smaller fixes/improvements

Loom 1.6

• Decompiler cache
• Generics support for injected interfaces
• Support merging pre 1.3 Minecraft versions
• Refactor/improve kotlin metadata remapping
• Print info about locked files during configuration or genSources
• Improve locking strategy for concurrent loom executions
• Update to Gradle 8.6
• Async line number remapping
• Prepare for SelfResolvingDependency's removal
• Fallback to maven central for artifacts such as sources or javadocs that are not mirrored on Mojang's repo
• Introduce SemVer version parsing for included mods/libraries
• Download intermediary using Gradle
• Add API to get named minecraft jars
• Add RemapJarTask.getOptimizeFabricModJson (disabled by default)
• Prevent Gradle from running vscode task asynchronously
• Add classname to stracktrace when Kotlin remapping fails
• Fix datagen run config having incorrect name
• Don't fail setup if a project fabric.mod.json file is invalid
• Fix idea sync task group
• Only set startFirstThread on versions using LWJGL 3
• Add interface injection unit test
• Add Offline mode / locking test
• Fix possible race condition in PrepareJarRemapTask when using MPO
• Refactor MinecraftJarConfiguration and MinecraftMetadataProvider

Generated/detailed changelog

• Remapper extension improvements by @modmuss50 in #1024
• Prepare for SelfResolvingDependency's removal & Update to Gradle 8.6 by @modmuss50 in #1038
• Improve locking strategy for concurrent loom executions by @jpenilla in #1031
• Download intermediary using Gradle by @jpenilla in #1042
• Add interface injection unit test by @modmuss50 in #1052
• Add Offline mode / locking test by @modmuss50 in #1046
• Print info about process lock owner by @jpenilla in #1040
• Update deps by @modmuss50 in #1054
• Injected Interfaces Expansion => Generics Support by @FirstMegaGame4 in #1050
• Refactor/better kotlin metadata by @LlamaLad7 in #1061
• Add API to get named minecraft jars. by @modmuss50 in #1063
• Check Minecraft java version by @modmuss50 in #1059
• Use last 16 chars for checksum by @Flemmli97 in #1064
• Cleanup MinecraftJarConfiguration by @modmuss50 in #1070
• Refactor MinecraftMetadataProvider to create it earlier by @modmuss50 in #1072
• Print info about locked files during configuration or genSources by @modmuss50 in #1066
• Fix possible race condition in PrepareJarRemapTask by @modmuss50 in #1065
• Optimise fabric.mod.json files by @modmuss50 in #1068
• Experimental Decompiler cache by @modmuss50 in #1043
• Async line number remapping by @modmuss50 in #1074
• Support merging pre 1.3 Minecraft versions. by @SpaceWalkerRS in #1026
• Only set startFirstThread on versions using LWJGL 3 by @modmuss50 in #1076
• Introduce SemVer version parsing to included mods/libraries by @onebeastchris in #1075

New Contributors

• @FirstMegaGame4 made their first contribution in #1050
• @LlamaLad7 made their first contribution in #1061
• @Flemmli97 made their first contribution in #1064
• @SpaceWalkerRS made their first contribution in #1026
• @onebeastchris made their first contribution in #1075

Full Changelog: 1.5...1.6

Loom 1.5

• Finish of support for using Tiny Remapper to remap Mixin's, when enabled:
  • Mixin annotation processor is no longer used, mods will not contain a refmap json
  • Tiny Remapper is used to remap Mixin classes in place
  • Tiny Remapper now supports Mixin Extra's
  • Jars contain a new Fabric-Loom-Mixin-Remap-Type manifest entry, used when depending on external libraries.
  • Currently opt-in via loom.mixin.useLegacyMixinAp = false (Hopefully will be the default in future versions)
• Rewrite "Download sources" hook to support latest Intelij version
• Skip remapping tasks when the source and target namespace match
• Removed Minecraft libraries from Tiny Remapper classpath, should improve performance and memory usage
• No longer resolve source artifacts in CI builds
• Fix Gradle 9 deprecations, by replacing usage of .getBuildDir() with .getLayout().getBuildDirectory()
• Filter out realms connection error message from debug log
• Fix mapping Minecraft version check for mappings
• Check refmaps exist before adding them to mixin configs
• Change how include disables transitive dependencies to allow platform dependencies to work
• Allow disabling RunConfig appending project path
• Add loom.getMinecraftVersion()
• Read data generation modid from FMJ by default
• Improved support on Raspberry Pi systems. Tested on a Pi 5 using Debian Bookworm
• Process modImplementation first, to mitigate issues where the incorrect loader libraries are used
• Remove jackson
• Misc perf improvements, in certain situations loom 1.5 can be up to 50% faster!

Loom 1.4

• Add https://vineflower.org/ decompiler support.
• Update to Gradle 8.3, and latest version of all dependencies.
• Add support for deprecated modules when using fabricApi.module
• Lazily download decompilers. Also allows changing the decompiler version.
• Two fixes causing outputs to not be reproducible in certain situations.
• Add Fabric-Jar-Type manifest entry, either classes or sources. Can be used by mod distribution platforms to ensure that the correct jar is uploaded.
• Add option to configure known INVOKEDYNAMIC BSMs.
• Suppress the Failed to verify authentication error in the console log.
• Share processed Minecraft jars between sub projects when the processor inputs are the same.

Loom 1.3

• Rework how the generate sources task applies line mappings, making it more consistent.
• Remaped jar/source output jars are now reproducible by default.
• Don't allow running game/genSources tasks in parallel with each other. (Ever tried to run 10 copies of Minecraft at once :D)
• Ensure jar manifest entries are first when reprocessing zip files.
• Inner class interface injection fixes
• Don't publish none main source sets by default
• Support Kotlin 1.9.0 beta
• Fix idea run configs with spaces in the name
• Eclipse is added to the ANSI supported IDEs
• Improvements to Minecraft metadata downloading, will now handle recently released Minecraft versions better.
• Fix IncludedJarFactory using a shared cache dir, and fix including libraries not producing a reproducible output jar.
• Apply AW's when remapping mods, fixes a few mods not working as expected in dev.
• Fix custom intermediate mapping providers using the same cache key.
• Improve genSources error messages.
• Don't use arg files when running in a none ASCII file path.
• Fix constructor mappings in layered mappings.
• Create RunConfigurationSettings with Gradle's object factory.
• Other smaller fixes and improvements.

Loom 1.2

This is mostly a small manintaince release to update the depedencies and fix some bugs.

• Updated to Gradle 8.1.
• Rewritten the Minecraft library handling:
  • Upgrades LWJGL when using Java 19 or later.
  • Supports the official Windows arm64 natives added in the 1.20 snapshots.
  • The code is now much easier to maintain and test.
• Rewritten the Kotlin metadata remapping to support the latest metadata library.
• Set roles on Loom's configurations.
• Fix @Environment(EnvType.CLIENT) not being added to the named minecraft client jar when using split sources.
• RunConfigSettings allow specifying the main class name.
• Set a min heap size for the JVM used by the decompiler.

Loom 1.1

• Generate and attach Minecraft sources when clicking 'Download Sources' in intelij, no 3rd party plugin required.
• New MinecraftJarProcessor API replacing the deprecated JarProcessor API.
• Add new fabric.loom.multiProjectOptimisation property to opt into complex optimistations for certain projects. This simplifies the logic used in simple projects, removing the prepareRemapJarTask. You should only enable this option when all of your sub projects share the same Minecraft and mappings versions.
• Read Fabric-Loom-Remap from a dependencies manifest, this allows it to opt-in/out of remapping, even if it does not have a fabric.mod.json file.
• Jar processor inputs such as interface injection or access wideners are now also read from project dependencies.
• Support MinimalExternalModuleDependency as a FileSpec input. This allows using version catalogs with layered mappings.
• Rework how memory intensive objects are handled, should hopefully reduece memory usage for certain project setups.
• Fix a number of bugs with the mod configuration remapping, it should now have the same behaviour as the default Gradle configurations.
• Large internal changes to prepare for supporting upcoming fabric loader and Gradle features.
• Many smaller bug fixes and changes.

Full changelog / diff:
dev/1.0...dev/1.1

Loom 1.0

• Split incoming mod dependencies when using split common/client sourcesets.
• Improvements to error handling/reporting and bad state recovery, reducing the need for clearing caches or --refresh-dependencies.
• Add API to configure mod remapping configurations (clientModImplementation is added when using split sourcesets)
• Improve VSCode launch configurations for multi project builds.
• Use Java argfiles to support long command lines (Lots of dependencies). (Also worksaround a crash with newer AMD drivers)
• Include client only entries manifest entry in sources jar.
• Add stable APIs for use by the "MinecraftDev" intelij plugin.
• Add DSL for the Mixin annotation processor message levels.
• Support setting environment variables in run configurations.
• Use TinyRemapper's Ref counting FileSystemHandler.
• Rewrite download handling to be more resilient and maintainable.
• Add (opt-in) ValidateMixinNames task to validate mixin class names match their target.
• A wide range of smaller bug fixes and performance improvements.

This update is focused around finalising the split sourceset feature and improving the reliability of loom overall. Loom will now attempt to recover from a previously failed or canceled build. The move to version 1.0 will allow us to better denote any breaking API changes to future loom versions.

Split common/client code

Loom 1.0 provides a full suite of tools to build a mod with split common/client code. The previous loom version introduced compile time safety when compiling against Minecraft code. Loom 1.0 expands this to incoming mod dependencies such as Fabric API. Any mod dependency that was also built with this will be split and applied to the correct sourceset, this ensures that you cannot depend on a client only API from your common code.

Please see the updated Loom wiki page with details on how to enable this for your project. https://fabricmc.net/wiki/documentation:fabric_loom

To update please set your loom version to 1.0-SNAPSHOT at the top of your build.gradle file.