Fabric for Minecraft 1.21.2 & 1.21.3: Major Changes for Mod Developers

Fabric Drops Support for Minecraft 1.21.2 and 1.21.3

Minecraft's "Bundles of Bravery" update is almost here, and Fabric is ready. Like every major Minecraft update, this release brings substantial changes to how mods interact with the game. Please be patient with mod creators as they update their projects—these changes take time to implement correctly. And seriously, back up your worlds before jumping in.

What You Need to Know: Developer Changes

Tooling Updates: Mod developers should use Loom 1.8 for development and Fabric Loader 0.16.7 for gameplay. Java 21 remains the recommended version, though 23 is now supported. The bundled MixinExtras got useful new features like @WrapMethod and @Cancellable annotations, giving modders more flexibility when hooking into game code.

Registry Keys Are Now Required: This is the big one. Blocks, items, and entities now need explicit registry keys set during creation. Skipping this step will cause crashes with "Block id not set" or "Item id not set" errors. Think of it like the game's way of ensuring everything has proper identification from the start. Fabric API also deprecated the old FabricBlockSettings class, so switch to vanilla AbstractBlock.Settings.

The Rendering System Got a Makeover: Entity rendering now uses a three-step process with render states, separating entity data from rendering logic. This is more efficient but requires updating custom entity renderers. The CoreShaderRegistrationCallback was removed, as vanilla now supports modded core shaders directly. If you've customized entity rendering, plan for refactoring.

Recipe System Overhaul: Recipes now use RegistryKey instead of Identifier, and the client-server relationship changed significantly. Clients receive RecipeDisplayEntry objects with network IDs rather than full recipe data. Ingredients are also now lists of items instead of item stacks. This modernizes recipe handling but requires careful updates.

What This Means for Server Owners

If you're running a PaperChunk Fabric server, wait for your favorite mods to update before upgrading. Many popular mods will need adjustments to work with 1.21.2. Check with mod developers for compatibility timelines. The good news? These API improvements should lead to better mod stability and performance once everything settles in.

Other Notable Changes

There's also action result consolidation (three result types merged into one), furnace fuel registration changes, and various entity behavior updates like required spawn reasons. Loot tables and profiler access got cleaner APIs, and the biome system removed old water cave carvers.

For a complete breakdown with code examples, check out FabricMC's official post. The community is already sharing migration guides, so you're not alone in this update cycle.