As the year draws to a close, we gather in the shipping room one more time to press the buttons that make snapshots happen! In this final release of 2025 we’re (among other things) upgrading our runtime version of Java, giving villager trades the data-driven treatment, and adding a new swing command that swings the arms of entities. Finally, all our builds will now be unobfuscated moving forward.<\/p>\n
Did we miss something? Oh, yeah! This snapshot marks the beginning of our new version numbering system for Minecraft on Java Edition. We’ll see you next year for more snapshots and the eventual release of what will be Java Edition 26.1!<\/p>\n
Happy mining!<\/p>\n
Changes<\/p>\n
What trades are unlocked by villager professions are now determined using deterministic random sequences, like loot drops and barter loot
\nThe algorithm that maps block and sky light levels to how bright things appear on screen has been fully rewritten
\nA new lightmap debug renderer was introduced, which can be enabled using the F3 + 4 keybind<\/p>\n
Lightmap Algorithm Changes<\/p>\n
The new algorithm is supposed to mostly provide the same overall results as before, but:
\nIt is simpler and more straightforward, and fixes multiple issues of the previous one, as listed in the Fixed Bugs section below
\nThe Darkness effect and world darkening effect of the Wither fight now works the same way in all dimensions
\nThe Night Vision effect now simply adds ambient light instead of scaling the resulting colors
\nIt means that fully dark areas no longer look brighter than areas lit by block or sky light<\/p>\n
More aspects of the algorithm such as block light tint, ambient light color and night vision color are now data-driven through environment attributes, as described in the Data Pack section below<\/p>\n
Lightmap Debug Renderer<\/p>\n
A new debug renderer for the lightmap was added, which can be enabled using the F3 + 4 keybind
\nIt is mutually exclusive with FPS\/TPS and networking charts
\nIt shows the lightmap texture in real-time in the bottom right corner of the screen
\nThe vertical axis of the texture represent sky light levels (0-15 from bottom to top)
\nThe horizontal axis of the texture represent block light levels (0-15 from left to right)
\nThe color of each pixel represents the resulting color that will be applied to blocks and entities lit with the corresponding block and sky light levels<\/p>\n
UI
\nDebug Screen<\/p>\n
The looking_at_block and looking_at_fluid debug entries no longer show tags
\nNew debug entries have been added:
\nlooking_at_block_tags
\nlooking_at_fluid_tags
\nlooking_at_entity_tags<\/p>\n
Renamed debug entries:
\nlooking_at_block -> looking_at_block_state
\nlooking_at_fluid -> looking_at_fluid_state<\/p>\n
Technical Changes<\/p>\n
The Data Pack version is now 95
\nIf a server’s disk space is low, a toast will now be shown to server operators
\nThe game now requires Java 25
\nThe included Java distribution is now the Microsoft build of OpenJDK 25<\/p>\n
Data Pack Version 95<\/p>\n
Added data-driven registry for villager trades
\nPiglin inventory slots can now be accessed using piglin.* similar to how Villager inventories can be accessed using villager.*<\/p>\n
Data-driven Villager Trades<\/p>\n
Trades offered by Villagers and Wandering Traders are now data-driven and can be customized by datapack developers<\/p>\n
Villager Trades<\/p>\n
Present in the villager_trade folder, represents a blueprint for trades which is used by Villagers and Wandering Traders to generate actual trades
\nEntry Format:
\nwants, an object representing an item type and number of them needed to trade
\nid, the id of the item
\ncount, an optional number provider representing how many of the item is needed for the trade<\/p>\n
components, an optional component map representing the expected data components on the item<\/p>\n
additional_wants, an optional object representing an additional item required by the merchant, has the same format as wants
\ngives, an Item Stack representing the resulting item given by the merchant when trading
\nUses the existing format for Item Stacks<\/p>\n
given_item_modifiers, a optional list of Item Modifiers representing modifiers to apply to the item in gives such as enchantments or potions, used to add dynamism to the trade rather than hardcoding certain values
\nUses the existing format for Item Modifiers (also known as loot modifiers, item functions, loot functions…)
\nIf any of these returns an empty item the entire trade will be discarded
\nItem Modifier references are not yet supported
\nIf the final item has a stored_enchantment component containing an enchantment in the #double_trade_price tag, then the count of wants is doubled<\/p>\n
max_uses, an optional number provider representing the maximum number of times a trade may be used
\nIs set to 1 if the number provider returns a lower value
\nDefaults to 4<\/p>\n
reputation_discount, an number provider representing how much factors such as demand, discounts or penalties affects the cost represented by wants
\nIs set to 0.0 if the number provider returns a lower value
\nDefaults to 0.0<\/p>\n
xp, an optional number provider representing the amount of xp a merchant gets when the trade is done
\nIs set to 0 if the number provider returns a lower value
\nDefaults to 1<\/p>\n
merchant_predicate, a Predicate representing conditions on the merchant that need to be met for the trade to be offered
\nUses the existing format for Predicates (also known as loot conditions)
\nPredicate references are not yet supported<\/p>\n
double_trade_price_enchantments, an optional enchantment id, list of namespaced enchantment IDs, or hash-prefixed enchantment tag representing enchantments that will double the additional cost from minecraft:enchant_randomly and minecraft:enchant_with_levels if they have include_additional_cost_component set to true and if the item has one of the provided values in its minecraft:stored_enchantments component<\/p>\n
An example trade of an emerald and a book for an enchanted book offered only by Desert Villagers<\/p>\n
{
\n “additional_wants”: {
\n “id”: “minecraft:book”
\n },
\n “double_trade_price_enchantments”: “#minecraft:double_trade_price”,
\n “given_item_modifiers”: [
\n {
\n “function”: “minecraft:enchant_randomly”,
\n “include_additional_cost_component”: true,
\n “only_compatible”: false,
\n “options”: “#minecraft:trades\/desert_common”
\n },
\n {
\n “function”: “minecraft:filtered”,
\n “item_filter”: {
\n “items”: “minecraft:enchanted_book”,
\n “predicates”: {
\n “minecraft:stored_enchantments”: [
\n {}
\n ]
\n }
\n },
\n “on_fail”: {
\n “function”: “minecraft:discard”
\n }
\n }
\n ],
\n “gives”: {
\n “count”: 1,
\n “id”: “minecraft:enchanted_book”
\n },
\n “max_uses”: 12.0,
\n “merchant_predicate”: {
\n “condition”: “minecraft:entity_properties”,
\n “entity”: “this”,
\n “predicate”: {
\n “predicates”: {
\n “minecraft:villager\/variant”: “minecraft:desert”
\n }
\n }
\n },
\n “reputation_discount”: 0.2,
\n “wants”: {
\n “id”: “minecraft:emerald”
\n }
\n}<\/p>\n
Trade Sets<\/p>\n
Present in the trade_set folder, they’re groupings of trades offered by Villagers and Wandering Traders
\nWe currently only have hardcoded ones available in \/level_ for Villagers, as well as wandering_trader\/buying, wandering_trader\/special, wandering_trader\/common for Wandering Traders
\nEntry Format:
\ntrades, a villager trade id, list of namespaced villager trade IDs, or hash-prefixed villager trade tag representing the trades that are part of this trade set
\namount, a number provider representing the amount of trades to be generated from this set when used
\nIf the generated number is greater than the number of available trades then it will only generate until all trades have been used once, unless allow_duplicates is set to true<\/p>\n
allow_duplicates, a boolean representing if the trade set can use the same Villager Trade multiple times to generate trades<\/p>\n
random_sequence, an optional named random sequence that determines which trades are generated
\nDefaults to a non-deterministic random sequence<\/p>\n
An example trade set offering 2 trades from the #minecraft:armorer\/level_1 tag, allowing duplicates<\/p>\n
{
\n “amount”: 2.0,
\n “trades”: “#minecraft:armorer\/level_1”,
\n “random_sequence”: “minecraft:trade_set\/armorer\/level_1”,
\n “allow_duplicates”: true
\n}<\/p>\n
Commands
\nAdded swing<\/p>\n
New command that enables swinging of entities arms
\nNot all entities support swing animation. swing will succeed for those entities, but clients will only display it when possible
\nFor example, this makes it possible to swing Mannequin arms
\nReturns the amount of entities for which a swing was sent<\/p>\n
Syntax: \/swing <\/p>\n
minecraft:visual\/block_light_tint<\/p>\n
Tint of the block light. Block light color start as dark grey at low light levels, becomes tinted by this attribute at medium levels and turns white at high levels. By default, it provides the yellowish tint of torches. Bright colors work best for this attribute, with at least one color component being fully bright. The tint applies globally to all light sources visible on the screen. Individual lights can not be tinted differently.<\/p>\n
Value type: RGB color
\nDefault value: #FFD88C
\nModifiers: RGB Color Modifiers
\nInterpolated: yes
\nResolved at the camera’s position<\/p>\n
minecraft:visual\/ambient_light_color<\/p>\n
Defines both the ambient light tint and brightness. This light is applied to the world at 0 light level. Block and sky light are added on top of it.<\/p>\n
Value type: RGB color
\nDefault values: #0A0A0A for the Overworld, #302821 for the Nether, #3f473f for the End
\nModifiers: RGB Color Modifiers
\nInterpolated: yes
\nResolved at the camera’s position<\/p>\n
minecraft:visual\/night_vision_color<\/p>\n
This color is used similarly to ambient light color. When the Night Vision effect is active, per-component maximum of minecraft:visual\/night_vision_color and minecraft:visual\/ambient_light_color is used as ambient color. Night Vision is not tinted by default.<\/p>\n
Value type: RGB color
\nDefault value: #999999
\nModifiers: RGB Color Modifiers
\nInterpolated: yes
\nResolved at the camera’s position<\/p>\n
Data Components
\nAdded minecraft:additional_trade_cost<\/p>\n
Transient component used to modify count needed of the gives item in a villager trade, is removed after a trade has been generated
\nFormat: integer<\/p>\n
Loot Functions<\/p>\n
Added minecraft:villager_trade loot table type which takes the following parameters:
\nthis, the entity offering the trade
\norigin, the block position of the entity at its feet<\/p>\n
Added minecraft:set_random_dyes<\/p>\n
Additively adds dyes to an item’s minecraft:dyed_color data component if the item is in the #dyeable tag Fields:
\nconditions – conditions for the function to apply
\nnumber_of_dyes – number provider representing the number of random dyes out of sixteen to apply to the item
\nThe same dye might be selected repeatedly<\/p>\n
Added minecraft:set_random_potion<\/p>\n
Randomly sets the minecraft:potion_contents data component on an item Fields:
\nconditions – conditions for the function to apply
\noptions – optional potion id, list of namespaced potion IDs, or hash-prefixed potion tag, representing the possible potions to select from
\nDefaults to any potion in the potions registry<\/p>\n
Changed minecraft:enchant_with_levels<\/p>\n
Now also takes the following field:<\/p>\n
include_additional_cost_component – optional boolean representing if an minecraft:additional_cost_component should be added to the item based on the cost of the enchantment
\nDefaults to false
\nThe value is determined by the levels number provider and is the same that is used to determine what enchantment level is used for enchanting<\/p>\n
Changed minecraft:enchant_randomly<\/p>\n
Now also takes the following field:<\/p>\n
include_additional_cost_component – optional boolean representing if an minecraft:additional_cost_component should be added to the item based on the cost of the enchantment
\nDefaults to false
\nThe value is determined by the value selected by levels or its default value using the following formula: 2 + random(0, 5 + level * 10) + 3 * level<\/p>\n
Predicates
\nEntity Predicates
\nplayer Sub-Predicate<\/p>\n
New optional field: food – A Food predicate
\nFormat: Object with fields:
\nlevel – optional integer min\/max range specifying the required food level
\nsaturation – optional float min\/max range specifying the required saturation level<\/p>\n
Added minecraft:sum<\/p>\n
Returns the sum of a list of number providers
\nFields:
\nsummands, a list of number providers<\/p>\n
Enchantments<\/p>\n
The post_piercing_attack component no longer only works for a player if that player has a certain food level<\/p>\n
Tags<\/p>\n
Added several tags representing groups of villager trades from which Villagers and Wandering Traders derive their trading pools
\nVillagers have the following tags representing each profession and level of trade in the format: #\/level_, up to level 5
\nSmiths have the #common_smith\/level_ tags representing common trades among armorers, weaponsmiths and toolsmiths, up to level 5<\/p>\n
Wandering Traders have the following tags: #wandering_trader\/buying, #wandering_trader\/special, #wandering_trader\/common<\/p>\n
Enchantment Tags<\/p>\n
Removed the following tags:
\ntrades\/desert_special
\ntrades\/jungle_special
\ntrades\/plains_special
\ntrades\/savanna_special
\ntrades\/snow_special
\ntrades\/swamp_special
\ntrades\/taiga_special<\/p>\n
Potion Tags<\/p>\n
Added #tradeable – all potion effects that can appear in villager trades<\/p>\n
Resource Pack Version 76
\nLightmap Shader Changes<\/p>\n
The lightmap.fsh shader was significantly modified.
\nThe LightmapInfo uniform now has two new fields:
\nBlockLightTint
\nNightVisionColor<\/p>\n
The AmbientLightFactor field was removed, its value is now premultiplied into AmbientColor
\nThe DarkenWorldFactor was renamed to BossOverlayWorldDarkeningFactor<\/p>\n
Text and items rendered in UI now use a separate 1×1 white lightmap texture, so the lightmap shader does not always have to keep the 15, 15 pixel purely white<\/p>\n
Fixed bugs in 26.1 Snapshot 1<\/p>\n
MC-64087<\/a> – Revengeful zombies \/ Zombie reinforcements will try to attack you in Creative mode Get the Snapshot<\/p>\n
\nMC-179949<\/a> – You cannot edit the inventories of piglins by using ‘\/item replace’
\nMC-197497<\/a> – Smooth lighting transition from level 1 to 0 is not smooth
\nMC-199589<\/a> – Hitting mobs in Creative mode then switching into Survival causes the mob to target you
\nMC-219981<\/a> – Leader zombie-type mobs spawn with 20 health despite having an increased maximum health
\nMC-300465<\/a> – Maps with the maximum number of markers cannot be placed in item frames
\nMC-302186<\/a> – Ambient lighting in the Nether appears discolored compared to previous versions
\nMC-302408<\/a> – Inconsistent underwater lighting with the Conduit Power effect applied
\nMC-302528<\/a> – Low sky & block light look outright broken when cast on the same area
\nMC-303119<\/a> – Feeding a cat or wolf in Survival mode with only one item in the selected item slot does not restore as much health as it should
\nMC-303125<\/a> – Creepers can blow up after the player dies
\nMC-303389<\/a> – The ender dragon’s velocity can be affected by attacks while perched
\nMC-303692<\/a> – Debug overlay text has an indent when improved transparency is disabled
\nMC-304023<\/a> – Redundant level data fixer files are saved in worlds’ “data” folder
\nMC-304217<\/a> – Lunge’s hunger requirement applies to post_piercing_attack effects of custom enchantments
\nMC-304599<\/a> – Dolphins don’t follow players riding nautiluses like in Bedrock Edition
\nMC-304631<\/a> – Anisotropic filtering set to 8x causes opaque translucent textures to become transparent in the distance when there are odd-sized block textures
\nMC-304725<\/a> – Zombie villagers summoned with default spawn eggs always spawn as their plains variant
\nMC-304991<\/a> – Clicking on a chest with loot that hasn’t been generated in Spectator mode makes the “block.chest.locked” sound
\nMC-305012<\/a> – The description of the “Universal anger” game rule still uses the old ID of the “Forgive dead players” game rule<\/p>\n