Java Edition 1.21.6 - minecraft.fandom.com

Additions[]

• Added Old Spelling Indonesian (Indonesian pre-reform) and Cantabrian language support

Advancements[]

Heart Transplanter

• Adventure Advancement that is unlocked when a player places a Creaking Heart with the correct alignment between two Pale Oak Log blocks

Stay Hydrated!

• Husbandry Advancement when a Dried Ghast block is placed into water

Blocks[]

Dried Ghast block

• The Dried Ghast block is found in Nether Fossil structures and is the first stage of the Happy Ghast mob
• Can be crafted with 1 Soul Sand block and 8 Ghast Tears:

• When waterlogged, it undergoes 3 hydration level changes over approximately 20 minutes, until it spawns a Ghastling mob
• The hydration level decreases when it is no longer waterlogged, using the same timescale
• The hydration level is not preserved when mined
• Makes sounds and shows particles depending on its hydration level
• The Dried Ghast block emits a vibration frequency of 11 when its block state changes
• Piglins can now give Dried Ghast blocks when bartered with

Items[]

Harness

• Harness is a new item that can be equipped on a Happy Ghast to allow players to ride it
• The Harness comes in 16 different colors
• Crafted from 3 Leather, 2 Glass blocks and 1 Wool block
  • The Harness will have the same color as the Wool block used when crafting:

• Can be re-dyed in the crafting grid
• Can only be equipped on a[Happy Ghast
• Allows up to 4 players to mount the Happy Ghast
• Can be removed from the Happy Ghast using Shears when no players are mounted

Music Disc

• Add new music disc "Tears" by Amos Roddy
  • Can be obtained by killing a Ghast with a fireball deflected by a player
  • Has a comparator output of 10 when played in a Jukebox

Locator Bar[]

The Locator Bar is a new UI element that displays the direction of other players in the world in multiplayer.

• If another player is in the world (and that player is not hiding), the Locator Bar will display in the same area as the experience bar
  • When experience is gained, the experience bar will appear
  • If there are no other players in the world, the experience bar will display as normal
• Facing other players within a 120 degree range will display those players as colored indicators on the Locator Bar
  • Other players that are above/below the screen will also display an up/down arrow, together with their indicator
  • The indicator will change to different sized icons depending on how far away the other player is
  • Colored indicators are randomized for each player
    • Operators can modify the colors of indicators with the /waypoint command
      • e.g.: /waypoint modify @s color red to set an indicator to red
    • Players on a team will override their default indicator color with their team color
• Players can hide by crouching, wearing a mob head or a Carved Pumpkin, or using a Potion of Invisibility
  • The following items will hide players when worn in the head slot:
    • Carved Pumpkin
    • Skeleton Skull
    • Wither Skeleton Skull
    • Player Head
    • Zombie Head
    • Creeper Head
    • Dragon Head
    • Piglin Head
• Players in Spectator mode are not visible on the Locator Bar
  • However, spectators are visible to each other
• The Locator Bar can be toggled off by setting the locatorBar game rule to false

Mobs[]

Ghastling

• The Ghastling is a young version of the Happy Ghast mob
• Spawns from a Dried Ghast block that has continuously been waterlogged for about 20 minutes
• After spawning, the Ghastling will try and follow:
  • Players within a 16-block radius or
  • An adult, non-aquatic passive mob or some of the neutral mobs within a 16-block radius
• If no player or suitable mob is close around, the Ghastling will idle around within 32 blocks from its home position where it spawned or was last interacted with
  • It will reset its home position if it is moved more than 16 blocks away from the border of its home position
• Can be tempted and fed using Snowballs
• Will grow up into a Happy Ghast after about 20 minutes, or faster if fed Snowballs

Happy Ghast

• Grows up from a Ghastling
• Can be equipped with a Harness and then be mounted by up to four players
• Tempted by Snowballs and Harness
  • The Happy Ghast can only be tempted with a harness when it has no harness equipped
• Slowly regenerates health, with regeneration speeding up during rain, snow or when flying at the same height as clouds
• The first player that mounts the Happy Ghast will control it, sitting above it in the front seat
  • When controlled, the goggles of the Happy Ghast flip down to cover its eyes
  • Press forward and back — move in the direction the player is looking
  • Press left and right — strafe in the respective direction
  • Press jump — fly directly up
  • Press sneak — dismount the Happy Ghast
• Players mounting after the first player are placed in slots on each side of it, starting clockwise from the first player
• If the Happy Ghast detects players standing on top of it, it ceases all movement and rotates to the closest cardinal direction
  • This happens regardless of whether it has a Harness equipped or not
• When mounted on the Happy Ghast, the third-person camera is further away from the player
• When there are no players mounted or walking on the Happy Ghast, it starts its roaming behavior
  • If players dismount midair, the Happy Ghast will descend towards the ground before it starts roaming
  • The roaming behavior is similar to the Ghastling, except for the radius being 64 blocks
  • When wearing a Harness, the Happy Ghast roams closer to the home position, within a 32 block radius
  • When leashed, the Happy Ghast has a roaming distance of 10 blocks
  • The Happy Ghast will try to stay close to blocks when roaming
• Cannot be bred
• Cannot enter boats
• Has no panic behavior when taking damage

Music and Sound[]

• Added 5 new background music tracks by Amos Roddy:
  • "Below and Above"
  • "Broken Clocks"
  • "Fireflies"
  • "Lilypad"
  • "O's Piano"
  • These new tracks will play in a variety of biomes in both survival and creative, as well as in the main menu
• Added a new sound for when a Lead snaps
• Added new custom sounds for shearing Saddles, Horse Armor, and Carpets from Llamas
• Added new sound volume category called "UI" for sounds played by UI elements, like button clicks

Music & Sound settings

• Added an option that allows players to change how frequently music plays while in a game world
• Added an option that enables a music toast to be shown whenever a song starts playing
  • With this option enabled, the song that is currently playing will always be seen in the top left corner of the in-game pause menu

Vibrant Visuals[]

Vibrant Visuals, first released on BE Minecraft Beta & Preview - 1.21.90.20 (April 2025), is taking its first steps to Java Edition.

Clouds

• Clouds now exist all the way to the horizon, with an option to reduce them
• Updated the pattern of clouds in the sky

Fog

• Fog was tweaked for improved atmospheric perspective
• It now becomes foggier when it rains
• Fog is now applied to 3D HUD elements such as first-person player hands and items in hands

Changes[]

• The test framework will no longer try to restart running tests after a server restart
• Updated the main screen panorama

Items[]

Elytra

• While gliding, using a Firework Rocket will only be used as a boost even if it could be placed on a block

Lead

• The Slime Ball in the Lead recipe has been replaced with a String:

• Improved leash mechanics, with reworked leash physics, allowing for a more stable leash connection, especially when leashed entities are not on the ground
  • When dragged on the leash, leashed objects will now orient themselves towards the entity holding the leash
  • Using a Firework Rocket when flying with leashed entities will now break the leash connections
• Leashes are now rendered twice as thick, matching Minecraft: Bedrock Edition
• Leashes can now be used to leash two mobs together
  • Sneak-interact on any mob while holding leashed mobs will leash these mobs to the entity interacted with
  • Re-leashing an entity is prevented if the re-leashing would result in immediate leash snapping due to distance
• Leashes can be snipped from an entity when interacting with them using Shears
  • This applies to its own leash connection as well as all entities attached to it
  • Dispensers can now snip leashes from entities in front of them when they are equipped with Shears
• When leashing an already leashed mob, their previous leash snaps
• You cannot steal leashed entities from other players
• Interactions with a Leash knot/Fence:
  • Fails for entities that are not in range of the Leash knot/Fence
  • All entities leashed to the player will be leashed to the Leash knot/Fence
  • Transfers all its leashed entities to the player if the player has no entities leashed
  • Sneak-interact only ever attaches leashes
  • Shearing or punching the Leash knot will break all current leash connections
• A Leash knot requires at least one connection to exist
• Boats and large mobs that can be leashed but cannot fit in a boat (Horses, Donkey, Mule, Camel and Sniffer) can be leashed in a special quad connection to the Happy Ghast
  • Happy Ghast will also show a custom layer when it is leashing something using a quad connection
  • Entities leashed in quad connection are now rendered without slack
• Leash snapping distance has been changed from 10 to 12 blocks
  • Happy Ghast has a leash snapping distance of 16 blocks
  • The distance between two leashed entities is determined based on the center of their bounding boxes, rather than their feet

Saddles

• Saddles can now be crafted with 3 Leather and 1 Iron Ingot
• Recipe unlocks when a player picks up their first Leather

• Some loot tables have had saddles removed from them (see Loot table below)

Shears

• Shears can be used to remove Saddles, Horse Armor, Harnesses and Carpets from the mobs they are equipped on.
  • This does not work if the mob has a rider, or if the player is crouching
  • Saddles cannot be removed from Ravagers using Shears
  • Dispensers with Shears cannot remove Saddles, Horse Armor, Harnesses or Carpets equipped on mobs
  • Shearing Saddles, Horse Armor, and Carpets will emit a vibration frequency of 6, along with the Unequip frequency of 4

Splash potions

• Splash Potions distance to affected entities now depends on the closest distance between the entity hitbox and the splash potion hitbox where it landed
  • This means that if an entity is hit directly by the splash potion, it will receive the full effect of the potion
  • If the entities are grouped together, they will receive the same effect strength

Loot table[]

The following loot tables have had Saddles removed from them and replaced with 1-5 Leather:

• Monster Room chests
• Ancient City chests
• Desert Pyramid chests
• Jungle Pyramid chests
• Stronghold altar chests

Mobs[]

• The old 16x pixel textures of the Ghast is now changed to 32x pixel textures, to look more similar to its passive counterpart.
• Increased the third-person camera distance when spectating or riding Ghasts, Ender Dragons, and Giants
• Wolves, Sheep and Pigs now have their legs mirrored
• Spectators will now teleport together with, but stop spectating, entities that move to other dimensions
• Horses, Donkeys, and Mules can now be fed carrots to heal, grow, and improve their temper

Music and Sound[]

• Music now plays even when the game is paused
• The following sound categories have been renamed:
  • Friendly Creatures -> Friendly Mobs
  • Hostile Creatures -> Hostile Mobs
• Rules for when ambient desert blocks sounds play have been tweaked

Ambient Desert Block Sounds Changes[]

• Ambient sand sounds no longer require sky access to play
• Ambient sand sounds now have a slightly decreased chance to play
• Terracotta blocks no longer trigger ambient sand sounds
• Sand blocks no longer trigger ambient wind sounds
• Terracotta blocks no longer trigger ambient wind sounds
• Short Dry Grass and Tall Dry Grass can now trigger ambient wind sounds when above 2 Sand, Red Sand or Terracotta blocks
• Dead Bush ambient sounds now have a slightly increased chance of playing

Projectiles[]

• The target tolerance margin of projectiles now changes over time
  • Previously, all projectiles had a target tolerance margin of 0.3 blocks
  • Now, all projectiles start with no margin for the first two ticks of their flight
  • After that, the target margin will expand by 0.05 blocks per tick until it reaches the previous 0.3 blocks margin
  • This allows for better precision close to the shooting player or entity, while still allowing for some collision leeway when the projectile is further away

Realms[]

• Changed the layout of the Realms configuration screen to use tabs
• The Worlds tab allows changes to any of the world slots, creating new worlds and changing their settings
• The Players tab allows management of the players that have access and their level of access to the Realm
• The Subscription tab allows management of the Realms subscription
• The Settings tab allows changing the settings of the Realm
• Introduced a Region Preference setting that allows for more granular control over what region a Realm is hosted in
• Changed wording for Close/Open Realm to Temporarily close/Reopen Realm
• Added the Realms logo to the Realms loading screens
• Added region information when connecting to a Realm

Technical Changes[]

• The Data Pack version is now 80
• The Resource Pack version is now 63
• Pressing F3 + V now prints client-side version information
• All JSON files (in worlds, packs, configuration, etc.) are now parsed in strict mode
• "Command Syntax" report now contains information about required permission level
• --quickPlaySingleplayer command line argument can now be used without an identifier to launch into the last played world

Data Pack versions 72 through 80[]

• Dimension Type definitions have a new optional field cloud_height, that indicates on what y-level the clouds start in the dimension
• The minecraft:custom click event has been expanded to carry a full NBT tag

Advancements[]

Added minecraft:player_sheared_equipment trigger

• Can Trigger when a player shears off a shearable equipment from an Entity
• Conditions:
  • item: item that was sheared
  • entity: entity that was sheared

Attributes[]

Added camera_distance

• Default value: 4.0
• Modifies the distance at which the camera is placed away from the player or spectated entity when in a third-person view
• If the entity being ridden has a larger camera_distance attribute, that distance will be used
• This distance is multiplied by the scale attribute to get a final target camera distance

Changed flying_speed

• The flying_speed attribute now also applies to Ghasts and Happy Ghasts

Added waypoint_transmit_range and waypoint_receive_range

• Default: 0.0, Minimum: 0.0, Maximum: 60000000.0
• Players have a default transmission and reception range of 60,000,000
• Mobs with a transmission range above zero will send waypoint packets to nearby receivers that are within that range
• Similarly, receivers only receive waypoints that are inside their reception range (and receive nothing if that range is zero)
• Examples:
  • /attribute @s minecraft:waypoint_transmit_range base set 0 will prevent a player from transmitting (hiding them)
  • /attribute @s minecraft:waypoint_transmit_range base set 80 will only let a player transmit up to 80 blocks (hiding them from players further away than that)
  • /attribute @s minecraft:waypoint_receive_range base set 0 will prevent a player from receiving (turns off their Locator Bar)
  • /attribute @s minecraft:waypoint_receive_range base set 120 will only let a player see Locator Bar dots that are within 120 blocks (hiding all players further away than that)

Commands[]

Added /datapack create

• Creates a new empty directory data pack for the current world
• The supported pack version is always equal to one supported by the game
• Available only to server owners
• Syntax: /datapack create <id> <name>
  • id: new pack name, must be a valid directory name
  • name: text component to be placed in description in pack.mcmeta

Added /dialog

• Used to show dialog to clients
• Syntax:
  • /dialog show <targets> <dialog>: show dialog to player(s)
    • <targets>: player name, UUID or a player selector
    • <dialog>: namespaced ID from the minecraft:dialog registry or an inline dialog value as described below
    • Returns the number of players in the targets argument
  • /dialog clear <targets>: clear the dialog for player(s), if they have any visible
    • <targets>: player name, UUID or a player selector
    • Returns the number of players in the targets argument

Modified /playsound

• Added new category ui
• Sounds in this category will continue playing when paused, similarly to music

Added /version

• Prints the current version information on the server side
• Available in singleplayer or for server operators
• No arguments

Added /waypoint

• For querying and modifying waypoints
  • /waypoint list
  • /waypoint modify <entity-selector> color <color>
  • /waypoint modify <entity-selector> color hex <hex-color>
  • /waypoint modify <entity-selector> color reset
  • /waypoint modify <entity-selector> style <waypoint_style/resource>
  • /waypoint modify <entity-selector> style reset
• Arguments:
  • entity-selector: for selecting entities that are transmitting as waypoints (see waypoint_transmit_range attribute)
  • color: overrides the Locator Bar icon color for this waypoint
  • hex <hex-color> arguments are in web format (RRGGBB)
    • Red is either hex F00 or hex FF0000
    • Cornflower blue is hex 6495ED
  • /style: for changing the icon spriteset and selection distances
    • /set <waypoint_style/resource> changes the style to a specific asset under /waypoint_style/ (see Waypoint Styles section below)
  • reset will restore the default icon behavior of the Locator Bar
• Waypoint Styles
  • These define custom icons to be displayed on the Locator Bar and are within the waypoint_style/ asset directory.
  • The default implementation is as such:

{
  "near_distance": 128,
  "far_distance": 332,
  "sprites": [
    "minecraft:default_0",
    "minecraft:default_1",
    "minecraft:default_2",
    "minecraft:default_3"
  ]
}

• • • near_distance and far_distance are optional and default to the values 128 and 332 respectively.
      • far_distance distance must be greater than near_distance
    • Each sprite is searched within the prefix of hud/locator_bar_dot/ (the directory textures/gui/sprites/hud/locator_bar_dot).

Data components[]

attribute_modifiers Item Component

• Added an optional display field to attributes_modifiers entries
• There are 3 display types:
  • default: current behavior of showing the calculated attribute modifier values on the tooltip
  • hidden: does not show the attribute modifier entry
  • override: replaces the shown attribute modifier text
    • Contains a single field value for the text contents to show for this attribute modifier entry

equippable Item Component

• Added a new optional field: can_be_sheared (boolean)
  • If true, players can use Shears to remove this equippable item from a target mob by right-clicking, provided all other shearing conditions are satisfied
  • If not specified, it defaults to false
• Added a new optional field: shearing_sound (sound event)
  • It is a sound event that plays when the equippable item is sheared
  • If not specified, it defaults to the item.shears.snip sound event

painting/variant Item Component

• No longer accepts inline variants

Entity data[]

• Added the home_pos and home_radius fields to all mobs
  • Mobs with a set home position will limit their pathfinding to stay within the indicated area
  • Some mobs, such as Bats, Slimes, Magma Cubes, Phantoms, and Ender Dragons may ignore it
  • Interacting with leashes or riding may change the home position of the mob

area_effect_cloud

• The Particle field has been renamed to custom_particle, and now always functions as an exact override for the default colored entity_effect particle
  • The field will not be written if no override is specified
  • The color will no longer be inherited from the potion contents when specifying the entity_effect or tinted_leaves particle types

tnt

• The entity that primed the TNT is now stored in an optional owner field (UUID of the Living entity)

vex

• The owner of a Vex is now stored in an optional owner field (UUID of the mob)

Dialogs[]

• Added a way to display simple modal dialogs to a user
• Dialogs are stored in a minecraft:dialog registry, but can also be defined inline
• Dialogs are an experimental feature
• To avoid user confusion, dialog screens are marked with a warning sign next to the title
  • Clicking on this warning leads to a screen that explains to the user that this screen is provided by custom content
  • It also gives the user an option to leave the current world to avoid them being locked in an infinite loop of dialogs
  • If a new dialog is received by the client while a warning screen is visible, it will not replace it, but when the user clicks the "Back" button, the new dialog will be restored instead
• Dialogs can be displayed by the server in play and configuration connection phases
  • However, only inline registries are allowed in configuration, since registries are not yet available in that phase
  • Additionally, run_command click event is not available in the configuration phase
• Dialogs by default will close after the Escape is pressed
  • When this happens, the dialog will run the action specific to the dialog type described as "exit action" below
  • This behavior is configurable
• When the dialog screen is closed, the game goes back to the previously displayed non-dialog screen or back to gameplay
  • That means that new dialogs always replace already opened ones, if any
• Dialogs can be configured to be accessible from the Pause menu
  • This replaces and expands the "Server Links" button added in previous versions
• A new key bind called "Quick Actions" has been added to allow accessing content-configured dialogs

• Most dialogs follow a common layout, however exact contents depend on type:
  • Header with title and warning button
  • Body elements, scrollable if needed:
    • messages and items
    • inputs
    • actions buttons
  • Optional footer, contains main buttons and submit actions
• Developer's Note: Dialogs are not supposed to fully describe any in-game UI, but just to allow custom content to display simple messages and get input from users. This feature is intentionally limited to match that use case.

Dialog Description Format[]

• Dialogs are stored in the minecraft:dialog registry that can be provided by a datapack
• Fields:
  • type: one of dialog types from the minecraft:dialog_type registry
  • <type-specific>: see below

Common dialog fields[]

• Most dialog types share some fields. To avoid duplication, they are listed in this section
• Fields:
  • title: screen title, text component
    • Should be always visible on screen, no matter the specific type
  • external_title: name to be used for a button leading to this dialog (for example from the Pause screen), optional text component
    • If not present, title will be used instead
  • body: optional list of body elements or a single element, see below
  • inputs: optional list of inputs, see below
  • can_close_with_escape: can dialog be dismissed with the Escape, default true
  • pause: should the dialog screen pause the game in single-player mode, default: true
  • after_action: additional operation performed on the dialog after click or submit actions, default: close
    • After every action the dialog will always evaluate the contents of the after_action field
    • close: close the dialog and return to the previous non-dialog screen (if any)
    • none: do nothing, i.e. keep the current screen open
      • only available if pause is false to avoid locking the game in single-player mode
    • wait_for_response: replace the current dialog with a "Waiting for Response" screen
      • this option is intended to prevent users from sending multiple actions on laggy connections
        • servers are expected to eventually replace this screen with a new dialog
      • to avoid accidental locking, a "Back" button will become active after 5 seconds
        • clicking this button will continue as if the dialog was closed (i.e. the game returns to the previous non-dialog screen, if any)
      • the "Waiting for Response" screen will unpause the game in single-player mode to avoid locking the game

Dialog types[]

minecraft:confirmation

• A simple screen with two actions in the footer
• Exit action: same as no action
• Fields:
  • Common dialog fields (see above)
  • yes: action (see below) for positive outcome
  • no: action (see below) for negative outcome

minecraft:dialog_list

• A scrollable list of buttons leading directly to other dialogs, arranged in columns
• Titles of those buttons will be taken from external_title fields of targeted dialogs
• Exit action: same as exit_action, if present
• Fields:
  • Common dialog fields (see above)
  • dialogs: dialog, a list of dialogs, or a dialog tag
  • exit_action: optional action (see below) in footer
  • columns: number of columns, positive integer, default: 2
  • button_width: width of buttons in the list, integer from 1 to 1024 (inclusive), default: 150

minecraft:multi_action

• A scrollable list of actions arranged in columns
• Screen can have an optional exit action that will appear in footer
• Exit action: same as exit_action, if present
• Fields:
  • Common dialog fields (see above)
  • actions: non-empty list of actions (see below)
  • exit_action: optional action (see below) in the footer
  • columns: number of columns, positive integer, default: 2

minecraft:notice

• A simple screen with one action in the footer
• Exit action: same as action
• Fields:
  • Common dialog fields (see above)
  • action: main action (see below), defaults to a button with gui.ok label and no action or tooltip

minecraft:server_links

• A scrollable list of links received from the server in the minecraft:server_links packet, arranged in columns
• Note: this is a replacement for the previous "Server Links" screen, but now with an additional body
• Exit action: same as exit_action, if present
• Fields:
  • Common dialog fields (see above)
  • exit_action: optional action (see below) in the footer
  • columns: number of columns, positive integer, default: 2
  • button_width: width of buttons in the list, integer from 1 to 1024 (inclusive), default: 150

Dialog body types[]

• All dialogs have a list of body elements describing contents between title and actions or inputs
• Hover and click events on text components within bodies function as expected
• Click events are handled by the dialog screen like any other action — that means it will also run the after_action
• Fields:
  • type: one of the dialog body types from the minecraft:dialog_body_type registry
  • <type-specific>: see below

minecraft:item

• Item with an optional description
• If Description is present, it will be rendered to the right of the item
• The Item will be rendered as if it was in an inventory slot
• The Item is not scaled even if width and height are set to values other than default
• Fields:
  • item: item stack with count
  • description: optional object with fields:
    • contents: text component
    • width: maximum width of contents, integer from 1 to 1024, default: 200
    • Can also just be text component
  • show_decorations: if true, the count and damage bar will be rendered over the item, default: true
  • show_tooltip: if true, the item tooltip will show up when the item is hovered, default: true
  • width: horizontal size of element, integer from 1 to 256 (inclusive), default: 16
  • height: vertical size of element, integer from 1 to 256 (inclusive), default: 16

minecraft:plain_message

• A multiline label
• Fields:
  • contents: text component
  • width: maximum width of message, integer from 1 to 1024 (inclusive), default: 200

Input control types[]

• The Dialog can contain a set of controls that accept user input
• When submitted, the current value of the input will be used to build a response to the server according to the action selected by the user (see below)
• When a value is inserted into a macro, template substitution form is used
• When a value is sent as a tag, tag form is used
• Fields:
  • type: one of the input control types from the minecraft:input_control_type registry
  • key: string identifier of the value used when submitting data, must be a valid template argument (letters, digits and _)
  • <type-specific>: see below, depends on type

minecraft:boolean

• A plain checkbox with a label
• Output values:
  • As template substitution: on_true when checked, on_false when unchecked
  • As tag: 1b when checked, 0b when unchecked
• Fields:
  • label: text component to be displayed to the right of the control
  • initial: initial value, default: false (i.e. unchecked)
  • on_true: string value to send when the control is checked, default: true
  • on_false: string value to send when the control is unchecked, default: false

minecraft:number_range

• A slider for picking a numeric value out of some range
• Sends the currently selected value
• Output values:
  • As template substitution: text representation of the current value
    • Whole numbers will be sent without a decimal point
  • As tag: float tag with the current value
• Fields:
  • label: text component to be used as a slider label
  • label_format: translation key to be used for building the label (the first argument is the contents of the label field, the second argument is the current value), default: options.generic_value
  • width: width of input, integer from 1 to 1024 (inclusive), default: 200
  • start: start value (when slider is in the leftmost position) (inclusive), float
  • end: end value (when slider is in the rightmost position) (inclusive), float
  • initial: initial value of the slider, float, defaults to the middle of the slider range
  • step: step size, optional positive float
    • If present, only values of initial + <any integer> * step will be allowed
    • If absent, any value from the range is allowed

minecraft:single_option

• A button that cycles between a set of options when clicked
• Output values:
  • As template substitution: contents of the id field of the currently selected option
  • As tag: string tag with the contents of the id field of the currently selected option
• Fields:
  • label: text component to be displayed on the button
  • label_visible: if true, the label will be incorporated into the button text, default: true
  • width: width of button, integer from 1 to 1024 (inclusive), default: 200
  • options: a list of objects with fields:
    • id: string value to send on submit
    • display: text component to display on the button, optional (if not present, id is used)
    • initial: optional boolean flag that selects the initial option (only one option can have this be set to true)
    • Additionally, the list might also contain a plain string — in that case, it is equivalent to a single entry with field id set to that string and other fields set to default

minecraft:text

• A simple text input
• Output values:
  • As template substitution: contents with special characters escaped to fit in an SNBT literal (note: both ' and " are escaped)
  • As tag: string tag with contents without modification
• Fields:
  • width: width of the text input, integer from 1 to 1024 (inclusive), default: 200
  • label: text component to be displayed to the left of the control
  • label_visible: controls label visibility, default: true
  • initial: initial contents, default: "" (empty)
  • max_length: maximum length of the text input, positive integer, default: 32
  • multiline: if present, allows users to input multiple lines, optional object with fields:
    • max_lines: if present, limits maximum lines, optional positive integer
    • height: height of input, optional integer from 1 to 512
      • If this field is omitted, but max_lines is present, the height will be chosen to fit the maximum number of lines (but cannot exceed 512)
      • If this and max_lines are both omitted, it will default to a height that fits 4 lines

Actions[]

Dialogs have at least one action, presented to the user as a button. After every action, the dialog will always evaluate contents of the after_action field (see above).

• Fields:
  • label: button label, text component
  • tooltip: optional text component to display when the button is hovered or focused
  • width: width of the button, integer from 1 to 1024 (inclusive), default: 150
  • action: action to perform when the button is clicked, optional object with fields:
    • type: value from the minecraft:dialog_action_type registry
    • <type-specific>: see below, depends on type

Static dialog action types[]

• All existing click_event actions (except for open_file) are included as dialog action types.
• Uses same format as click_event on text components (but with action replaced with type). For example, when using show_dialog, the entry for the action button will look like this:

{
    "label": "some label",
    "action": {
        "type": "show_dialog",
        "dialog": "some:id"
    }
}

minecraft:dynamic/run_command Action Type

• This action will build a run_command event using a provided macro template
• The macro will be expanded with string values from inputs
• For example, if the macro template is some_command $(some_input), the string value from input with key of some_input parameter will be used for the template expansion
• Inputs not used in the macro will be ignored, while macro parameters not matching any inputs will be replaced with an empty string
• Fields:
  • template: string with a macro template to be interpreted as a command

minecraft:dynamic/custom Action Type

• This method will build a minecraft:custom event using all input values
• All input contents will be sent together inside a compound tag, with the tag value of each input put under id from key field of that input
• Additional static fields can be added to the payload
• Fields:
  • additions: fields to be added to the payload, optional compound tag
  • id: namespaced ID

Built-in dialogs[]

The built-in datapack contains some custom dialogs to provide customization of specific screens used by the client.

minecraft:custom_options

• Shows the contents of the minecraft:pause_screen_additions tag (see below)
• Allows the user to select a specific dialog if this tag contains multiple entries
• Note: Since this tag is meant for interoperability, any content that replaces this dialog should be careful not to hide other dialog providers

minecraft:server_links

• Replacement for the previously existing "Server Links" screen
• Meant to simplify migration for servers that previously used this feature

Pause screen configuration[]

• A data pack can request some of the available dialogs to be accessible from the Pause screen
• This feature replaces the "Server Links" button and is placed on the Pause screen according to the same rules
• Buttons leading to dialogs exposed in this way will use the label described in the external_title field
• This feature is configured by the minecraft:pause_screen_additions dialog tag:
  • If this tag is not specified or is empty, but the server has sent the server_links packet, the tag will be handled as if it contained the minecraft:server_links dialog
    • Note: this matches previous Server Links feature behavior
    • If this dialog is removed, the tag remains empty
    • If this tag is still empty, the button will not be visible ("Send Feedback" and "Report Bugs" buttons are visible instead)
  • If this tag has a single element, the Pause screen button will lead directly to that dialog
  • If this tag has multiple elements, the Pause screen button will lead to a minecraft:custom_options dialog, which (by default) lets the user select one of the tag elements
    • If this dialog is removed, the button will not be visible

Quick Actions key bind[]

• A new key bind has been added that allows users to access a set of dialogs
• Default key: G
• This feature is configured by the minecraft:quick_actions dialog tag
  • If this tag is empty, the key bind will do nothing
  • If this tag has a single element, the key bind will open that dialog
  • If this tag has multiple elements, the key bind will lead to the minecraft:quick_actions dialog, which (by default) lets the user select one of the tag elements
    • If this dialog is removed, the key bind will do nothing
• This option is intended for use in custom content and by servers, so this tag is empty in the Vanilla pack

Game Rules[]

Added LocatorBar

• Default is true: enabling the Locator Bar
• Changing to false will remove all existing Waypoints from all players

Tags[]

• Block tags:
  • Added #happy_ghast_avoids: blocks that Happy Ghasts avoid getting close to
  • Added #triggers_ambient_desert_dry_vegetation_block_sounds: blocks that can trigger ambient desert dry vegetation sounds to play from blocks above
  • Added #triggers_ambient_dried_ghast_block_sounds: blocks that can trigger ambient Dried Ghast sounds to play when a Dried Ghast block is placed on them
  • Renamed #plays_ambient_desert_block_sounds to #triggers_ambient_desert_sand_block_sounds
• Item tags:
  • Added #happy_ghast_food: items that can be used to feed Happy Ghasts
  • Added #happy_ghast_tempt_items: items that can be used to tempt Happy Ghasts
• Entity tags:
  • Added #can_equip_harness: entities that can equip the Harness item
  • Added #followable_friendly_mobs: non-baby entities that will be followed by Baby Happy Ghasts (Ghastlings)

Text Components[]

Click Events[]

• Users will now be prompted for confirmation before executing a command from the run_command click action in books and chat if the command cannot be parsed or requires elevated permissions (i.e., higher than 0)

Added minecraft:custom

• When the user clicks a component with this click action, the client will send a dedicated packet minecraft:custom_click_action to a server
• The intended use is as an alternative for run_command, to be used by modded servers without worrying about having to add custom commands
• This packet has no functionality on Vanilla servers
• Fields:
  • id: namespaced ID
  • payload: optional tag field

Added minecraft:show_dialog

• When the user clicks this component, a dialog will be opened for them
• Fields:
  • dialog: namespaced ID from the minecraft:dialog registry or inline dialog value as described above

Waypoint Broadcasting[]

The Locator Bar works through a server-controlled Waypoint system. Waypoints are received by Players, and connections between Waypoints and Players are managed by the multiplayer server.

• By default, all Players transmit a Waypoint from themselves, and all Players receive all Waypoints
• Individual Players can have their transmission and receive ranges controlled by the waypoint_transmit_range and waypoint_receive_range attributes

Resource Pack versions 56 through 63[]

• The game will now consistently respect the blur texture parameter in .png.mcmeta files
• All core shader uniforms are now uniform blocks
• The cloud texture (clouds.png) can no longer be colored
• Panorama textures must now all be the same size, and square

Block Models[]

• elements[].rotation.angle value in block models is no longer limited to multiples of 22.5 degrees, and can now be any angle from -45 to +45

Equipment Assets[]

• Added new happy_ghast_body layer type, rendering in the body slot of the Happy Ghast

Font[]

• Unifont
  • Updated Unifont to 16.0.03
  • Added previously omitted Unifont glyphs for Private Use Areas
    • Those glyphs are loaded as a separate sub-font minecraft:include/unifont_pua and are not included in any normally used font
    • Characters in those areas are managed by Under-CSUR (Under-ConScript Unicode Registry), which adds various scripts not present in the official Unicode set, like Tengwar or Sitelen Pona

• unihex Font Provider
  • The size_overrides field is now optional, defaults to an empty list

Item Models[]

• Item model definitions now have a boolean field oversized_in_gui, which is false by default
  • If true, the item model will be allowed to be bigger than its item slot
  • If false, the item model will be clipped to the item slot size when being rendered in gui
  • This ability of items being rendered outside their slots should not be considered officially supported, it was temporarily restored as an exception since many servers are relying on it
  • At some point in the future, we hope to replace it with an officially supported way of achieving similar functionality
• Introduced new item model minecraft:player_head to handle player profile texture loading and rendering
• Removed support for minecraft:profile from minecraft:head

minecraft:player_head special model type

• Renders a player head
• Uses the profile from the minecraft:profile component to load a texture. Renders a default texture until the profile texture is fully loaded
• No fields

minecraft:head special model type

• No longer supports a profile from the minecraft:profile component to load a player texture
• Renders a default player texture when kind is player, and no texture override is supplied
• Fields remain unchanged

Shaders & Post-process Effects[]

• Custom uniforms provided to post-process shaders are now uniform blocks
• Uniform definitions inside json files are now per-block

Post-process Effect Definitions[]

• Entries in the targets map have been expanded to support new properties
  • New optional boolean field: persistent, default: false
    • If true, this render target will be persistent across frames
    • The contents of the target will be cleared when the screen is resized
  • New optional field: clear_color, default: [0, 0, 0, 0]
    • Format: integer ARGB value, or float array in order [R, G, B, A]
    • When this target is created or cleared, it will be filled with this color

• The uniforms value is now a list-per-block, instead of a global list
  • e.g. uniforms: { "UniformBlockName": [ { "type": "vec2", "value": [...] } ] }
    • The order of uniforms in a block must match the order in the shader

• name as part of a uniform definition is no longer used
  • We encourage setting it to help keep the json file organized/readable, but the game will not use it

• value as part of a uniform definition replaces the old values, and the type depends on the type field
  • This field is required
  • "type": "int" needs "value": 123 (a single int)
  • "type": "float" needs "value": 123.4 (a single float)
  • "type": "vec2" needs "value": [1.2, 3.4] (two floats)
  • "type": "vec3" needs "value": [1.2, 3.4, 5.6] (three floats)
  • "type": "ivec3" needs "value": [1, 2, 3] (three ints)
  • "type": "vec4" needs"value": [1.2, 3.4, 5.6, 7.8] (four floats)
  • "type": "matrix4x4" needs "value": [1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0] (four rows of four columns of floats)
• We do not validate that the uniform block is valid for a given shader, giving incorrect information will cause undefined and funky behavior

Post-process Effect Shaders[]

• Instead of every uniform being an individual opaque type, they are now grouped in uniform blocks
• They will be set according to the pass definition in the json file, and may be shared across both vertex and fragment shaders
• The list of sizes (all vec2 *Size uniforms) are now replaced with a single SamplerInfo uniform block
  • This contains, in order, the size of the output texture followed by the size of every input texture
  • The order of textures in the definition file will dictate the order of samplers in this uniform
  • For most post chains this is just OutSize and InSize as before
  • All sizes are vec2

post/bits.fsh

• Expects a BitsConfig of float Resolution, and float MosaicSize

post/blit.fsh

• Expects a BlitConfig of vec4 ColorModulate

post/blur.vsh and post/box_blur.fsh

• Expects a BlurConfig of vec2 BlurDir, and float Radius

post/color_convolve.fsh

• Expects a ColorConfig of vec3 RedMatrix, vec3 GreenMatrix, and vec3 BlueMatrix

post/invert.fsh

• Expects a InvertConfig of float InverseAmount

post/rotscale.vsh

• Expects a RotScaleConfig of vec2 InScale, vec2 InOffset, and float InRotation

post/spiderclip.fsh

• Expects a SpiderConfig of vec4 Scissor, and vec4 Vignette

Shader Fog Changes[]

• The fog is now split into environmental and render-distance-based fog
• Previously, both of those concepts were mixed in the same uniforms
• Environmental fog is supposed to represent the "fogginess" of the environment the player is in
  • e.g. lava, water, and now also atmosphere
• Render distance fog is supposed to obscure the border of visible terrain
• Environmental fog uses spherical distance to determine its intensity, render distance fog uses cylindrical distance
• The resulting fog value for any given vertex is the maximum of both

Uniform blocks[]

CloudInfo Uniform Block

• Only available to the clouds shaders (rendertype_clouds.vsh/rendertype_clouds.fsh)
  • Contains CloudColor, CloudOffset, and CellSize (new)
    • CellSize contains the size of an individual cloud cell

DynamicTransforms Uniform Block

• Available through #moj_import <minecraft:dynamictransforms.glsl> for convenience
• Is no longer available to shaders that do not normally use it
• Contains ModelViewMat, ColorModulator, ModelOffset, TextureMat, LineWidth
  • These are very likely to change in the near future
  • The values of some of these are often hard coded and may not make sense for a given shader, ie LineWidth in any non-line based pipeline

Fog Uniform Block

• Available through #moj_import <minecraft:fog.glsl> for convenience
• Most shaders are able to receive this uniform block, even if they do not normally use it
• Contains FogColor, FogEnvironmentalStart (new), FogEnvironmentalEnd (new), FogRenderDistanceStart (renamed from FogStart), FogRenderDistanceEnd (renamed from FogEnd), FogSkyEnd (new) and FogCloudsEnd (new)
  • FogSkyEnd is new and represents where the fog should end when drawing for the sky
  • FogCloudsEnd is new and represents where the fog should end when drawing the clouds
  • FogRenderDistanceStart is the render distance fog start
  • FogRenderDistanceEnd is the render distance fog end
  • FogEnvironmentalStart is new and represents the start of environment-based fog
  • FogEnvironmentalEnd is new and represents the end of environment-based fog
• FogShape was removed. Render distance fog is now cylindrical and environmental fog is spherical

Globals Uniform Block

• Available through #moj_import <minecraft:globals.glsl> for convenience
• Most shaders are able to receive this uniform block, even if they do not normally use it
• Contains ScreenSize, GlintAlpha, GameTime and MenuBlurRadius (new)
  • MenuBlurRadius is the blur radius of the background when a menu is open

Lighting Uniform Block

• Available through #moj_import <minecraft:light.glsl> for convenience
• Most shaders are able to receive this uniform block, even if they do not normally use it
  • The values may not make sense if the shader would not normally expect it, however
• Contains Light0_Direction and Light1_Direction

LightmapInfo Uniform Block

• Only available to the lightmap shader (lightmap.fsh)
• Contains AmbientLightFactor, SkyFactor, BlockFactor, UseBrightLightmap, NightVisionFactor, DarknessScale, DarkenWorldFactor, BrightnessFactor, SkyLightColor with no change in behavior

Projection Uniform Block

• Available through #moj_import <minecraft:projection.glsl> for convenience
• Most shaders are able to receive this uniform block, even if they do not normally use it
• Contains ProjMat with no changes

Sounds[]

• Changed the location of the sounds for Glow Squid, Squid, Guardian, Horse, Rabbit, and Pufferfish from the entity folder to the mob folder
• Added entity/leashknot/break for when a Lead snaps
• The following sounds have been renamed:
  • entity/leashknot/break1 -> entity/leashknot/unleash1
  • entity/leashknot/break2 -> entity/leashknot/unleash2
  • entity/leashknot/break3 -> entity/leashknot/unleash3
  • entity/leashknot/place1 -> entity/leashknot/leash1
  • entity/leashknot/place2 -> entity/leashknot/leash2
  • entity/leashknot/place3 -> entity/leashknot/leash3
• The following sounds have been added for shearing Saddles, Horse Armor, and Carpets
  • mob/horse/armor_unequip
  • mob/horse/saddle_unequip
  • mob/llama/unequip

Sound Events[]

• block.sand.wind has been renamed to block.dry_grass.ambient
• entity.leash_knot.break has been replaced with item.lead.break and item.lead.untied
• entity.leash_knot.place has been renamed to item.lead.tied
• The following sound events have been added:
  • block.dried_ghast.break
  • block.dried_ghast.step
  • block.dried_ghast.fall
  • block.dried_ghast.ambient
  • block.dried_ghast.ambient_water
  • block.dried_ghast.place
  • block.dried_ghast.place_in_water
  • block.dried_ghast.transition
  • entity.ghastling.ambient
  • entity.ghastling.death
  • entity.ghastling.hurt
  • entity.ghastling.spawn
  • entity.happy_ghast.ambient
  • entity.happy_ghast.death
  • entity.happy_ghast.hurt
  • entity.happy_ghast.riding
  • entity.happy_ghast.equip
  • entity.happy_ghast.unequip
  • entity.happy_ghast.harness_goggles_up
  • entity.happy_ghast.harness_goggles_down
  • item.horse_armor.unequip
  • item.llama_carpet.unequip
  • item.shears.snip
  • item.saddle.unequip

UI Sprites[]

• The mob effect atlas has been removed, and sprites in the textures/mob_effect/ folder are now included within the GUI atlas
  • This means mob effect sprites now support GUI sprite scaling properties
• Added icon/music_notes and toast/now_playing sprites

Waypoint Styles[]

These define custom icons to be displayed on the Locator Bar and are within the waypoint_style/ asset directory.

• near_distance and far_distance are optional, and default to the values 128 and 332 respectively
  • far_distance distance must be greater than near_distance
• sprites is a list of at least one sprite ID within the prefix of hud/locator_bar_dot/ (the directory textures/gui/sprites/hud/locator_bar_dot)
• An example "bowtie" waypoint style is provided and accessible via the command:
  • /waypoint modify <entity-selector> style set bowtie
• When the distance to the waypoint is less than near_distance, the first sprite in the list will be selected
• When the distance to the waypoint is greater than far_distance, the last sprite in the list will be selected
• Between this range, sprites will be selected based on the linear progress between the near and far distances

Fixes[]

• The fix to MC-3697 has been partially reverted.
  • Decorative hanging entities such as paintings and item frames are now immune to explosions from submerged TNT while items and armor stands are once again vulnerable to them

98 issues fixed

From released versions before 1.21.6

• MC-36696 – Clicking on the statistics button on the menu screen advances the game by 1 tick
• MC-69821 – TNT "forgets" the player that ignited it when the world is reloaded
• MC-94800 – URL shown in open URL dialog is not shortened
• MC-97423 – Horse temporarily stuck in jump animation if dismounted
• MC-103511 – Sound/Song stops playing after adjusting the volume
• MC-104231 – Loading a custom structure doesn't load rails correctly
• MC-112730 – Beacon beam and structure block render twice per frame
• MC-118081 – Sounds don't pause when game is paused on some UI screens
• MC-118430 – Vex summoner is not stored in NBT despite being used for AI task
• MC-118432 – Vex summoner is not reset once it is dead
• MC-140819 – Lectern model extends past inventory slot
• MC-147260 – Map icons are not displayed in the cartography table
• MC-148278 – You can select multiple buttons at once in the book editing GUI by repeatedly pressing Tab
• MC-189246 – Unable to copy and paste on title page of a Book & Quill
• MC-191306 – Sounds played using /playsound are played in all dimensions
• MC-200092 – /setworldspawn seems to ignore the 'angle' parameter
• MC-200925 – Ghasts are not affected by potions thrown on their head
• MC-217887 – Unsigned books written in 1.9-pre1 or earlier don't upgrade properly
• MC-224704 – Block cracks are not affected by the fog from powder snow or lava
• MC-228451 – You cannot move the cursor around on the title page of a book and quill
• MC-229483 – Withers are not affected by instant harming and healing splash potions thrown above their heads
• MC-230902 – Black shapes sometimes appear in the end sky at low render distance
• MC-236464 – Beacon beams emitted from below the player are invisible after reloading chunks
• MC-237015 – The cursor in the book signing GUI doesn't turn fully invisible when blinking
• MC-238931 – Clouds stop rendering before they are hidden by fog
• MC-239701 – Rendering issue when breaking ice and flying with "Chunk Builder" set to Threaded
• MC-240121 – "1x1_b5.nbt" piece does not generate in woodland mansions
• MC-248682 – Translucent blocks moved by pistons aren't affected by fog correctly
• MC-248688 – Falling translucent blocks aren't affected by fog correctly
• MC-256411 – Clouds not fully rendered depending on angle
• MC-257532 – Clouds don't fill the sky after 1.18 height change
• MC-258336 – Frost Walker causes frequent visual corruption near chunk borders on Threaded and Semi-Blocking Chunk Builder
• MC-262268 – Keyboard navigation does not work in the book and quill GUI
• MC-264431 – #minecraft:sand tag has two minecraft:suspicious_sand
• MC-266318 – Trapdoors and doors have inconsistent subtitles for being opened and closed
• MC-269744 – Out of memory crash when using a preset with a large layer
• MC-270279 – Disabled item cooldown overlay renders incorrectly over stack size number
• MC-272825 – Custom filled maps from 23w31a and earlier do not upgrade properly in later versions
• MC-275374 – Drowneds with CanBreakDoors:1b don't break doors
• MC-276264 – Advancement screen shadow renders below item icons
• MC-276665 – Music is never turning on when it's toggled in the menu
• MC-277369 – The draft report icon isn't initially visible when saving a report as a draft
• MC-277370 – The draft report icon doesn't initially disappear when a report is discarded
• MC-277486 – Mob effect icons ignore "scaling" parameter in mcmeta files
• MC-277903 – Creative inventory tab icons can display item cooldown overlay
• MC-277991 – The 2 brightest pixel colors on pale oak boat items are still switched
• MC-277992 – 1 color in the pale chest boat item is incorrect
• MC-278231 – Space characters at the end of a line in book and quill are invisible even if given a texture
• MC-278459 – unifont.json contains trailing comma
• MC-278466 – Bundle experiment data pack related strings are not in deprecated.json
• MC-278873 – The data fixer regenerates chunks containing items obtained from flower pots using Ctrl + Pick Block before version 1.13, or it crashes the game if the item is in the player's inventory
• MC-279284 – Experience orbs from thrown bottles o' enchanting are very prone to getting stuck inside blocks
• MC-279417 – Luring mobs onto blocks at Y=-64 will instead make them pathfind to the highest elevation
• MC-279515 – The game stalls when running the "/test clearall" command with large radiuses
• MC-279875 – Cannot diagonally climb slab through suspended scaffolding
• MC-280047 – Temperate cows use their 1.14 texture with the Programmer Art resource pack enabled
• MC-280266 – Firefly bushes don't produce as many, or as constant, amounts of particles as on Bedrock Edition
• MC-280268 – Blazes and breezes use "large" spawn eggs despite mobs of a similar size using "medium"
• MC-280276 – Some item models can still clip into the block below when hovering on the ground
• MC-280281 – Fishing bobbers rapidly jitter when attached to entities that are moving
• MC-280297 – The volume level between grass and dirt is inconsistent
• MC-280471 – The Particle.color field in area effect clouds is read-only
• MC-280502 – Translation key snbt.parser.undescore_not_allowed has a typo
• MC-293619 – The chicken spawn egg texture in Programmer Art is missing pixels that match the inventory slot background color
• MC-293754 – Minecraft causes OpenGL errors occasionally
• MC-295395 – Entities interact differently with nether portals
• MC-295677 – Title screen fades in from black after closing the "Welcome to Minecraft" screen
• MC-295681 – Leaf litter can generate inside of woodland mansions
• MC-295690 – Players stay on fire for a while after barely touching fire
• MC-295850 – Done and Cancel buttons on the world creation Edit Game Rules screen do the same thing
• MC-295866 – The /setblock and /fill commands no longer update redstone power in some situations
• MC-295867 – Structures from previous versions fail with DataFixerUpper
• MC-295879 – Sprint-hitting boats and then getting in them causes the boat to fall through the block underneath
• MC-295895 – 1.21.5 breaks minecart behavior when travelling through nether portals
• MC-295914 – Loot table files accept invalid JSON
• MC-295944 – Reloading a professionless zombie villager causes it to gain random profession clothing
• MC-296035 – Two pixels from "mooshroom_spawn_egg" are the same as "cow_spawn_egg"
• MC-296099 – Nether portal collision is or isn't working depending on the cardinal direction
• MC-296121 – ClientboundLevelChunkPacketData buffer size is too big
• MC-296311 – TNT touching water will destroy blocks and damage entities but will ignore decorative entities
• MC-296337 – Minecarts cause memory usage increases and crashes
• MC-296348 – NoAI:1b mobs cannot be ridden in 1.21.5+
• MC-296624 – Old Brown Mooshroom texture is missing from Programmer Art
• MC-296638 – Clocks, compasses, and lodestone compasses do not render enchantment glint in certain display contexts when using Fabulous! graphics
• MC-296701 – Transformed entities do not retain their custom_data component
• MC-296709 – All non-default jukebox_playable components are deleted from existing items when updating past 1.21.4
• MC-296784 – The "Welcome to Minecraft" screen is missing its fade out
• MC-296866 – Predicates of particular namespaces failed to be accessed on /execute
• MC-297264 – Cat breeds are not seed based anymore
• MC-297347 – Tamed animals no longer sit when their owner changes dimension
• MC-297461 – Equipment and sleeping pos data cannot be loaded in 1.21.4, but can be loaded in 1.21.5 to bees spawned from bee nest and bee hive
• MC-297524 – Connection with realm gives weird HTML text
• MC-297537 – Extra "entity.wolf_whine.whine" sound event exists in sounds.json
• MC-297591 – Ender pearls can unexpectedly come to a halt
• MC-297614 – Area effect clouds with duration greater than or equal to 2147483628 disappear after a tick
• MC-297868 – Items in the armor.body and saddle slots are not kept when dying while the game rule keepInventory is set to true
• MC-297893 – prevent_equipment_drop enchantment effect does not work with armor.body and saddle slots
• MC-297894 – /clear command does not clear armor.body and saddle slots

Gallery[]

Videos[]

References[]

Minecraft: Java Edition versions
Particular versions	Demo Locations PC Gamer demo (Beta 1.3) Classic remake (0.0.23a_01) Developer versions Missing versions (Launcher)
Development cycle	Pre-Classic (2009) Classic (2009) Indev (2009–10) Infdev (2010) Alpha (2010) Beta (2010–11) Full Release (2011–present)
Other updates	Launcher updates Beta Sound Update (2011) Music Update (2013) Texture Update (2019)
Joke updates	2.0 (2013) 15w14a (2015) 1.RV-Pre1 (2016) 3D Shareware v1.34 (2019) 20w14∞ (2020) 22w13oneBlockAtATime (2022) 23w13a_or_b* (2023) 24w14potato (2024)
Combat Tests	1.14.3 - Combat Test Combat Test 2 Combat Test 3 Combat Test 4 Combat Test 5 Combat Test 6 Combat Test 7c Combat Test 7 Combat Test 7b Combat Test 8b Combat Test 8 Combat Test 8c
Pre-Classic Version history Cave Game rd-131648 rd-131655 rd-132211 rd-132328 Minecraft: Order of the Stone rd-20090515 Minecraft rd-160052 rd-161348 Minecraft Alpha mc-161607 mc-161616 mc-161625 mc-161648
Classic Version history Early Classic Private Test Builds 0.0.2a 0.0.3a 0.0.9a 0.0.10a 0.0.11a 0.0.12a Multiplayer Test Water Test Lava Test 0.0.12a_01 02 03* 0.0.13a World size test 1 2 Huge levels 0.0.13a_03 0.0.14a New blocks Water test Offset test 0.0.14a_01 03 04* 05* 06 07 08 Multiplayer Test 0.0.15a Multiplayer Test 1 Trees 0.0.15a Multiplayer Test 2 3 4 5 6 7 8 _01 _02 _03 0.0.16a _01 _02*** 0.0.17a 0.0.18a _01 _02 0.0.19a New blocks showcase 0.0.19a_01 02 03 04 05 06* 0.0.20a _01 _02 0.0.21a* _01 0.0.22a* _01 _02 _03 _04 _05 0.0.23a _01 Survival Test 0.24_SURVIVAL_TEST Development (View all) 0.24_SURVIVAL_TEST_01 02* 03 0.25 SURVIVAL TEST _01 _02 _03 _05 0.26 SURVIVAL TEST Development (View all) 0.27 SURVIVAL TEST Late Classic 0.28 Sheep Bleached Sheep 0.28_01 0.29 _01 _02 0.30 Server 1.0 1.1 1.2 1.3 1.4* 1.4.1 1.5 1.6 1.7 1.8 1.8.1 1.8.2 1.8.3 1.9 1.9.1 1.10 1.10.1
Indev Version history 0.31 December 2009 23-1 Development (View all) 23-2 31 1 2 January 2010 04 06 07 09 10 11 12 13 c 14 22 24 1 2 25 28 29 30 31 February 2010 01 1 2 02 04 1 2 05 Minecraft Indev February 2010 06* 07 1 2 11 12 1 2 13 14 18 19 23
Infdev Version history Minecraft Infdev (Guide) February 2010 27-1 Development (View all) 27-2 March 2010 13 16 20 21 25 27 30 1 2 April 2010 13 14 15 20 June 2010 07 08 11 15 16 1 2 17 1 2 18 (SF1) 24 25 1 2 (SF2) 27 29 30
Alpha Version history v1.0 (Guide) v1.0.0 v1.0.1 (SF3) _01 v1.0.2 _01 02 v1.0.3 v1.0.4 (SF4) v1.0.5* _01 v1.0.6 (SF5) _01 02 03 v1.0.7 v1.0.8 _01 v1.0.9 v1.0.10 v1.0.11 (SF6) v1.0.12 v1.0.13 _01* v1.0.14* (SF7) v1.0.15 v1.0.16 _01 02 v1.0.17 (SF8) _01 02 03 04 v1.1 (Guide) v1.1.0* (SF9) v1.1.1 (SS1) v1.1.2 _01 v1.2 Halloween Update (Guide) v1.2.0 preview v1.2.0_01 _02 v1.2.1 _01 v1.2.2 v1.2.3 _01 02 04 05 v1.2.4_01 v1.2.5 v1.2.6 Server 0.1.0 0.1.1 0.1.2* _01 0.1.3 0.1.4 0.2.0 _01 0.2.1 0.2.2 _01 0.2.3 0.2.4 0.2.5* _01 02 0.2.6 _01 02 0.2.7 0.2.8
Beta Version history Development versions 1.0 (Guide) 1.0 1.0_01 1.0.2 1.1 (Guide) 1.1* 1.1_01 1.1_02 1.2 (Guide) 1.2 1.2_01 1.2_02 1.3 (Guide) 1.3 1.3_01 1.4 (Guide) 1.4* 1.4_01 1.5 (Guide) 1.5 1.5_01 1.5_02 1.6 (Guide) 1.6 Test Build 3 preview 1.6.1 1.6.2 1.6.3 1.6.4 1.6.5 1.6.6 1.7 (Guide) 1.7 preview 1.7_01 1.7.2 1.7.3 1.8 Adventure Update (Part 1) (Guide) 1.8 preview pre* pre2 1.8.1
Full Release (1.0 – 1.9) Version history Development versions 1.0 Adventure Update (Part 2) (Guide) 1.0.0 pre pre2 pre3** pre4* pre5 pre6 RC1 RC2** 1.0.1 1.1 (Guide) 1.1 11w47a 11w48a 11w49a 11w50a 12w01a 1.2 (Guide) 1.2.1 12w03a 12w04a 12w05a* 12w05b 12w06a 12w07a 12w07b 12w08a 1.2 1.2.2 1.2.3 1.2.4 1.2.5 1.3 (Guide) 1.3.1 12w15a 12w16a 12w17a 12w18a 12w19a 12w21a 12w21b* 12w22a 12w23a 12w23b 12w24a 12w25a 12w26a 12w27a 12w30a 12w30b 12w30c 12w30d 12w30e 1.3 1.3.2 1.4 Pretty Scary Update (Guide) 1.4.2 12w32a 12w34a 12w34b 12w36a 12w37a 12w38a 12w38b 12w39a 12w39b 12w40a 12w40b 12w41a 12w41b 12w42a 12w42b 1.4 1.4.1 1.4.4 1.4.3 1.4.5* 1.4.6** 12w49a 12w50a 12w50b 1.4.7 1.5 Redstone Update (Guide) 1.5* 13w01a 13w01b 13w02a 13w02b 13w03a** 13w04a 13w05a* 13w05b 13w06a* 13w07a 13w09a 13w09b 13w09c 13w10a 13w10b 1.5.1* 13w11a 13w12~* 1.5.2* 1.6 Horse Update (Guide) 1.6.1 13w16a* 13w16b* 13w17a 13w18a 13w18b 13w18c 13w19a 13w21a 13w21b 13w22a* 13w23a 13w23b* 13w24a 13w24b 13w25a 13w25b 13w25c 13w26a 1.6* 1.6.2** 1.6.4 1.6.3* 1.7 The Update that Changed the World (Guide) 1.7.2 13w36a** 13w36b** 13w37a 13w37b 13w38a 13w38b 13w38c* 13w39a 13w39b 13w41a 13w41b* 13w42a 13w42b 13w43a 1.7 1.7.1 1.7.4 13w47a 13w47b 13w47c 13w47d 13w47e 13w48a 13w48b 13w49a 1.7.3 1.7.5 1.7.6 pre1 pre2 1.7.7* 1.7.8 1.7.9 1.7.10 pre1 pre2 pre3 pre4 1.8 Bountiful Update (Guide) 1.8 14w02a 14w02b 14w02c 14w03a 14w03b 14w04a* 14w04b* 14w05a 14w05b 14w06a 14w06b 14w07a 14w08a 14w10a 14w10b 14w10c* 14w11a 14w11b 14w17a 14w18a 14w18b 14w19a 14w20a 14w20b 14w21a 14w21b 14w25a 14w25b 14w26a 14w26b 14w26c 14w27a 14w27b 14w28a 14w28b 14w29a 14w29b 14w30a 14w30b 14w30c 14w31a 14w32a 14w32b 14w32c 14w32d 14w33a 14w33b 14w33c 14w34a 14w34b 14w34c 14w34d pre1 pre2 pre3 1.8.1 pre1 pre2 pre3 pre4 pre5 1.8.2 pre1 pre2 pre3 pre4 pre5 pre6 pre7 1.8.3 1.8.4 1.8.5 1.8.6 1.8.7 1.8.8 1.8.9 1.9 Combat Update (Guide) 1.9 15w31a 15w31b 15w31c 15w32a 15w32b 15w32c 15w33a 15w33b 15w33c 15w34a 15w34b 15w34c 15w34d 15w35a 15w35b 15w35c 15w35d 15w35e 15w36a 15w36b 15w36c 15w36d 15w37a 15w38a 15w38b 15w39a 15w39b 15w39c 15w40a 15w40b 15w41a 15w41b 15w42a 15w43a 15w43b 15w43c 15w44a 15w44b 15w45a 15w46a 15w47a 15w47b 15w47c 15w49a 15w49b 15w50a 15w51a 15w51b 16w02a 16w03a 16w04a 16w05a 16w05b 16w06a 16w07a 16w07b pre1 pre2 pre3 pre4 1.9.1 pre1 pre2 pre3 1.9.2 1.9.3 16w14a 16w15a 16w15b pre1 pre2 pre3 1.9.4
Full Release (1.10 – 1.19) Version history Development versions 1.10 Frostburn Update (Guide) 1.10 16w20a 16w21a 16w21b pre1 pre2 1.10.1 1.10.2 1.11 Exploration Update (Guide) 1.11 16w32a 16w32b 16w33a 16w35a 16w36a 16w38a 16w39a 16w39b 16w39c 16w40a 16w41a 16w42a 16w43a 16w44a pre1 1.11.1 16w50a* 1.11.2 1.12 World of Color Update (Guide) 1.12 17w06a 17w13a* 17w13b 17w14a 17w15a 17w16a 17w16b 17w17a 17w17b 17w18a* 17w18b pre1 pre2 pre3* pre4 pre5 pre6 pre7 1.12.1 17w31a pre1 1.12.2 pre1 pre2 1.13 Update Aquatic (Guide) 1.13 17w43a 17w43b 17w45a 17w45b 17w46a 17w47a 17w47b 17w48a 17w49a 17w49b 17w50a 18w01a 18w02a 18w03a 18w03b 18w05a 18w06a 18w07a 18w07b 18w07c 18w08a 18w08b 18w09a 18w10a 18w10b 18w10c 18w10d 18w11a 18w14a 18w14b 18w15a 18w16a 18w19a 18w19b 18w20a 18w20b 18w20c 18w21a 18w21b 18w22a 18w22b 18w22c pre1 pre2 pre3 pre4 pre5 pre6 pre7 pre8 pre9 pre10 1.13.1 18w30a 18w30b 18w31a 18w32a 18w33a pre1 pre2 1.13.2 pre1 pre2 1.14 Village & Pillage (Guide) 1.14 18w43a 18w43b 18w43c 18w44a 18w45a 18w46a 18w47a 18w47b 18w48a 18w48b 18w49a 18w50a 19w02a 19w03a 19w03b 19w03c 19w04a 19w04b 19w05a 19w06a 19w07a 19w08a 19w08b 19w09a 19w11a 19w11b 19w12a 19w12b 19w13a 19w13b* 19w14a 19w14b pre1 pre2 pre3 pre4 pre5 1.14.1 pre1 pre2 1.14.2 pre1 pre2 pre3 pre4* 1.14.3 pre1 pre2 pre3 pre4 1.14.4 pre1 pre2 pre3 pre4 pre5 pre6 pre7 1.15 Buzzy Bees (Guide) 1.15 19w34a 19w35a 19w36a 19w37a 19w38a 19w38b 19w39a 19w40a 19w41a 19w42a 19w44a 19w45a 19w45b 19w46a 19w46b pre1 pre2 pre3 pre4 pre5 pre6 pre7 1.15.1 pre1 1.15.2 pre1 pre2 1.16 Nether Update (Guide) 1.16* 20w06a 20w07a 20w08a 20w09a 20w10a 20w11a 20w12a 20w13a 20w13b 20w14a 20w15a 20w16a 20w17a 20w18a 20w19a 20w20a 20w20b 20w21a 20w22a pre1 pre2 pre3 pre4 pre5 pre6 pre7 pre8 rc1 1.16.1 1.16.2 20w27a 20w28a 20w29a 20w30a pre1 pre2 pre3 rc1 rc2 1.16.3 rc1 1.16.4 pre1 pre2 rc1 1.16.5 rc1* 1.17 Caves & Cliffs: Part I (Guide) 1.17 20w45a 20w46a 20w48a 20w49a 20w51a 21w03a 21w05a 21w05b 21w06a 21w07a 21w08a 21w08b 21w10a 21w11a 21w13a 21w14a 21w15a 21w16a 21w17a 21w18a 21w19a 21w20a pre1 pre2 pre3 pre4 pre5 rc1 rc2 1.17.1 pre1 pre2 pre3 rc1 rc2 1.18 Caves & Cliffs: Part II (Guide) 1.18 Experimental 1 2 3 4 5 6 7 21w37a 21w38a 21w39a 21w40a 21w41a 21w42a 21w43a 21w44a pre1 pre2 pre3 pre4 pre5 pre6 pre7 pre8 rc1 rc2 rc3 rc4 1.18.1 pre1 rc1 rc2 rc3 1.18.2 22w03a 22w05a 22w06a 22w07a pre1 pre2 pre3 rc1 1.19 The Wild Update (Guide) 1.19 Experimental 1 22w11a 22w12a 22w13a 22w14a 22w15a 22w16a 22w16b 22w17a 22w18a 22w19a pre1 pre2 pre3 pre4 pre5 rc1 rc2 1.19.1 22w24a pre1 rc1 pre2 pre3 pre4 pre5 pre6 rc2 rc3 1.19.2 rc1 rc2 1.19.3 22w42a 22w43a 22w44a 22w45a 22w46a pre1 pre2 pre3 rc1 rc2 rc3 1.19.4 23w03a 23w04a 23w05a 23w06a 23w07a pre1 pre2 pre3 pre4 rc1 rc2 rc3
Full Release (1.20+) Version history Development versions 1.20 Trails & Tales (Guide) 1.20 23w12a 23w13a 23w14a 23w16a 23w17a 23w18a pre1 pre2 pre3 pre4 pre5 pre6 pre7 rc1 1.20.1 rc1 1.20.2 23w31a 23w32a 23w33a 23w35a pre1 pre2 pre3 pre4 rc1 rc2 1.20.3 Bats and Pots (Guide) 1.20.3 23w40a 23w41a 23w42a 23w43a 23w43b 23w44a 23w45a 23w46a pre1 pre2 pre3 pre4 rc1 1.20.4 rc1 1.20.5 Armored Paws (Guide) 1.20.5 23w51a 23w51b 24w03a 24w03b 24w04a 24w05a 24w05b 24w06a 24w07a 24w09a 24w10a 24w11a 24w12a 24w13a 24w14a pre1 pre2 pre3 pre4 rc1 rc2 rc3 1.20.6 rc1 1.21 Tricky Trials (Guide) 1.21 24w18a 24w19a 24w19b 24w20a 24w21a 24w21b pre1 pre2 pre3 pre4 rc1 1.21.1 rc1 1.21.2 Bundles of Bravery (Guide) 1.21.2 24w33a 24w34a 24w35a 24w36a 24w37a 24w38a 24w39a 24w40a pre1 pre2 pre3 pre4 pre5 rc1 rc2 1.21.3 1.21.4 The Garden Awakens (Guide) 1.21.4 24w44a 24w45a 24w46a pre1 pre2 pre3 rc1 rc2 rc3 1.21.5 Spring to Life (Guide) 1.21.5 25w02a 25w03a 25w04a 25w05a 25w06a 25w07a 25w08a 25w09a 25w09b 25w10a pre1 pre2 pre3 rc1 rc2 1.21.6 Chase the Skies (Guide) 1.21.6 25w15a 25w16a 25w17a 25w18a 25w19a 25w20a 25w21a pre1 pre2 pre3 pre4 rc1 1.21.7 rc1 rc2 1.21.8 rc1 1.21.9 The Copper Age (Guide) 1.21.9 25w31a 25w32a 25w33a 25w34a 25w34b 25w35a 25w36a 25w36b 25w37a pre1 pre2 pre3 pre4 rc1 1.21.10 rc1 Mounts of Mayhem (Guide) 1.21.11 25w41a 25w42a 25w43a 25w44a 25w45a 25w46a pre1 pre2 pre3 pre4 pre5 rc1 rc2 rc3 Full Release (2026–present) Version history Development versions 26.1 26.1 snap1 snap2 snap3 snap4 snap5 snap6 * indicates a reupload