Port a mod from Minecraft 26.2 to 26.3 (Fabric and NeoForge)
26.3 turns several registries into data and components. Fuel, compostables, brewing recipes and the stripping, tilling and flattening behaviours are no longer registered from code. Input moves from GLFW to SDL, and a few worldgen and rendering names change. The renames are vanilla names, so they apply on Fabric and NeoForge alike.
Checked on 19 November 2026 against Fabric’s porting page and 26.3 post and NeoForge’s 26.3 primer, linked under Sources.
Update the build
Section titled “Update the build”On Fabric, the steps are the same as for every version: update the wrapper, set the 26.3 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.3 post gave Loader 0.19.5, Loom 1.17 and Gradle 9.6.0 as current when it came out. Today’s versions are on fabricmc.net/develop, and Fabric’s example mod has a 26.3 branch to compare with.
On NeoForge, set minecraft_version, neo_version and minecraft_version_range in gradle.properties to 26.3 and a
NeoForge 26.3 build from NeoForge’s project page, then refresh Gradle.
Registries that became data or components
Section titled “Registries that became data or components”| Before 26.3 | In 26.3 |
|---|---|
Fabric’s FuelRegistry |
the item’s fuel component |
Fabric’s CompostingChanceRegistry |
the DataComponents.COMPOSTABLE item component |
Fabric’s FabricPotionBrewingBuilder |
brewing recipes as JSON in the recipe folder |
| Stripping, tilling and flattening registries | block transformers as JSON in the block_transformer folder, with BlockTransformerHelper |
Configured features in worldgen/configured_feature |
worldgen/feature |
| Surface rules | material rules |
Block codecs and the block_type registry are removed. Recipes and advancements are now reloadable registries.
Code that changes
Section titled “Code that changes”| 26.2 | 26.3 |
|---|---|
ItemInHandRenderer |
FirstPersonHandsAndItemsRenderer |
GameRenderer#itemInHandRenderer |
firstPersonHandsAndItemsRenderer |
KeyEvent#scancode |
keycode |
InputConstants.Type.KEYSYM |
KEYBOARD |
BuiltInRegistries#FEATURE |
FEATURE_TYPE |
BuiltInRegistries#CARVER |
CARVER_TYPE |
ContextAwarePredicate |
removed: use Holder<LootItemCondition> |
ModelTemplates#FARMLAND |
CUBE_BOTTOM_TOP_INDENTED |
ClientLevel#addBreakingBlockEffect |
addBreakingBlockEffects |
Window#toggleFullScreen |
setFullscreen or setExclusiveFullscreen |
#moj_import in shaders |
#include |
Input now runs on SDL instead of GLFW. Use InputConstants for keys. A custom text field has to tell
TextInputManager when it gains or loses focus.
Fabric API
Section titled “Fabric API”- A modded block sets its enchanting power by overriding
Block#getProvidedEnchantmentPower. TooltipFlag#shouldDisplayAllInformationis new.- In the fluid API,
getColoredNamereplacesenableColoredVanillaFluidNames, and the fluid behaviour API is no longer experimental.
- How-tos with examples for each loader and version
- Fix ClassNotFound and NoSuchMethod errors after a port
Sources
Section titled “Sources”- Fabric: Porting to 26.3
- Fabric for Minecraft 26.3
- Minecraft 26.2 to 26.3 Mod Migration Primer, NeoForge, licensed under CC BY 4.0. The rename table uses its entries.