Porting to 26.1 Snapshots

The upcoming 26.1 version of Minecraft is unobfuscated, as are its snapshots. With this in mind, you'll need to make more changes to your build scripts than usual in order to port to it.

INFO

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

Prerequisites

If your mod is still using Fabric's Yarn Mappings, you'll first need to migrate your mod to Mojang's official mappings before porting to 26.1.

If you are using IntelliJ IDEA, you will also need to update it to 2025.3 or higher for full Java 25 support.

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.
   • Note that, since 26.1 snapshots are not stable versions of Minecraft, you will need to select this version manually from the dropdown.
3. At the top of build.gradle, change the version of Loom you are using from id "fabric-loom" to id "net.fabricmc.fabric-loom". If you specify Loom in settings.gradle, change it there as well.
4. Remove the mappings line from the dependencies section of build.gradle.
5. Replace any instances of modImplementation or modCompileOnly with implementation and compileOnly.
6. Remove or replace any mods made for versions before 26.1 with versions compatible with this update.
   • No existing mods for 1.21.11 or older versions of Minecraft will work on 26.1, even as a compile-only dependency.
7. Replace any mentions of remapJar with jar.
8. 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 26.1, you can now go through your mod and update any code that has changed to make it compatible with the snapshot.

IMPORTANT

Because Minecraft 26.1 is still in the snapshot stage, documentation on specific changes is still lacking. Good luck, you're on your own!

• Fabric API 26.1 Porting Guide lists the renames made to Fabric API in 26.1 snapshots to match Mojang's names.
• Java Edition 26.1 on the Minecraft Wiki is an unofficial summary of the contents of the update.
• NeoForge's Minecraft 1.21.11 -> 26.1 Mod Migration Primer covers migrating from 1.21.11 to 26.1, focusing only on vanilla code changes.
  • Please note that the linked article is third-party material, not maintained by Fabric. It's under copyright of @ChampionAsh5357, and licensed under Creative Commons Attribution 4.0 International.