Fabric for Minecraft 1.21.4 is Here — Time to Update Your Mods
The Garden Awakens drops December 3rd with significant changes for mod developers. Here's what you need to know about Fabric's new features, deprecations, and Minecraft's item model overhaul.
Fabric 1.21.4 Arrives with Major Changes
Minecraft 1.21.4 (The Garden Awakens) launches December 3rd, and it's bringing some pretty substantial updates to the modding ecosystem. If you're running Fabric mods on your server or playing with them, patience is going to be your best friend — give mod developers time to catch up to these changes. Oh, and back up your worlds just in case anything goes sideways during the transition.
What's New for Mod Makers
Developers will need to update to Loom 1.9 and Fabric Loader 0.16.9 (or newer stable versions) to work with 1.21.4. This release ditches some old APIs that have overstayed their welcome: fabric-rendering-v0 is completely removed, along with FabricModelPredicateProviderRegistry and some rendering-related classes. If you're using data attachments, you'll want to swap AttachmentRegistry#builder for the cleaner create methods.
One of the cooler new additions is Data Attachment Syncing. Now you can easily sync custom player data (like a thirst mechanic) between server and client with just a few lines of code. The API also got smarter about who receives that data — you can sync to all players, just the target player, or use custom predicates for fine-grained control.
Pick Block functionality moved to the server side in this update. If your mod hooked into the old client-side pick block events, you'll need to migrate to the new PlayerPickItemEvents. The good news? The new system is actually cleaner to work with.
Item Models Got a Serious Makeover
This is the big one: Minecraft now uses item model definition files (similar to blockstates) to determine which models items use. These live in assets/<namespace>/items/ and can be simple or complex, with conditional logic and tint support built in. For example, you can define different models for a fishing rod based on whether it's cast or not, all in JSON.
The old ItemColors API is gone — colors are now baked directly into these item definition files. This might seem like extra work upfront, but it's actually more flexible and cleaner for data generation.
What This Means for Server Owners
If you're hosting a Fabric server, don't rush to update immediately. Give the mod community a week or two to push out compatible versions. Keep your instance backed up before updating, and consider testing in a separate world first. Many popular mods will likely receive updates within days, but niche mods might take longer.
The good news? These changes mostly affect how mods are built, not how they behave. You shouldn't see major stability issues once mods are updated — Fabric's team did solid work here.
Misc Changes Worth Knowing
Equipment asset files moved directories, some block and item tags got removed, and Yarn mappings got a cleanup pass (stuff like xp → experience for clearer naming). Nothing game-breaking, but it's the kind of behind-the-scenes stuff that keeps the codebase healthy.
TL;DR: Update Loom and Loader, refactor old rendering APIs if you use them, embrace the new data attachment and item model systems. The modding tools got a real upgrade here.
Source: Fabric for Minecraft 1.21.4