Porting to 1.21.11 1.21.11

A guide for porting to Minecraft 1.21.11, the latest version of Minecraft.

WARNING

This page is written for version 1.21.11. Documentation for older versions may be incomplete.

Minecraft is a game that's constantly evolving, with new versions changing the game in ways that affect modders. This article covers the general steps one might follow to update their mod to the newest stable version of Minecraft.

INFO

These docs discuss migrating from 1.21.10 to 1.21.11. If you're looking for another migration, switch to the target version by using the dropdown in the top-right corner.

Updating the Build Script

Start by updating your mod's gradle/wrapper/gradle-wrapper.properties, gradle.properties, and build.gradle to the latest versions:

1. Update Gradle to the latest version by running the following command: ./gradlew wrapper --gradle-version latest
2. Bump Minecraft, Fabric Loader, Fabric Loom and Fabric API, either in gradle.properties (recommended) or in build.gradle. Find the recommended versions of the Fabric components on the Fabric Develop site.
3. Refresh Gradle by using the refresh button in the top-right corner of IntelliJ IDEA. If this button is not visible, you can force caches to be cleared by running ./gradlew --refresh-dependencies.

Updating the Code

After the build script has been updated to 1.21.11, you can now go through your mod and update any code that has changed to make it compatible with the new version.

To help you with updating, modders will document the changes they came across in articles, like the Fabric Blog, and NeoForge's porting primers.

• Fabric for Minecraft 1.21.11 on the Fabric blog contains a high-level explanation of the changes made to Fabric API in 1.21.11.
• Minecraft: Java Edition 1.21.11 on the Minecraft blog is the official overview of the features introduced in 1.21.11.
• Java Edition 1.21.11 on the Minecraft Wiki is an unofficial summary of the contents of the update.
• slicedlime's Data & Resource Pack News in Minecraft 1.21.11 covers information relevant to updating your mod's data and resource pack driven content.
• NeoForge's Minecraft 1.21.10 -> 1.21.11 Mod Migration Primer covers migrating from 1.21.10 to 1.21.11, focusing only on vanilla code changes.