Java Edition 1.21.6 Pre-Release 1

{
 "title": "Minecraft 1.21.6 Pre-Release 1",
 "images": [
 "1.21.6-pre1.jpg",
 "Java Edition 1.21.6 Pre-Release 1.png"
 ],
 "rows": [
 {
 "field": "''(link to Java Edition article, displayed as Java Edition)''",
 "label": "(link to Edition article, displayed as Edition)"
 },
 {
 "field": "May 28, 2025",
 "label": "Release date"
 },
 {
 "field": "(link to Pre-release article, displayed as Pre-release)",
 "label": "(link to Version types article, displayed as Type)"
 },
 {
 "field": "(link to Java Edition 1.21.6 article, displayed as 1.21.6)",
 "label": "Pre-release for"
 },
 {
 "field": "[https://piston-data.mojang.com/v1/objects/d4eb1d0c95d32b74b5c0341453249e09806c544e/client.jar Client] ([https://piston-meta.mojang.com/v1/packages/722f25402ce4f1b6f6f56d75415d461a6e8aa421/1.21.6-pre1.json .json])<br />[https://piston-data.mojang.com/v1/objects/197f0896f6bafc45b7cd1c90b88f7979dfcc99fe/server.jar Server]",
 "label": "(link to Tutorial:Installing a version#Manual version installation article, displayed as Downloads)"
 },
 {
 "field": "[https://piston-data.mojang.com/v1/objects/8cdf340eb7c734dcc5b60af32534589217c3587c/client.txt Client]<br />[https://piston-data.mojang.com/v1/objects/4a630c21cd201b7d81f957923d0e6c30174534ad/server.txt Server]",
 "label": "(link to Obfuscation map article, displayed as Obfuscation maps)"
 },
 {
 "field": " <span style=\"font-size:smaller\"><abbr title=\"decimal\">dec</abbr>: </span>1073742076<br /> <span style=\"font-size:smaller\"><abbr title=\"hexadecimal\">hex</abbr>: </span>400000FC",
 "label": "(link to Protocol version article, displayed as Protocol version)"
 },
 {
 "field": "4430",
 "label": "(link to Data version article, displayed as Data version)"
 },
 {
 "field": "63",
 "label": "<span style=\"white-space: normal;\">(link to Pack format#List of pack formats article, displayed as Resource pack format)</span>"
 },
 {
 "field": "79",
 "label": "<span style=\"white-space: normal;\">(link to Pack format#List of pack formats article, displayed as Data pack format)</span>"
 },
 {
 "field": "<span class=\"plainlinks\">[https://en.wikipedia.org/wiki/Java_version_history#Java_SE_21_.28LTS.29 Java SE 21]</span>",
 "label": "<span style=\"white-space: normal;\">Minimum Java version</span>"
 }
 ],
 "invimages": [],
 "footer": "<table style=\"margin: auto; word-break: break-word;\">\n<tr style=\"background: inherit;\">\n<td style=\"padding: 0.4em\" >[[Java Edition 1.21.5|<span style=\"margin-right:-0.35em\">◄</span>◄  1.21.5]]</td>\n<td style=\"padding: 0.4em\">'''[[Java Edition 1.21.6|1.21.6]]'''</td>\n<td style=\"padding: 0.4em\" >[[Java Edition 1.21.7| 1.21.7 <span style=\"margin-right:-0.35em\">►</span>►]]</td>\n</tr>\n<tr style=\"background: inherit;\">\n<td style=\"padding: 0.4em\">\n[[Java Edition 25w21a|◄  25w21a]]\n</td>\n<td style=\"padding: 0.4em\">''' 1.21.6 Pre-Release 1'''</td>\n<td style=\"padding: 0.4em\">\n[[Java Edition 1.21.6 Pre-Release 2| 1.21.6 Pre-Release 2 ►]]\n</td>\n</tr>\n</table>"
}

1.21.6 Pre-Release 1 (known as 1.21.6-pre1 in the launcher) is the first pre-release for Java Edition 1.21.6, released on May 28, 2025.^[1]

Tags

• Added the #quick_actions dialog tag.
  • Dialogs to open when pressing quick actions.

Dried ghast

• The dried ghast now emits a vibration frequency of 11 from the sculk sensor when its block state changes.
• The ambient dried ghast sounds are now adjusted under the Blocks sound option instead of the Ambient/Environment option.

Carpet

• Shearing carpets for llamas now emits a vibration frequency of 6, while unequipping it emits a vibration frequency of 4 from the sculk sensor.

Saddle

• Shearing saddles now emits a vibration frequency of 6, while unequipping it emits a vibration frequency of 4 from the sculk sensor.

Horse armor

• Shearing horse armor now emits a vibration frequency of 6, while unequipping it emits a vibration frequency of 4 from the sculk sensor.

Happy ghast

• A player riding a happy ghast can no longer completely fly through a happy ghast ridden by another player.

Controls

• A new keybind called "Quick Actions" has been added to allow users to access a set of content-configured dialogs.
  • Default key:
  • This feature is configured by minecraft:quick_actions dialog tag.
    • If this tag is empty, the keybind does nothing.
    • If this tag has a single element, the keybind will open this dialog.
    • If this tag has multiple elements, the keybind will lead to minecraft:quick_actions dialog which (by default) lets user select one of the tag elements.
    • If this dialog is removed, the keybind does nothing.
  • This option is intended to be used in custom content and by servers, so this tag is empty by default.

Data pack

• The pack format version is now 79.
• The minecraft:custom click event has been expanded to carry full a NBT tag.

Dialogs

• Dialogs can now configure if they pause the game and if they close after an action is taken.
• Every dialog can now have inputs and can submit information.
  • The definition of actions has been changed to accommodate that.
  • The dedicated input dialog types have been removed, since they are redundant now.
  • The order of elements is:
    • Body
    • Inputs
    • Actions

• Common Dialog fields
  • New fields:
    • pause - if the dialog screen should pause the game in single-player mode, default: true.
    • after_action - an additional operation performed on the dialog after click or submit actions, default: close.
      • close - closes the dialog and returns to the previous non-dialog screen (if any).
      • none - does nothing, i.e. keeps the current dialog 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.
        • 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:multi_action, minecraft:server_links, minecraft:dialog_list
    • Replaced field on_cancel with exit_action, holding an optional action.
      • If exit_action is present, a button for it will appear in footer, otherwise the footer is not present.
      • exit_action is also used for the Escape action.
  • Removed minecraft:simple_input_form.
    • Since any dialog can now have inputs, this dialog can be replaced by minecraft:notice.
  • Removed minecraft:multi_action_input_form.
    • Since any dialog can now have inputs, this dialog can be replaced by minecraft:multi_action (without any specified exit_action).

• Input Control Types
  • minecraft:custom click event, all inputs will now return either a string or an NBT tag, depending on context.
  • minecraft:text
    • Output values:
      • As template substitution: contents without modification.
      • As tag: a string tag with contents without modification.
  • minecraft:boolean
    • Output values:
      • As template substitution: on_true when checked, on_false when unchecked.
      • As tag: 1b when checked, 0b when unchecked.
  • minecraft:number_range
    • Output values:
      • As template substitution: text representation of current value.
        • Whole numbers will be sent without decimal point.
      • As tag: a float tag with current value.

• Dialog Body Types
  • Hover and click events on text components within bodies now work as expected.
    • Click events are handled by the dialog screen like any other action - that means it will also run the after_action.

• Actions
  • The format of actions has been changed due to the merging of plain and input dialogs.
  • After every action the dialog will always evaluate the contents of the after_action field (see above).
  • Fields:
    • Kept fields: label, tooltip, width
      • New field: action (replaces on_click and on_submit) - an action to perform when button is clicked, optional object with fields:
      • <type-specific> - see below, depends on type

• Action Types
  • Static Dialog
    • 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, entry for action button will look like:

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

• • minecraft:dynamic/run_command
    • This action will build a run_command event using a provided macro template.
    • The macro will be expanded with string values from all inputs.
      • For example, if the macro template is some_command $(some_input), the string value from the input with key of some_input will be used for the template expansion.
      • Inputs not used in macro will be ignored, while macro parameters not matching any inputs will be replaced with an empty string.
    • Fields:
      • template - a string with a macro template to be interpreted as a command.
  • minecraft:dynamic/custom
    • This method will build a minecraft:custom event using all input values.
    • All input contents will be sent together inside a compound tag, with tag value of each input put under id from key field of that input.
    • Additional static fields can be added to payload.
    • Fields:
      • additions - fields to be added to payload, optional compound tag.
      • id - namespaced ID.

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 it is meant to be replaced 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 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 profile from 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.

Resource pack

• The version is now 63.
• Added oversized_in_gui item model field.
• Introduced new player head special model type.Minecraft.

26 issues fixed

From released versions before 1.21

• MC-94800 – URL shown in open URL dialog is not shortened.
• MC-140819 – Lectern model extends past inventory slot.
• MC-200092 – /setworldspawn seems to ignore the 'angle' parameter.
• MC-272825 – Custom filled maps from 23w31a and earlier do not upgrade properly in later versions.

From 1.21.5

• MC-280276 – Some item models can still clip into the block below when hovering on the ground.
• 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.

From the 1.21.6 development versions

• MC-296420 – '/datapack create' can create directories with illegal names.
• MC-296431 – Clipping item sprites to stay in slot makes it impossible to hide the slot for resource packs.
• MC-296458 – Player heads in the inventory don't show the right skin.
• MC-297275 – Players can desync from their mounts when jumping on a happy ghast.
• MC-297550 – Happy ghasts don’t remain stationary correctly when players dismount them while other players are still controlling them.
• MC-297807 – Clicking "Save and Quit to Title" in the dialog warning menu takes you to the server list even if the world is singleplayer or locally-hosted LAN.
• MC-297817 – Newly placed paintings sometimes appear at a different position.
• MC-297848 – The menu background is not shown for a short amount of time when leaving a world from a dialog.
• MC-297897 – Players can fall through happy ghasts.
• MC-297899 – FPS drops due to clouds.
• MC-297906 – Running a command with a large output whilst on a dedicated server causes a kick and no logged output.
• MC-297915 – The name plates of entities with an empty custom name are now rendered incorrectly.
• MC-298071 – All naturally spawned zombie villagers are professionless since 25w16a.

From the previous development version

• MC-298101 – Sniffers now show the digging animation instead of the walking animation.
• MC-298116 – The warning text in the confirm link screen is no longer visible.
• MC-298117 – All buttons at the bottom of the Realms screen are clickable when no realm is selected.
• MC-298139 – Items bigger than the size of a slot incorrectly bleed over onto other items.
• MC-298146 – GUI items disappear at high screen resolutions.