Why Your Addons Crash After the v26.x Update
Minecraft Bedrock v1.21.20 (v26.0) and v1.21.30 (v26.2) introduced breaking changes to the script engine, entity components, and biome systems. Addons using deprecated APIs crash on load or cause world corruption. This guide covers the exact fixes for each breaking change.
Breaking Change #1: Script Engine Module System (Biggest Cause)
v26.0+ requires ES modules syntax. The old import * as minecraft from "@minecraft/server" pattern is deprecated.
❌ Old Code (Crashes on v26+)
import * as mc from "@minecraft/server";
import { world, system } from "@minecraft/server";✅ New Code (v26.0+ Compatible)
import { world, system, Block, Entity, Player } from "@minecraft/server";
import { ItemStack, Enchantment } from "@minecraft/server";Fix: Replace all import * as X with named imports. Update manifest.json "module" field to "type": "module".
Breaking Change #2: Entity Component Removals
Several entity components were removed or renamed in v26.0:
| Removed Component | Replacement |
|---|---|
minecraft:rideable | Use minecraft:rideable with new seat_count and family_types format |
minecraft:breathable | Use minecraft:breathable with total_supply and suffocate_time |
minecraft:fire_immune | Use minecraft:fire_immune (boolean only, no object) |
minecraft:pushable | Use minecraft:pushable with is_pushable, is_pushable_by_piston |
Fix: Open your entity JSON files, find the old component format, and update to the new schema. See official entity reference.
Breaking Change #3: Biome/Generation Changes
Custom biomes using the old minecraft:biome component in biome_definition.json will crash world generation.
v26+ requires minecraft:biome_tags and minecraft:climate components
Noise parameters changed — regenerate biome noise settings using Bedrock.dev Biome Editor
Breaking Change #4: Item/Block Component Updates
minecraft:cooldown → now requires category field
minecraft:durability → max_durability renamed to damage in some contexts
minecraft:loot tables → schema version bumped to 2
Quick Fix Checklist
Backup your addon folder first
Update manifest.json: "min_engine_version": [1, 21, 20]
Convert all scripts to ES module syntax (named imports only)
Run entity/block/item JSON through Bridge validator
Test in a new creative world before loading survival worlds
If Nothing Works: Downgrade or Wait for Creator Update
For Marketplace addons: wait for the creator to push an update. For community addons: check the creator’s Discord/GitHub for a v26-compatible fork. As a last resort, do not downgrade Minecraft — it breaks Realms and multiplayer. Instead, disable the crashing addon until fixed.
Last updated: July 2026 | Covers v1.21.20 (v26.0) through v1.21.30 (v26.2)
