Skip to main content

Minecraft: Bedrock Edition - 1.21 (Tricky Trials)

Updated Add-On Template Packs

  • Updated Add-On templates for 1.21.0 with new resources, behaviors, and documentation are available to download at aka.ms/MCAddonPacks

General

  • Fixed a crash when an entity identifier was too complex
  • Removed 'server-authoritative-block-breaking' from the default server.properties
  • Removed 'server-authoritative-sound' from server.properties
  • Fixed a problem where teleporting while using an item with a long use duration could leave it in an unresponsive state until the use duration elapsed
  • Documentation for version 1.13.0 of "Decoration Features" is now up to date
  • Changed Biome documentation to generate with a different system, which will cause the layout and order of those documentation elements to change
  • Fixed a bug where, if a block and item are registered with the same identifier, the block returns a null item when 'picked'
  • Fixed an issue where particle effect lifetime event timeline did not trigger events as expected
  • Removed Free camera preset experiment as the Free camera preset is available in retail

Script API

  • ScreenDisplay
    • Moved getHiddenHudElements(): HudElements[] from beta to 1.11.0
    • Moved isForcedHidden(hudElement: HudElements): boolean from beta to 1.11.0
    • Moved resetHudElements(): void from beta to 1.11.0
    • Moved setHudVisibility(visible: HudVisibility, hudElements?: HudElements[]): void from beta to 1.11.0
    • Moved hideAllExcept(hudElements?: HudElements[]): void from beta to 1.11.0
  • HudElement
    • Moved _HudElement_enum from beta to 1.11.0
    • Moved HudElementsCount from beta to 1.11.0
  • HudVisibility
    • Moved HudVisibility enum from beta to 1.11.0
    • Moved HudVisibilityCount from beta to 1.11.0
  • Moved WeatherChangeBeforeEvent from beta to 1.11.0
  • BlockPermutation
    • Removed function clone
  • Creator Settings UI
    • Watchdog settings
    • Increase script hang threshold
    • Disable/Enable slow script warnings and adjust threshold
    • Disable/Enable script spike warnings and adjust threshold
    • Removed disableWatchdog method
    • Added disableWatchdogTimingWarnings to disable spike and slow warnings per behavior pack
  • Released ItemEnchantableComponent from beta to 1.11.0
  • Released Enchantment APIs from beta to 1.11.0
    • interface Enchantment
    • enum EnchantmentSlot
    • class EnchantmentType
    • class EnchantmentTypes
  • Added new interface EntityFilter with many of the existing options from EntityRaycastOptions
  • EntityRaycastOptions now inherits from EntityFilter
  • EntityQueryOptions now inherits from EntityFilter
  • Removed property blockFilter (and several others, now moved to EntityFilter) from BlockRaycastOptions
  • BlockRaycastOptions now inherits from BlockFilter
  • Released BlockFilter to 1.4.0
  • Released volume from beta to 1.11.0
  • GameRules
    • Released GameRules from beta to 1.11.0
    • Released GameRuleChangeAfterEvent from beta to 1.11.0
    • Released GameRuleChangeAfterEventSignal from beta to 1.11.0
    • Released gameRules from beta to 1.11.0
    • Released gameRuleChange from beta to 1.11.0
  • EntityTameableComponent
    • Changed return type of getTameItems to ItemStack[]
    • Changed tame to take a player
    • Added method tamedToPlayertamedToPlayerIdisTamed
  • Released EntityColor2Component from beta to 1.11.0
  • Released PaletteColor from beta to 1.11.0
  • Released matches from beta to 1.11.0
  • Released EntityNavigationComponent from beta to 1.11.0
  • Released EntityNavigationClimbComponent from beta to 1.11.0
  • Released _EntityNavigationFloatComponent_f rom beta to 1.11.0
  • Released EntityNavigationFlyComponent from beta to 1.11.0
  • Released EntityNavigationGenericComponent from beta to 1.11.0
  • Released EntityNavigationHoverComponent from beta to 1.11.0
  • Released EntityNavigationWalkComponent from beta to 1.11.0
  • Moved entity from beta to 1.11.0
  • Moved _EntityTameMountComponent_and method tame from beta to 1.11.0
  • Moved EntityRideableComponent from beta to 1.11.0
  • Moved Seat from beta to 1.11.0
  • Moved EntityRidingComponent from beta to 1.11.0
  • Fixed _GameRules_rule property-setters so that changes are propagated to clients
  • Moved _startItemCooldown_and player.getItemCooldown from beta to 1.11.0
  • Released playSound from beta to 1.11.0
  • playSound is now deprecated and will be removed in a future major version
    • Use Dimension.playSound as the alternative
  • Released ListBlockVolume from beta to 1.11.0
  • Released BlockVolumeBase from beta to 1.11.0
  • Released BlockLocationIterator from beta to 1.11.0
  • Moved method getGameMode(): GameMode from beta to 1.11.0
  • Moved method setGameMode(gameMode?: GameMode): void from beta to 1.11.0
  • Moved member playerGameModeChange: PlayerGameModeChangeAfterEventSignal from beta to 1.11.0
  • Moved member playerGameModeChange: PlayerGameModeChangeBeforeEventSignal from beta to 1.11.0
  • Moved class PlayerGameModeChangeAfterEvent from beta to 1.11.0
  • Moved class PlayerGameModeChangeAfterEventSignal from beta to 1.11.0
  • Moved class PlayerGameModeChangeBeforeEvent from beta to 1.11.0
  • Moved class PlayerGameModeChangeBeforeEventSignal from beta to 1.11.0
  • Added ItemComponentConsumeEvent for beta
  • Changed _waitTick(ticks?: number)_to system.waitTicks(ticks: number);
  • Renamed property _selectedSlot_to selectedSlotIndex and moved it from beta to 1.11.0

Blocks

  • The "tallgrass" block is now split into unique instances "short_grass" and "fern"
  • "double_plant" block is now split into unique instances "sunflower", "lilac", "tall_grass", "large_fern", "rose_bush" and "peony"
  • "coral_block" block is now split into unique instances: "tube_coral_block", "brain_coral_block", "bubble_coral_block", "fire_coral_block", "horn_coral_block", "dead_tube_coral_block", "dead_brain_coral_block", "dead_bubble_coral_block", "dead_fire_coral_block" and "dead_horn_coral_block"
  • "stone_block_slab" block is now split into unique instances "smooth_stone_slab", "sandstone_slab", "petrified_oak_slab", "cobblestone_slab", "brick_slab", "stone_brick_slab", "quartz_slab", and "nether_brick_slab"
  • Updated block geometry to allow uv rotations
    • This allows you to rotate the specified uv rect in 90 degree increments before applying it to a block face
    • Supported from minecraft:geometry format version 1.21.0 and up
  • Added pivot for scale in the Block Transformation Component
  • Added pivot for rotation in the Block Transformation Component

Commands

  • Fixed hunger element so that its visibility can be changed with the /hud command

Components

  • The default values for the "damage_sources" field of "behavior.panic" have been updated
    • For the complete list of the new default values, refer to the "Vanilla Parity" section of the changelog
    • This change only affects entities with a format version of 1.21.0 or higher
  • Multiple items with the same custom component will now correctly trigger custom component logic

Entities

  • Updated entity geometry to allow UV rotations. This allows you to rotate the specified UV rect in 90 degree increments before applying it to a cube face of an entity model. Supported from _minecraft:geometry_format version 1.21.0 and up

Items

  • Unlocking requirements are now sent to clients for "minecraft:recipe_shapeless" and "minecraft:recipe_shaped"
    • It allows the UI to suggest recipes that are always unlocked when the game rule "dolimitedcrafting" is enabled

Experimental Features

Script API

  • Changed function from fillBlocks(begin: Vector3, end: Vector3, block: BlockPermutation | BlockType | string, options?: BlockFillOptions): number to fillBlocks(volume: BlockVolumeBase | CompoundBlockVolume, block: BlockPermutation | BlockType | string, options?: BlockFillOptions): ListBlockVolume
  • BlockFillOptions
    • Removed member matchingBlock?: BlockPermutation
    • Added member blockFilter?: BlockFilter
    • Added member ignoreChunkBoundErrors?: boolean
  • Added ItemComponentUseCompleteEvent for beta
    • Moved _setType_API from beta to stable 1.11.0
    • Added function waitTick(ticks?: number): Promise where the returned promise is resolved after "ticks" number of ticks or 1 tick if no ticks parameter is supplied
  • Removed argument waterlogged from function setBlockPermutation and moved it from beta to 1.11.0
  • Moved function saveToWorld from beta to 1.11.0
  • Moved function saveAs from beta to 1.11.0
  • Updated signature of createFromWorld and moved it from beta to 1.11.0
  • Renamed function getIds to getWorldStructureIds and moved it from beta to 1.11.0
  • Added ItemComponentMineBlockEvent for beta
  • Event Signals
    • Unsubscribe is no longer marked as "@throws". It does not throw exceptions and never has
  • Added getAll to beta
  • Added PlayerInputPermissions and inputPermissions for enabling & disabling categories of player input permissions
  • Added InputPermissionCategory
  • Added afterEvents.playerInputPermissionCategoryChange for listening to changes to a players input permissions
  • Added ignoreBlockCollision to EntityRaycastOptions which when true, will make the raycast not stop on block collision
  • Added includePassableBlocks to EntityRaycastOptions which when true, passable blocks like vines and flowers will be considered as blocks that 'stop' the raycast
  • Added includeLiquidBlocks to EntityRaycastOptions which when true, liquid blocks will be considered as blocks that stop the raycast
  • Added ItemComponentHitEntityEvent and ItemComponentBeforeDurabilityDamageEvent for beta
  • get will now handle items whose names have changed so that scripts referencing old names will still work as intended
  • Added ItemComponentUseOnEvent for beta
  • Moved _typeId_and Block.matches from beta to stable
  • Update JavaScript engine
    • BigInt support
    • hasOwn
    • Array findLast and at
    • Miscellaneous bug fixes
  • @minecraft/server.BlockType
    • Moved _id_API from beta to stable 1.11.0
  • @minecraft/server.BlockTypes
    • Moved BlockTypes API from beta to stable 1.11.0
    • Moved _type_API from beta to stable 1.11.0
  • @minecraft/server.Block
    • Moved _type_API from beta to stable 1.11.0
  • EntityTameMountComponent
    • Added method tameToPlayer
    • Added properties isTamedisTamedToPlayertamedToPlayer, and tamedToPlayerId
  • GameRules
    • Added property showDaysPlayed to beta
  • Fixed PlayerInputPermissions input-lock category property-setters so that changes are propagated to clients
  • Fixed issue where blocks with custom components could not have a block placed onto them without crouching
  • Added new interface VectorXZ
  • Added method getTopmostBlock which will perform a raycast from the top of the world downwards, trying to find the first solid block
  • Added method getBlockAbove which will perform a raycast from a given position, trying to find the first solid block above
  • Added method getBlockBelow which will perform a raycast from a given position, trying to find the first solid block below

Molang

  • Added Molang _state_time -> number_for animation controllers, which returns the time in seconds spent in the current controller state (inclusive of blend time)
    • Requires the 'Upcoming Creator Features' experimental toggle