Port a mod from Minecraft 26.1 to 26.2 (Fabric and NeoForge)
Moving from 26.1 to 26.2 is a smaller step than 1.21.11 to 26.1. The build changes only in version numbers. Most code that breaks touches screens, rendering or the vanilla registry holders. Since 26.1 the game ships with Mojang’s names, so the renames below are the same on Fabric and NeoForge.
Checked on 19 November 2026 against Fabric’s porting page and 26.2 post and NeoForge’s 26.2 primer, linked under Sources. If your mod is still on 1.21.11, port it to 26.1 first.
Update the build
Section titled “Update the build”On Fabric, update the Gradle wrapper, then set the 26.2 versions of Minecraft, Fabric Loader, Loom and Fabric API in
gradle.properties and refresh Gradle:
./gradlew wrapper --gradle-version latest./gradlew --refresh-dependenciesFabric’s 26.2 post gave Loom 1.17, Gradle 9.5.1 and Loader 0.19.3 as current when it came out. Take today’s versions from fabricmc.net/develop.
On NeoForge, set minecraft_version and neo_version in gradle.properties to 26.2 and a NeoForge 26.2 build, and
minecraft_version_range to match. The version list is on NeoForge’s project page.
Then refresh Gradle.
Code that changes
Section titled “Code that changes”| 26.1 | 26.2 |
|---|---|
Minecraft.getInstance().setScreen(...) |
Minecraft.getInstance().gui.setScreen(...) |
Minecraft.getInstance().screen |
Minecraft.getInstance().gui.screen() |
Minecraft.getInstance().gui.setOverlayMessage(...) |
Minecraft.getInstance().gui.hud.setOverlayMessage(...) |
Registry holders in BlockEntityType |
BlockEntityTypes |
Registry holders in EntityType |
EntityTypes |
TextureFormat (RGBA8, RED8, DEPTH32) |
GpuFormat (RGBA8_UNORM, R8_UNORM, D32_FLOAT) |
DestFactor, SourceFactor |
BlendFactor |
Font#drawInBatch |
removed: use Font$PreparedText or Font$GlyphVisitor |
MultiBufferSource |
removed: the closest is PreparedRenderType |
ItemInHandRenderer#renderHandsWithItems |
submitHandsWithItems |
RenderTypes#textIntensity |
RenderTypes#textGrayscale |
Block and item ids are now kept in BlockIds, BlockItemIds and ItemIds, and valueLookupBuilder is gone.
Rendering has an experimental Vulkan backend next to OpenGL. Code that calls OpenGL directly has to move to Blaze3D. NeoForge’s primer lists the rest of the rendering changes.
Fabric API
Section titled “Fabric API”- A tag file can remove entries with the
"fabric:remove"key. EntityFluidInteractionRegistry.register(...)with aFluidBehavioris new and still experimental.- Client commands can require an attended client:
.requires(FabricClientCommandSource::attended).
Sources
Section titled “Sources”- Fabric: Porting to 26.2
- Fabric for Minecraft 26.2
- Minecraft 26.1.x to 26.2 Mod Migration Primer, NeoForge, licensed under CC BY 4.0. The rename table uses its entries.