Skip to content

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.

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:

Terminal window
./gradlew wrapper --gradle-version latest
./gradlew --refresh-dependencies

Fabric’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.

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.

  • A tag file can remove entries with the "fabric:remove" key.
  • EntityFluidInteractionRegistry.register(...) with a FluidBehavior is new and still experimental.
  • Client commands can require an attended client: .requires(FabricClientCommandSource::attended).