Template:Data pack format

Data pack formats

Value	Releases	[hide]Significant/Breaking Changes
4	1.13 1.14.4	Added the initial pack format version of 4.
5	1.15 1.16.1	[[Java Edition Added predicates.|Added predicates.]]
6	1.16.2 1.16.5	[[Java Edition Added experimental support for custom world generation.|Added experimental support for custom world generation.]]
7	1.17 1.17.1	[[Java Edition The /replaceitem command was replaced with /item. The set_damage loot function now require a valid [String] type field.|The /replaceitem command was replaced with /item. The set_damage loot function now require a valid [String] type field.]]
8	1.18 1.18.1	[[Java Edition Loot table functions set_contents and set_loot_table now require a [String] type field. Removed length limits for scoreboards, score holders and team names.|Loot table functions set_contents and set_loot_table now require a [String] type field. Removed length limits for scoreboards, score holders and team names.]]
9	1.18.2	[[Java Edition The /locate command now takes a configured structure as its first parameter rather than a structure type, so many grouped structures now require a structure type tag. E.g. /locate village is now /locate #village.|The /locate command now takes a configured structure as its first parameter rather than a structure type, so many grouped structures now require a structure type tag. E.g. /locate village is now /locate #village.]]
10	1.19 1.19.3	[[Java Edition Data packs can now have a [NBT Compound / JSON Object] filter section in pack.mcmeta. Merged /locatebiome with /locate, changing its syntax.|Data packs can now have a [NBT Compound / JSON Object] filter section in pack.mcmeta. Merged /locatebiome with /locate, changing its syntax.]]
12	1.19.4	[[Java Edition Added damage types. Removed all boolean flags in damage predicates, instead damage type tags can now be tested for. Biome field [String] precipitation changed to [Boolean] has_precipitation.|Added damage types. Removed all boolean flags in damage predicates, instead damage type tags can now be tested for. Biome field [String] precipitation changed to [Boolean] has_precipitation.]]
15	1.20 1.20.1	[[Java Edition Changed sign NBT. E.g. Text1 is now front_text.messages[0]. All fields in placed_block, item_used_on_block, and allay_drop_item_on_block advancement triggers have been collapsed to a single location field. Renamed the alternative predicate to any_of.|Changed sign NBT. E.g. Text1 is now front_text.messages[0]. All fields in placed_block, item_used_on_block, and allay_drop_item_on_block advancement triggers have been collapsed to a single location field. Renamed the alternative predicate to any_of.]]
18	1.20.2	[[Java Edition Added function macros. Effects now use namespaced IDs rather than numeric values in NBT. E.g. 1 is now minecraft:speed.|Added function macros. Effects now use namespaced IDs rather than numeric values in NBT. E.g. 1 is now minecraft:speed.]]
26	1.20.3 1.20.4	[[Java Edition Text components are parsed more strictly. Renamed grass block and item to short_grass. Added scoreboard display names and number formats.|Text components are parsed more strictly. Renamed grass block and item to short_grass. Added scoreboard display names and number formats.]]
41	1.20.5 1.20.6	[[Java Edition Renamed the sweeping enchantment to sweeping_edge. Changed the behavior of the item_used_on_block advancement trigger. Replaced some behavior of amplifiers above 127 with attributes. Unstructured NBT data attached item stacks has been replaced with structured components. Removed durability, potions, nbt, and enchantments fields in item predicates. Recipe output can now specify components. Int and float providers used in worldgen definitions are no longer wrapped in an extra value field next to type. Added new item sub-predicates and loot functions.|Renamed the sweeping enchantment to sweeping_edge. Changed the behavior of the item_used_on_block advancement trigger. Replaced some behavior of amplifiers above 127 with attributes. Unstructured NBT data attached item stacks has been replaced with structured components. Removed durability, potions, nbt, and enchantments fields in item predicates. Recipe output can now specify components. Int and float providers used in worldgen definitions are no longer wrapped in an extra value field next to type. Added new item sub-predicates and loot functions.]]
48	1.21 1.21.1	[[Java Edition Added data driven enchantments. Added data driven paintings. Renamed the enchantment field to enchantments in the item sub predicate. Renamed legacy folders like loot_tables and tags/items to loot_table and tags/item. Removed the [NBT List / JSON Array] power fireball tag and replaced it with [Float] acceleration_power. Attributes now have a single resource location id field instead of a name and uuid.|Added data driven enchantments. Added data driven paintings. Renamed the enchantment field to enchantments in the item sub predicate. Renamed legacy folders like loot_tables and tags/items to loot_table and tags/item. Removed the [NBT List / JSON Array] power fireball tag and replaced it with [Float] acceleration_power. Attributes now have a single resource location id field instead of a name and uuid.]]
57	1.21.2 1.21.3	[[Java Edition Removed attribute ID prefixes such as generic.. Changed formats of data components, loot tables and predicates. Added new data components, loot tables and item tags. Added key input predicate. Added crafting_transmute recipe type. Renamed enchantment effect damage_item to change_item_damage.|Removed attribute ID prefixes such as generic.. Changed formats of data components, loot tables and predicates. Added new data components, loot tables and item tags. Added key input predicate. Added crafting_transmute recipe type. Renamed enchantment effect damage_item to change_item_damage.]]
61	1.21.4	[[Java Edition Renamed tnt minecart TNTFuse to fuse. Renamed fields of furnace block entities. Added required field duration to trail particle. Changed format of the custom_model_data component and loot function.|Renamed tnt minecart TNTFuse to fuse. Renamed fields of furnace block entities. Added required field duration to trail particle. Changed format of the custom_model_data component and loot function.]]
71	1.21.5	[[Java Edition Text components are now saved as objects in NBT rather than strings containing JSON and many commands such as /tellraw now take SNBT rather than JSON. The Game Tests system is now accessible through data packs and for mods. Added many new components. Added entity variant components. Commands that place blocks, such as /setblock, now have a strict argument. Pig, frog, chicken and cow variants are now data-driven. The [NBT List / JSON Array] ArmorItems, [NBT List / JSON Array] HandItems, [NBT Compound / JSON Object] body_armor_item, [NBT Compound / JSON Object] SaddleItem, and [Boolean] Saddle NBT tags were removed and merged into the [NBT Compound / JSON Object] equipment field. Item components that had only two fields (with one of them being the [Boolean] show_in_tooltip) now have the other field inlined to top-level. Removed hide_tooltip and hide_additional_tooltip components and [Boolean] show_in_tooltip field from all components in favor of the new tooltip_display component. Many changes have been made to entities and block entities' NBT data.|Text components are now saved as objects in NBT rather than strings containing JSON and many commands such as /tellraw now take SNBT rather than JSON. The Game Tests system is now accessible through data packs and for mods. Added many new components. Added entity variant components. Commands that place blocks, such as /setblock, now have a strict argument. Pig, frog, chicken and cow variants are now data-driven. The [NBT List / JSON Array] ArmorItems, [NBT List / JSON Array] HandItems, [NBT Compound / JSON Object] body_armor_item, [NBT Compound / JSON Object] SaddleItem, and [Boolean] Saddle NBT tags were removed and merged into the [NBT Compound / JSON Object] equipment field. Item components that had only two fields (with one of them being the [Boolean] show_in_tooltip) now have the other field inlined to top-level. Removed hide_tooltip and hide_additional_tooltip components and [Boolean] show_in_tooltip field from all components in favor of the new tooltip_display component. Many changes have been made to entities and block entities' NBT data.]]

Data pack formats

Value	Versions	Releases	[hide]Significant/Breaking Changes
4	1.13 1.14.4	Added the initial pack format version of 4.
5	1.15 1.16.1	[[Java Edition Added predicates.|Added predicates.]]
6	1.16.2 1.16.5	[[Java Edition Added experimental support for custom world generation.|Added experimental support for custom world generation.]]
7	1.17 1.17.1	[[Java Edition The /replaceitem command was replaced with /item. Rolls, set_damage, and possibly other parameters in loot tables now require a valid type field when using min-max for numbers. score conditions' entity parameter was replaced with target.|The /replaceitem command was replaced with /item. Rolls, set_damage, and possibly other parameters in loot tables now require a valid type field when using min-max for numbers. score conditions' entity parameter was replaced with target.]]
8	1.18 1.18.1	[[Java Edition Loot tables now require a type field. Removed length limits for scoreboards, score holders and team names. The lava_pool_stone_replaceables block tag was renamed to lava_pool_stone_cannot_replace.|Loot tables now require a type field. Removed length limits for scoreboards, score holders and team names. The lava_pool_stone_replaceables block tag was renamed to lava_pool_stone_cannot_replace.]]
9	1.18.2	[[Java Edition The /locate command now takes a configured structure as its first parameter rather than a structure type, so many grouped structures now require you to locate a structure type tag. E.g. /locate village is now /locate #village.|The /locate command now takes a configured structure as its first parameter rather than a structure type, so many grouped structures now require you to locate a structure type tag. E.g. /locate village is now /locate #village.]]
10	1.19 1.19.3	[[Java Edition Data pack can have a filter section in pack.mcmeta now. Renamed the feature field in location predicates to structure. In 22w19a, /locatebiome was merged with /locate and the syntax for /locate was changed, but the pack format was not updated.|Data pack can have a filter section in pack.mcmeta now. Renamed the feature field in location predicates to structure. In 22w19a, /locatebiome was merged with /locate and the syntax for /locate was changed, but the pack format was not updated.]]
11	–
12	1.19.4	[[Java Edition is_projectile, is_explosion, bypasses_armor, bypasses_invulnerability, bypasses_magic, is_fire, is_magic and is_lightning fields were removed from damage type predicates in favour of a tags field which is a list of damage type tags which the damage type belongs to.|is_projectile, is_explosion, bypasses_armor, bypasses_invulnerability, bypasses_magic, is_fire, is_magic and is_lightning fields were removed from damage type predicates in favour of a tags field which is a list of damage type tags which the damage type belongs to.]]
13	–
14	–
15	1.20 1.20.1	[[Java Edition All fields in placed_block, item_used_on_block, and allay_drop_item_on_block advancement triggers have been collapsed to a single location field. alternative predicate and loot table conditions were renamed to any_of.|All fields in placed_block, item_used_on_block, and allay_drop_item_on_block advancement triggers have been collapsed to a single location field. alternative predicate and loot table conditions were renamed to any_of.]]
16	–
17	–
18	1.20.2	[[Java Edition Removed /execute if function and /return run functionality (with promise to reintroduce after 1.20.2). Numerical data types are written in macros without their suffixes. Very large and very small float and double values are no longer written in standard scientific notation; they are written as their decimal expansion up to 15 decimal places, so some small values are rounded to zero.|Removed /execute if function and /return run functionality (with promise to reintroduce after 1.20.2). Numerical data types are written in macros without their suffixes. Very large and very small float and double values are no longer written in standard scientific notation; they are written as their decimal expansion up to 15 decimal places, so some small values are rounded to zero.]]
19	–
20	–
21	–
22	–
23	–
24	–
25	–
26	1.20.3 1.20.4	[[Java Edition Renamed grass block and item to short_grass.|Renamed grass block and item to short_grass.]]
27	–
28	–
29	–
30	–
31	–
32	–
33	–
34	–
35	–
36	–
37	–
38	–
39	–
40	–
41	1.20.5 1.20.6	[[Java Edition Renamed the entity type tag #punchable_projectiles to #redirectable_projectile.|Renamed the entity type tag #punchable_projectiles to #redirectable_projectile.]]
42	–
43	–
44	–
45	–
46	–
47	–
48	1.21 1.21.1	[[Java Edition Renamed replace_disc entity effect type to replace_disk.|Renamed replace_disc entity effect type to replace_disk.]]
49	–
50	–
51	–
52	–
53	–
54	–
55	–
56	–
57	1.21.2 1.21.3	[[Java Edition Added disablePlayerMovementCheck game rule. Added field [String] camera_overlay to equippable component. Standardized format of colors in particles.|Added disablePlayerMovementCheck game rule. Added field [String] camera_overlay to equippable component. Standardized format of colors in particles.]]
58	–
59	–
60	–
61	1.21.4	[[Java Edition Renamed furnace timing related NBT fields and added lit_total_time.|Renamed furnace timing related NBT fields and added lit_total_time.]]
62	–
63	–
64	–
65	–
66	–
67	–
68	–
69	–
70	–
71	1.21.5	[[Java Edition Pack format bump missed in pre1. No changes.|Pack format bump missed in pre1. No changes.]]