Minecraft:Java Edition 25w03a

25w03a is the second Minecraft:snapshot for Minecraft:Java Edition 1.21.5 released on January 15, 2025,<ref>Template:Snap</ref> which adds Minecraft:test block, Minecraft:test instance block, and fixes bugs.

Additions

Blocks

Template:Animate Minecraft:Test block

• A technical block used in game test.
• Can be obtained by Template:Cmd, Template:Cmd, or Template:Cmd commands, or through the Minecraft:Operator Items Tab.
• The test block is a block used for implementing block-based tests. It has four modes:
  • Template:Cd: Triggers a redstone pulse when the test starts
  • Template:Cd: Logs a message to the server log file when powered by redstone (prints twice, due to a bug<ref name="youtube-6elLSg0y7X4">Template:Citation</ref>)
  • Template:Cd: Fails the test when powered by redstone
  • Template:Cd: Completes the test when powered by redstone
• Block-based tests are required to have at least one start block and one accept block in the structure.

File:Test Instance Block JE1.png Minecraft:Test instance block

• A technical block used in game test.
• Can be obtained by Template:Cmd, Template:Cmd, or Template:Cmd commands, or through the Minecraft:Operator Items Tab.
• To run a test in a world, a test instance block is used. This type of block represents the test as placed in the world and is used to interact with that test, to save the structure, reset or run the test.
• Using the Template:Cmd command to run or create a test will also place a test instance block to control that test.

Command format

Template:Cmd

• A new command used to create and run tests.
  • Syntax:
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
    • Template:Cmd
  • Parameters:
    • Template:Cd:
      • The radius to clear tests within.
    • Template:Cd:
      • The namespaced ID of a test.
    • Template:Cd:
      • A wildcard-enabled selector for test IDs
      • Supports * and ? for matching namespaced IDs
      • If namespace is not supplied, defaults to minecraft
      • Examples:
        • Template:Cd
          • Matches all IDs
        • Template:Cd
          • Matches everything in the minecraft namespace
        • Template:Cd
          • Matches IDs in the folder folder of the custom namespace, with a prefix followed by _test_ followed by a single valid character
    • Template:Cd:
      • The width of the test structure.
        • If omitted, Template:Cd is used.
    • Template:Cd:
      • The height of the test structure .
        • If omitted, the Template:Cd is used.
    • Template:Cd:
      • The depth of the test structure.
        • If omitted, the Template:Cd is used.
    • Template:Cd:
      • The variable name to include in the copied code snippet.
    • Template:Cd:
      • The number of times to repeat each test.
        • If omitted, Template:Cd is used.
    • Template:Cd:
      • Boolean (default false) noting that the test should be stopped as soon as one iteration fails.
    • Template:Cd:
      • Number of extra 90 degree steps to apply to the test.
        • If omitted, Template:Cd is used.
    • Template:Cd:
      • Number of tests to place per row in a grid layout.
        • If omitted, Template:Cd is used.
• Template:Cmd
  • These subcommands clear the structures and blocks associated with the selected tests.
• Template:Cmd
  • This subcommand creates a test setup in the current location for the given test, preparing for a structure of the given size.
  • This gives a starting point for creating the structure for the test.
• Template:Cmd
  • Attempts to locate the given test.
    • Note that only loaded chunks are searched.
• Template:Cmd
  • These subcommands reset the structures for the selected tests, removing any surrounding barriers and placing the structure in from scatch.
• Template:Cmd
  • Shows the local coordinates to the block pointed at in the test.
  • If the optional variable name is specified, this variable name is used in a code fragment obtained by clicking on the coordinates in the output message.
• Template:Cmd
  • Runs one or more tests.
    • If multiple tests are run at once, they are placed in a grid and run in parallel, although only up to a certain limit. Beyond that limit, tests are run in rounds where each round completes before any tests from the next round are started.
    • For each test, loads the given structure and runs the associated test. Each test location will have a beacon beam showcasing the test status.
      • Gray beacon = in progress
      • Red = fail (required test)
      • Orange = fail (optional test)
      • Green = success
    • If a test fails, the error is shown on a lectern book and an overlay.
• Template:Cmd
  • Stops all running tests.
    • Note that gameplay events triggered by tests may still remain.
• Template:Cmd
  • Verifies one or more tests by running multiple instances of the same test.

General

Minecraft:Block-based tests

• Use Minecraft:test blocks in the test structure to run the test and indicate success or failure.

Minecraft:Function tests

• Rely on built-in functions to run a test and indicate success or failure.
  • They have one additional field:
    • Template:Cd:
      • The namespaced ID of the Test Function to run.

Minecraft:Game tests

• The Game Tests system is a new integrated system for testing aspects of the game.
• Each test is an asset defining some parameters for how the test gets executed, combined with a saved structure file containing a base setup.
• Generally, the test framework expects to run tests in a separate superflat world.

Minecraft:Items model definition

• Select Property
  • Template:Cd
    • New data source has been added to select item model: Template:Cd.
    • Returns value of component on item, if any.
    • Fields:
      • Template:Cd - namespaced ID of component type.
    • Possible values: depends on component type.

Minecraft:Tags

• Added the Template:Cd entity tag.
  • Contains entities that can be equipped with a saddle.
  • This does not mean that the Saddle will function, just that it can be equipped into the saddle slot.

Test environments

• Test Environments are a way to group up tests and give them the right preconditions to run.
• A test environment is an asset in the Template:Cd registry.
• Each test environment definition has a Template:Cd field that determines its setup:
  • Template:Cd definitions
    • Apply the setup from several sub-definitions in the Template:Cd field.
  • Template:Cd definitions
    • Use mcfunction files as setup and teardown.
    • Template:Cd:
      • Optional namespaced ID of the mcfunction to use for setup, if any.
    • Template:Cd:
      • Optional namespaced ID of the mcfunction to use for teardown, if any.
  • Template:Cd: definitions
    • Set any number of game rules.
    • Template:Cd:
      • A list of boolean game rules to set and the value to set.
    • Template:Cd:
      • A list of integer game rules to set and the value to set.
    • Each rule is an object with two fields:
      • Template:Cd:
        • The exact name of the rule to set.
      • Template:Cd:
        • The value to set
    • Game rules are reset to their default values after the test environment has completed.
  • Template:Cd definitions (not working in this snapshot<ref name="youtube-6elLSg0y7X4" />)
    • Sets the weather state
    • Template:Cd:
      • The weather to set.
      • One of Template:Cd, Template:Cd and Template:Cd.
  • Template:Cd definitions
    • Set a given time of day.
    • Template:Cd:
      • The time of day to set in number of ticks, as a non-negative integer.
• The game provides a single, empty test environment by default: Template:Cd.

Test instances

• Test instances are defined in the registry Template:Cd.
  • They're small assets defining a test to run.
  • Fields:
    • Template:Cd (wrongly called Template:Cd in the changelog<ref name="youtube-6elLSg0y7X4" />):
      • Namespaced ID of the test environment to run this test as part of.
    • Template:Cd:
      • Namespaced ID of the structure to use for the test.
    • Template:Cd:
      • A positive integer representing the maximum number of ticks allowed to pass before the test is considered timed out.
    • Template:Cd:
      • Optional non-negative integer.
      • Default: Template:Cd
      • Represents a number of ticks to wait after placing the structure before starting the test.
    • Template:Cd:
      • Optional boolean.
      • Default Template:Cd
      • Whether the test is considered required to pass for the full test suite to pass.
    • Template:Cd:
      • Optional rotation to apply to the test structure.
      • One of Template:Cd (default), Template:Cd, Template:Cd and Template:Cd.
    • Template:Cd:
      • Optional boolean.
      • Default Template:Cd
      • Set to Template:Cd for tests that are not included as part of automated test runs.
    • Template:Cd:
      • Whether the test needs clear access to the sky.
      • Default: Template:Cd
      • Tests are enclosed in barrier blocks.
      • If set to Template:Cd, the top is left open.
    • Template:Cd:
      • Number of attempts to run the test.
      • Default: Template:Cd
    • Template:Cd:
      • Number of attempts that must succeed for the test to be considered successful .
      • Default: Template:Cd
    • Template:Cd:
      • The type of test.
      • One of Template:Cd and Template:Cd.

Changes

Blocks

Minecraft:Leaf litter

• Can be used in a Minecraft:composter.

Items

Minecraft:Saddle

• Saddles equipped onto Minecraft:pigs or Minecraft:striders will now maintain properties such as custom name when dropped.
• Saddles equipped onto Minecraft:camels and equines (Minecraft:horses, Minecraft:donkeys, Minecraft:mules) now remain visible if the mob equipped with them is inflicted with Minecraft:Invisibility.
• Saddles equipped onto camels and equines no longer turn red when the mob wearing it takes damage.
• When enchanted now show the Minecraft:enchantment glint on mobs wearing it.
• Minecraft:Thorns and Minecraft:Curse of Binding enchantments now work on mobs that are wearing it.

Command format

Item slots

• The Template:Cd item slot has been renamed to Template:Cd, and now supports any entity that can equip a Saddle.
  • Driven by the Template:Cd component.
  • Only mobs that normally support saddles will support riding and rendering of the saddle.
  • Items in the Template:Cd slot can apply attribute modifiers as with other equipment.

Gameplay

Minecraft:End portal and Minecraft:exit portal

• When changing state, any blocks that are in its radius will be dropped as items and also make breaking sounds, rather than outright overwritten.<ref>Template:Citation</ref>

General

Minecraft:Data component format

• Template:Cd component
  • Template:Cd field was renamed to Template:Cd

• Template:Cd component
  • Can now apply to saddle slot.
  • Any mob can now have equipment added in the Template:Cd slot as long as the component allows it (Template:Cd).
  • Added new optional field: Template:Cd (boolean).
    • If Template:Cd, players can equip this item onto a target mob by right-clicking it (as long as this item can be equipped on the target at all).
    • The item will not be equipped if the target already has an item in the relevant slot.
    • If not specified, defaults to Template:Cd.

Minecraft:Data pack

• The Minecraft:pack format version is now Template:Cd.

Minecraft:Entity format

• The Template:Cd, Template:Cd, and Template:Cd fields have been merged into an Template:Cd field.
  • Format:
    • Map between equipment slot type and item stack.
      • Valid equipment slots: Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd.
    • If not specified or removed, the entity will have no equipment.
    • e.g. Template:Cd}}.
    • This affects all mobs and armor stands, but players are unaffected.
  • The data format of saddles has been unified between mobs such as horses and pigs, becoming a new kind of equipment slot (and stored in the Template:Cd field)
    • This also replaces the boolean Template:Cd flag from pigs and striders.
    • The Saddle dropping on death is now affected by the Template:Cd field, as with other equipment slots.
  • The Template:Cd field has been changed from float to double and is now called Template:Cd.

Entity variant components

• Entities now have a set of components for configuring variants and other aspects of apperance.
• If those components are present on spawning item (like spawn eggs, mob buckets, minecraft:painting, minecraft:item_frame), they will be applied to new entity
• Components are currently not restored when spawn egg is picked from existing entity
• Added components:
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - namespaced id from Template:Cd registry
  • Template:Cd - one of 16 dye colors
  • Template:Cd - one of Template:Cd, Template:Cd
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - one of 16 dye colors
  • Template:Cd - one of 16 dye colors
  • Template:Cd - one of Template:Cd, Template:Cd
  • Template:Cd - one of brown, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - namespaced id from Template:Cd registry
  • Template:Cd - namespaced id from Template:Cd registry
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - namespaced id from Template:Cd registry
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - one of Template:Cd, Template:Cd, Template:Cd, Template:Cd, Template:Cd
  • Template:Cd - namespaced id from Template:Cd registry
  • Template:Cd - one of 16 dye colors
  • Template:Cd - one of 16 dye colors
  • Template:Cd - one of 16 dye colors
• Mob buckets and paintings available in creative menu will now use new variants instead of Template:Cd component.
• Custom tooltips for Minecraft:bucket of tropical fish and Minecraft:painting items are now based on new components instead of Template:Cd and Template:Cd.

Equipment assets

• Equipment assets may now define new layer types:
  • Template:Cd - equipment layer for Pig saddles
  • Template:Cd - equipment layer for Strider saddles
  • Template:Cd - equipment layer for Camel saddles
  • Template:Cd - equipment layer for Horse saddles
  • Template:Cd - equipment layer for Donkey saddles
  • Template:Cd - equipment layer for Mule saddles
  • Template:Cd - equipment layer for Skeleton Horse saddles
  • Template:Cd - equipment layer for Zombie Horse saddles
• The following textures have been moved to support the use of equipment assets for saddles:
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd
• The following textures have been split from their base entity texture to support the use of equipment assets for saddles:
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd
  • Template:Cd -> Template:Cd

Minecraft:Predicates

• Entity predicates
  • A new optional field was added to entity predicate: Template:Cd.
    • When present, predicate will match contents of entity components.
    • Format:
      • Map of component type key to matching component values.
  • The following entity sub-predicates have been removed and replaced with combination of Template:Cd predicate and variant entity components:
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
    • Template:Cd
  • The field Template:Cd has been removed from Template:Cd sub-predicate.

Minecraft:Resource pack

• The Minecraft:pack format version is now Template:Cd.
• Added new equipment asset layer type for Pigs and Striders, and moved saddle textures.
• Changed the size of Template:Cd texture.

Minecraft:Server.jar

• Added the entry point Template:Cd.
  • Automatically starts a server, runs all available game tests and then exits.
  • Options:
    • Template:Cd - Shows usage information
    • Template:Cd - Set a folder of datapacks to include in the world
      • Any zip file or folder with a Template:Cd file is included
    • Template:Cd - Exports results in a junit-like XML report at the given path
    • Template:Cd - Specify which tests to run with a selection - a wildcard expression matching namespace test instance IDs
      • If omitted, or used with an empty ID, runs all tests
    • Template:Cd - The path to where the test server world will be created
      • Any existing folder will be replaced
      • Default: Template:Cd
    • Template:Cd - Enables test verification
      • Runs the tests specified with Template:Cd or Template:Cd 100 times for each 90 degree rotation step
      • Default: Template:Cd
  • Example usage: Template:Cd

Minecraft:Tags

• Added Template:Cd to the Template:Cd block tag.
• Fixed the Template:Cd, and Template:Cd biome tags to contain all required biomes.

Minecraft:Text component format

• Hover Events
  • Template:Cd action:
    • The Template:Cd field has been renamed to Template:Cd.