Minecraft:Java Edition 25w20a

Template:Infobox version

25w20a is the sixth Minecraft:snapshot for Minecraft:Java Edition 1.21.6, released on May 13, 2025.<ref>Template:Snap</ref>

Additions

Items

Minecraft:Music disc

width=32x32 Added the "Tears" music disc by Minecraft:Amos Roddy.
- Obtained by killing a ghast with a Minecraft:fireball deflected by a player.
- Has a Minecraft:comparator output of 10 when played in a Minecraft:jukebox.

Command format

Template:Cmd

A new command that shows dialog to clients.
Syntax:
- Template:Cmd
  - Show dialog to player(s).
  - Template:Cd - player name, UUID or a player selector.
  - Template:Cd - a namespaced ID from Template:Cd registry or inline dialog value as described above.
  - Returns number of players in targets argument.
- Template:Cmd
  - Clean dialog for player(s), if they have any visible.
  - Template:Cd - player name, UUID or a player selector.
  - Returns number of players in targets argument.

Gameplay

Minecraft:Music

Added 5 new background music tracks by Minecraft:Amos Roddy to Minecraft:cherry groves, Minecraft:forest, Minecraft:desert, Minecraft:grove, and Minecraft:lush caves biomes:
- "Minecraft:Below and Above"
- "Minecraft:Broken Clocks"
- "Fireflies"
- "Lilypad"
- "Minecraft:O's Piano"
The same songs have been added to the Minecraft:menu screen music rotation.

General

Minecraft:Dialogs

Added a way to display simple modal dialogs to a user.
Dialogs are stored in a Template:Cd 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 dialog that explains to user that this screen is provided by custom content.
- It also gives user an option to leave current world to avoid them being locked in infinite loop of dialogs.
Dialogs can be displayed by server in Template:Cd and Template:Cd connection phases.
- However, only inline registries are allowed in Template:Cd, since registries are not yet available in that phase.
Dialogs always close after user selects any action.
Dialogs by default will also close after Template:Key key is pressed.
- When this happens, dialog will run action specific to dialog type described as "exit action" below.
- This behavior is configurable.
When dialog screen is closed, game goes back to previously displayed non-dialog screen or back to gameplay.
- That means that new dialogs always replace already opened ones, if any.
Dialogs screens will pause the game in singleplayer mode.
Dialogs can be configured to be accessible from Pause menu.
- This replaces and expands "Server Links" button added in previous versions.
Most dialogs follow a common layout, however exact contents depend on type:
- Header with title and warning button.
- Body elements (labels, inputs, buttons and submit actions), scrollable if needed.
- Optional footer, contains main buttons and submit actions.

Minecraft:Dialog Description Format

Dialogs are stored in Template:Cd registry that can be provided by a datapack
- Fields:
  - Template:Cd - one of dialog types from minecraft:dialog_type registry
  - Template:Cd - see below.
Common dialog fields
- Most dialog types share some fields.
- Fields:
  - Template:Cd
    - Screen title, text component.
      - Should be always visible on screen, no matter the specific type.
  - Template:Cd
    - Name to be used for a button leading to this dialog (for example from pause screen), optional text component.
      - If not present, Template:Cd will be used instead.
  - Template:Cd
    - Optional list of body elements or a single element.
  - Template:Cd
    - Can dialog be dismissed with Template:Key key, default Template:Cd.
Common button data
- Most actions in dialog types share following fields that describe appearance of a button associated with that action:
  - Template:Cd- text component.
  - Template:Cd - optional text component to display when button is highlighted or hovered over.
  - Template:Cd - width of the button, positive integer with default Template:Cd.
Click action
- Common object used in dialogs to represent clickable action on a dialog.
  - Fields:
    - Common button data.
    - Template:Cd - optional click event (same format as Template:Cd on text components).
      - If not present, clicking button will simply close screen without any action.
Dialog types
- Template:Cd
  - A simple screen with one action in footer.
  - Exit action: same as Template:Cd.
  - Fields:
    - Common dialog fields
    - Template:Cd - click action, defaults to button with Template:Cd label and no action or tooltip.
- Template:Cd
  - A simple screen with two actions in footer.
  - Exit action: same as Template:Cd action.
  - Fields:
    - Common dialog fields
    - Template:Cd - click action for positive outcome.
    - Template:Cd - click action for negative outcome.
- Template:Cd
  - A scrollable list of actions arranged in columns.
  - Screen also has button in footer that runs exit action and closes the screen.
    - Label will be Template:Cd if dialog has defined exit action and Template:Cd if it has no side effects.
  - Exit action: defined in Template:Cd field.
  - Fields:
    - Common dialog fields
    - Template:Cd - non-empty list of click actions.
    - Template:Cd - optional click event (same format as Template:Cd on text components).
    - Template:Cd - positive integer describing number of columns, default: Template:Cd.
- Template:Cd
  - A scrollable list of links received from server in Template:Cd packet, arranged in columns.
  - Screen also has button in footer that runs exit action and closes the screen.
    - Label will be Template:Cd if dialog has defined exit action and Template:Cd if it has no side effects.
  - Note: this is a replacement for previous "Server Links" screen, but now with an additional body.
  - Exit action: defined in Template:Cd field.
  - Fields:
    - Common dialog fields.
    - Template:Cd - optional click event (same format as Template:Cd on text components).
    - Template:Cd - positive integer describing number of columns, default: Template:Cd.
    - Template:Cd - width of buttons in the list, positive integer with default Template:Cd.
- Template:Cd
  - A scrollable list of buttons leading directly to other dialogs, arranged in columns.
    - Titles of those buttons will be taken from Template:Cd fields of targeted dialogs.
  - Screen also has button in footer that runs exit action and closes the screen.
    - Label will be Template:Cd if dialog has defined exit action and Template:Cd if it has no side effects.
  - Exit action: defined in Template:Cd field.
  - Fields:
    - Common dialog fields.
    - Template:Cd - dialog, a list of dialogs or a dialog tag.
    - Template:Cd - optional click event (same format as Template:Cd on text components).
    - Template:Cd - positive integer describing number of columns, default: Template:Cd.
    - Template:Cd - width of buttons in the list, positive integer with default Template:Cd.
- Template:Cd
  - A screen that accepts user inputs.
  - Has a single submit action with in a footer.
  - Exit action: none (submitting data closes screen, but does not run any action outside of sending data to server).
  - Fields:
    - Common dialog fields
    - Template:Cd - non-empty list of inputs controls.
    - Template:Cd - submit action.
- Template:Cd
  - A screen that accepts user inputs.
  - Can have multiple submit actions.
  - Has no footer, submit actions are appended to a body.
  - Exit action: none (submitting data closes screen, but does not run any action outside of sending data to server).
  - Fields:
    - Common dialog fields.
    - Template:Cd - non-empty list of inputs controls.
    - Template:Cd - non-empty list of submit actions.
Dialog body types
- All dialogs have a list of body elements describing contents between title and actions or inputs.
- Fields:
  - Template:Cd - one of dialog body types from Template:Cd registry.
  - Template:Cd - see below.
- Template:Cd
  - A multiline label.
  - Fields:
    - Template:Cd - text component.
    - Template:Cd - maximum width of message, positive integer with default Template:Cd.
- Template:Cd
  - Item with optional description.
    - If description is present, it will be rendered to the right of item.
  - Item will be rendered as if it was in inventory slot.
  - Item is not scaled even if Template:Cd and Template:Cd are set to values other than default.
  - Fields:
    - Template:Cd - item stack with count.
    - Template:Cd - optional object with fields:
      - Template:Cd - text component.
      - Template:Cd - maximum width of contents, positive integer with default Template:Cd.
      - Can also be just be text component.
    - Template:Cd - if Template:Cd, count and damage bar will be rendered over the item, default: Template:Cd.
    - Template:Cd - if Template:Cd, item tooltip will show up when item is hovered, default: Template:Cd.
    - Template:Cd - horizontal size of element, default: Template:Cd.
    - Template:Cd - vertical size of element, default: Template:Cd.
Input control types
- Input dialog uses a set of controls to accept user input.
- When submitted, current value of input will be converted to a string and sent to the server as described by submit action section below.
- Fields:
  - Template:Cd - one of input control types from Template:Cd registry.
  - Template:Cd - string identifier of value used when submitting data, must be a valid template argument (letters, digits and Template:Cd).
  - Template:Cd - see below.
- Template:Cd.
  - Simple text input.
  - Sends current contents without modification.
  - Fields:
    - Template:Cd - width of input, positive integer with default: Template:Cd.
    - Template:Cd - a text component to be displayed to the left of control.
    - Template:Cd - controls label visibility, default: Template:Cd.
    - Template:Cd - initial contents, default: Template:Cd (empty).
- Template:Cd
  - A plain checkbox with a label.
  - Fields:
    - Template:Cd - a text component to be displayed to the right of control.
    - Template:Cd - an initial value, default: Template:Cd (i.e. unchecked).
    - Template:Cd - a string value to send when control is checked, default: Template:Cd.
    - Template:Cd - a string value to send when control is unchecked, default: Template:Cd.
- Template:Cd
  - A button that cycles between a set of options when clicked.
  - Sends value associated with currently selected preset.
  - Fields:
    - Template:Cd - a text component to be displayed on the button.
    - Template:Cd - if true, label will be incorporated into button text, default: Template:Cd.
    - Template:Cd - width of button, positive integer with default: Template:Cd.
    - Template:Cd - a list of objects with fields:
      - Template:Cd - a string value to send on submit.
      - Template:Cd - a text component to display on button, optional (if not present, id is used).
      - Template:Cd - an optional boolean flag that selects initial option (only one option can have it set to true).
      - Additionally list might also contain plain string - in that case it's equivalent to a single entry with field Template:Cd set to that string and other fields set to default.
- Template:Cd
  - A slider for picking a numeric value out of some range.
  - Sends currently selected value.
    - Whole numbers will be sent without decimal point.
  - Fields:
    - Template:Cd - a text component to be used as a slider label.
    - Template:Cd - a translation key to be used for building label (first argument is contents of Template:Cd field, second argument is current value), default: Template:Cd.
    - Template:Cd - width of input, positive integer with default: Template:Cd.
    - Template:Cd - start value (when slider is in leftmost position) (inclusive), float.
    - Template:Cd - end value (when slider is in rightmost position) (inclusive), float.
    - Template:Cd - number of increments, positive integer.
      - Note: value of Template:Cd means that slider will have two positions (start and end).
    - Template:Cd - initial value of slider, rounded down nearest step, must be within range, defaults to Template:Cd.
Submit actions
- Every submit action on input dialog has a button associated with it.
- When one of those buttons is clicked, values of all inputs will be collected and sent to a server using one of methods described below.
- Template:Cd field of a submit action will be included as an input with key Template:Cd.
- Submit action fields:
  - Common button data.
  - Template:Cd - string identifier of an action.
  - Template:Cd - submit method to run when button is clicked, object with following fields:
    - Template:Cd - one of submit method types from Template:Cd registry.
    - Template:Cd - see below.
  - Note: server does not validate individual values as they arrive as filled commands or custom payloads.
Submit method types
- Template:Cd
  - This method will build a command using a provided macro template and request the server to run it (same as Template:Cd click event).
  - If the command requires permission higher than Template:Cd (when any operator permissions are required), a confirmation dialog will be shown.
  - Macro will be expanded with values from input.
    - For example, if macro is Template:Cd will be expanded to Template:Cd field of a submit action.
    - Inputs not used in macro will be ignored, while macro parameters not matching any inputs will be replaced with an empty string.
  - Fields:
    - Template:Cd - a string with a macro template to be interpreted as a command.
- Template:Cd
  - This method will build a custom server click action using a provided macro template and send it to the server (same as Template:Cd click event).
  - Macro will be expanded with values from input.
    - Inputs not used in macro will be ignored, while macro parameters not matching any inputs will be replaced with an empty string.
  - Fields:
    - Template:Cd - a string with a macro template to be used as a payload.
    - Template:Cd - namespaced ID.
- Template:Cd
  - This method will build a custom server click action from all values and request the server to run it (same as Template:Cd click event).
  - Format:
    - keys are separated from values with horizontal tabulation (Template:Cd) character.
    - key-value entries are separated with line feed (Template:Cd) character.
    - If characters Template:Cd and Template:Cd are present in any key or value, they will be escaped to Template:Cd and Template:Cd.
  - Fields:
    - Template:Cd - namespaced ID.
Built-in dialogs
- The built-in datapack contains some custom dialogs to provide customization of specific screens used by client.
- Template:Cd
  - Replacement for previously existing "Server Links" screen.
  - Meant to simplify migration for servers that used this feature previously.
- Template:Cd
  - Shows contents of Template:Cd tag (see below).
  - Lets user 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 to not hide other dialog providers.

Minecraft:Tags

Added the Template:Cd dialog tag.
- Dialogs in this tag replaces the "Report Bugs" button or the "Server Links" button on the pause screen.

Changes

Blocks

Minecraft:Dried ghast

No longer breaks if water flows into it.

Items

Minecraft:Leather

Can now be found in Minecraft:monster room, Minecraft:ancient city, Minecraft:desert temple, Minecraft:jungle temple and Minecraft:stronghold altar chests in quantities 1-5.

Minecraft:Saddle

Can be removed from mobs wearing them by Template:Ctrl Minecraft:shears on the mob.
- Cannot be removed this way from Minecraft:ravagers or mobs with riders.
- Shears in a dispenser don't work.
Saddles can now be crafted with 3 Minecraft:leather and 1 Minecraft:iron ingot.
- The recipe unlocks when a player picks up their first leather.

Template:Crafting

No longer found in chests in Minecraft:monster rooms, Minecraft:ancient cities, Minecraft:desert temples, Minecraft:jungle temples and in Minecraft:stronghold altar chests.

Minecraft:Shears

Can now remove Minecraft:saddles, Minecraft:horse armor, Minecraft:harnesses and Minecraft:carpets from mobs.
- They cannot be removed if the mob has a rider.
- They cannot be removed if the player is crouching.
Saddles cannot be removed from ravagers.
Dispensers with shears cannot remove saddles, horse armor, harnesses and carpets equipped on mobs.

Mobs

Minecraft:Ghast

Now drop a ”Tears” music disc when killed by a player-deflected Minecraft:fireball.

Gameplay

Minecraft:Fog

Fog is now applied to 3d HUD elements such as first person player hands and items in hands.
Rain and thunder weather is somewhat less foggy now.
Rain fog affects interiors less.

Minecraft:Music

Music now plays even when the game is paused.
Added an option to the Music & Sound settings, "Music Frequency", that allows players to change how frequently music plays while in a game world.
- Settings are Default, Frequent and Constant.
- Default is the normal delay between 10 - 20 minutes
- Frequent halves the delay to 10 minutes and Constant sets the delay to 5 seconds.
Added an option to the Music & Sound settings, "Show Music Toast", that enables a music toast to be shown whenever a song starts playing.
- With this option enabled, the song that is currently playing will be seen at all times in the top left corner of the in-game Minecraft:pause menu.
- Default setting is Off.

General

Minecraft:Attributes

Template:Cd
- Ghasts now have a Template:Cd attribute that affects their flying speed.

Minecraft:Credits

The credits have been updated.

Minecraft:Data component format

Template:Cd
- Added new optional field: Template:Cd (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 new optional field: Template:Cd (sound event).
  - It's a sound event that plays when the equippable item is sheared.
  - If not specified, it defaults to the Template:Cd sound event.

Minecraft:Data pack

The Minecraft:pack format version is now Template:Cd.
"Command Syntax" report now contains information about required permission level.
Users will now be prompted for confirmation before executing a command from the Template:Cd click action in books and chat if the command can't be parsed or requires elevated permissions (i.e. higher than 0).

Minecraft:Panorama

Updated the panorama to show a scene with happy ghasts flying next to a mountain side.

Minecraft:Pause menu

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

Minecraft:Realms

Added the Realms logo to the Realms loading screens.
Added region information when connecting to a Realm.

Minecraft:Resource pack

The version is now Template:Cd.

Minecraft:Splash

Removed "Minors welcome!"
Changed "Pumpa kungen!" to "Pumpakungen!"
Changed "10 years of Mining and Crafting!" to "15 years of Mining and Crafting!"
5 splashes are added:
- "Music by Aaron Cherof!"
- "Music by Kumi Tanioka!"
- "Music by Amos Roddy!"
- "Flint and Steel!"
- "Chicken Jockey!"

Minecraft:Text component format

Click Events
- New click action Template:Cd has been added.
  - When user clicks a component with this click action, client will send a dedicated packet Template:Cd 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:
    - Template:Cd - namespaced ID.
    - Template:Cd - optional string field.

Dialog Click Event
- New action Template:Cd has been added.
  - When user clicks this component, a dialog will be opened for them.
  - Fields:
    - Template:Cd - a namespaced ID from Template:Cd registry or inline dialog value as described above.

UI sprites

Added Template:Samp and Template:Samp sprites.

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.

Template:Fixes

Videos

Template:Slicedlime

Trivia

This version was released 16 years after the Cave Game Tech Test showcase.

References

Template:Reflist

Navigation

Template:Navbox Java Edition versions

Minecraft:de:25w20a Minecraft:es:Java Edition 25w20a Minecraft:fr:Édition Java 25w20a Minecraft:ja:Java Edition 25w20a Minecraft:pt:Edição Java 25w20a Minecraft:ru:25w20a (Java Edition) Minecraft:uk:25w20a (Java Edition) Minecraft:zh:Java版25w20a