Pack format

This feature is exclusive to Java Edition.
 

Pack format, sometimes referred to as pack version, is a number used in pack.mcmeta to describe what Java Edition versions a resource pack or data pack is compatible with. Each version specifies the pack formats it supports in its version.json. The pack format can be obtained by running /version, or using the F3 + V debug hotkey.

List of data pack formats

Below is a list of all valid data pack formats with corresponding Java Edition versions.[note 1]

Data pack formats
Value Releases Significant/Breaking Changes
41.131.14.4
  • Added the initial pack format version of 4.
51.151.16.1
61.16.21.16.5
71.171.17.1
  • The /replaceitem command was replaced with /item.
  • The set_damage loot function now require a valid [String] type field.
81.181.18.1
  • 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.
91.18.2
  • 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.
101.191.19.3
  • Data packs can now have a [NBT Compound / JSON Object] filter section in pack.mcmeta.
  • Merged /locatebiome with /locate, changing its syntax.
121.19.4
  • 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.
151.201.20.1
  • 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.
181.20.2
  • Added function macros.
  • Effects now use namespaced IDs rather than numeric values in NBT. E.g. 1 is now minecraft:speed.
261.20.31.20.4
  • Text components are parsed more strictly.
  • Renamed grass block and item to short_grass.
  • Added scoreboard display names and number formats.
411.20.51.20.6
  • 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.
481.211.21.1
  • 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 and functions to function.
  • 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.
571.21.21.21.3
  • 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.
611.21.4
  • 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.
711.21.5
  • 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 components blocks_attacks, break_sound, potion_duration_scale, provides_banner_patterns, provides_trim_material, tooltip_display, and weapon.
  • Added many 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.
  • The [Int] SpawnX, [Int] SpawnY, [Int] SpawnZ, [Float] SpawnAngle, [String] SpawnDimension, and [Boolean] SpawnForced NBT tags were removed and merged into the [NBT Compound / JSON Object] respawn 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.
  • Many other changes have also been made. For all technical changes and additions, see Java Edition 1.21.5 § Technical.
801.21.6
  • Dimension type definitions have a new optional field, cloud_height that indicates what Y-level the clouds start in the dimension.
  • The [NBT Compound / JSON Object] Particle field has been renamed to [NBT Compound / JSON Object] custom_particle, and now always functions as an exact override for the default colored entity_effect particle.
  • /datapack now has a new argument: create.
  • Added /version.
  • Added [NBT Compound / JSON Object] display field to attribute_modifier item component entries.
  • Added camera_distance, waypoint_transmit_range, and waypoint_receive_range attributes.
  • painting/variant item component no longer accepts inline variants.
  • Added /dialog.
  • Added ui sound category.
811.21.71.21.8
  • Added music_disc_lava_chicken item and minecraft:music_disc.lava_chicken sound event

List of resource pack formats

Below is a list of all valid resource pack formats with corresponding Java Edition versions.

Resource pack formats
Value Versions Releases Significant/Breaking Changes
113w24a1.8.91.6.11.8.9First implementation of the resource pack system. See Java Edition 1.6.1/Resource pack changes for the list of file names changed.
215w31a1.10.21.91.10.2Changes in the model system, such as item tags, multipart, and changes to display tags.
316w32a17w47b1.111.12.2Now requires lowercase file names for all files in the resource pack.
417w48a19w46b1.131.14.4Most of the block and item textures have been renamed. See Java Edition 1.13/Resource pack changes for the list of file names changed.
The resource pack folder textures/blocks got renamed to textures/block.
The resource pack folder textures/items got renamed to textures/item.
51.15-pre11.16-pre31.151.16.1Changed texture mappings with all chests, banner and shield patterns now use alpha channels. The ender dragon no longer has a separate texture for the bottom of its wing. The glint texture for enchanted items now appears like it does in-game. The game now supports conversion with some of version 4 resource packs' outdated textures to the newer ones.
Increased the size limit for the client-side downloading of resource packs from 50 MB to 100 MB.
61.16.2-rc11.16.51.16.21.16.5Fixed MC-197275 — Due to changes to walls, pack_format: 5 is no longer cross-compatible between 1.15 and 1.16.
720w45a21w38a1.171.17.1Drowned texture mirroring has changed, Grass path has been renamed to dirt path.
Slots for the game mode selector are now 26 pixels instead of 25.
821w39a1.18.21.181.18.2inventory.png now contains an extra sprite for a thin-layout version of the effect list in the inventory.
922w11a1.19.21.191.19.2Resource pack can have a filter section in pack.mcmeta now.
1122w42a22w44aRemoved "fixers" for resource packs with a pack_format value of 3 and 4 (pre-flattening);
the game will no longer try to adapt packs with those values to the current version.
1222w45a23w07a1.19.3The model and textures of the vex have been updated. tabs.png is now skinnier by 2 pixels, with the 7th tab being added to it. Resource packs can have configuration files now, located in the new atlases directory, that control which images are included in the atlases. Block and item textures are now loaded before they are processed by block and item models.
131.19.4-pre123w13a1.19.4The enchantment glint now has two separate texture files: enchanted_glint_entity.png and enchanted_glint_item.png.
The former smithing table GUI texture has been renamed to legacy_smithing.png in preparations for Java Edition 1.20, where the new smithing GUI texture is named as smithing.png instead, superseding the previous, similarly-named texture.
1423w14a23w16aUpdated the sprite layout of minecraft.png and invite_icon.png. minecraft.png logo has been reworked to be high quality and is no longer split across 2 rows.
1523w17a1.20.11.201.20.1legacy_unicode glyph provider has been removed. Bitmaps used by uniform font have been removed.

uniform font has been updated to use Unifont 15.0.01, where it changes shape of multiple characters, while also adding support for new ones, and combining characters no longer include circle overlayed over them. Added second level of organization of entries in credits.json on top of titles, called disciplines.
1623w31aPack metadata now includes an optional field supported_formats which describes a range for pack formats that this pack supports. Packs can now contain overlay directories ("overlays").
1723w32a1.20.2-pre1The text field background is now a nine-sliced sprite at widget/text_field, and widget/text_field_highlighted. The scroll bar in lists and text fields is now a nine-sliced sprite at widget/scroller. Added new village structure icons to map_icons.png.
181.20.2-pre223w41a1.20.2
1923w42aAdded block model, item model and block state definitions for Crafter. Associated GUI slot texture and sprites have also been added as well.
2023w43a23w44aThe bat has a new model, resulting the texture mappings for bat.png to be changed.
2123w45a23w46aNow support only .png files for textures.
221.20.3-pre123w51b1.20.31.20.4Renamed grass block and item to short_grass.
2424w03a24w04aAdjusted the texture of the Wolf Collar layer to be more consistent with the new Wolf Armor.

The ttf font provider transforms have been adjusted to have more reasonable defaults.
2524w05a24w05bAdded texture and model files for vault block.
Removed unused attributes in core shader definitions.
2624w06a24w07aAdded font variant filters.
2824w09a24w10aAdjusted menu GUI textures. Added additional textures to support colored layers of wolf armor for the wolf model and wolf armor item. Added three semi-transparent textures for the cracks to show on the wolf armor layer.
2924w11aAdjusted menu GUI textures.
3024w12aSplit map_icons.png into individual sprites in the textures/map/decorations directory.
3124w13a1.20.5-pre3Added new particle types and sound events.
321.20.5-pre41.20.61.20.51.20.6The shift in TTF glyph providers is now restricted to the range [-512; 512].
3324w18a24w20aThe sound events for ominous trial spawner becoming active and ambient sound were renamed.
Added new music discs.
3424w21a1.21.11.211.21.1Added the block.vault.reject_rewarded_player sound event.
3524w33aChanged shaders and post-process effects.
3624w34a24w35aChanged shader and post-process effect definitions and imports.
3724w36aIntroduced equipment models and more customizable tooltips.
3824w37aAdded GUI Sprite of the highlighted slots.
3924w38a24w39aAdded Bundle variants and changed torch models.
4024w40aIncreased to support the new experimental changes.
411.21.2-pre11.21.2-pre2Added texture for empty air bubble and sound for when air bubble pops.
421.21.2-pre31.21.31.21.21.21.3Added texture for bundle slot background.
4324w44aAdded resin, eyeblossoms, and changes some GUI sprites and magma cube texture layout with UV mapping.
4424w45aAdds new format for data-driven item models.
4524w46aAll blocks that previously rendered only block entity will now also render normal block model over it.
461.21.4-pre11.21.41.21.4Added a way to suppress first-person hand animation on item change for specific models.
4725w02aAdded wildflowers, falling leaves, and new pig textures.
4825w03aChanged the size of the pig_saddle texture and added new equipment layer to pigs and striders.
4925w04aChanged item model components.
5025w05aAdded new cow variants and new bush blocks.
5125w06aAdded new chicken textures, new eggs, cactus flower, and tall and short dry grass.
5225w07aUpdated mooshroom model, removed shader program definitions for core shaders and post-processing effects as JSON files, and updated item rendering.
5325w08a25w09bUpdated spawn egg textures, removed spawn_egg.png and spawn_egg_overlay.png, added an undercoat texture to sheep, and changed wolf sounds.
5425w10aRenamed misc/enchanted_glint_entity.png to misc/enchanted_glint_armor.png, and "global" uniforms may now be defined in any shader and the game will attempt to fill it.
551.21.5-pre11.21.51.21.5Tweaked leaf litter model.
5625w15aThe game will now consistently respect blur texture parameter in .png.mcmeta files.
5725w16aAll core shader uniforms are now uniform blocks, clouds.png can no longer be colored, and Block Model rotations are no longer limited to multiplies of 22.5.
5825w17aFOG_IS_SKY has been removed.
5925w18aLocator bar arrows are now animated using the standard method. Unifont updated to 16.0.03. UNIHEX font provider's size_overrides field is now optional.
6025w19aPanorama textures must now all be the same size and square.
6125w20aAdded icon/music_notes and toast/now_playing sprites.
6225w21aAdded entity/leashknot/break sound, renamed leash sound names,and added sounds for shearing Saddles, Horse Armor, and Carpets from Llamas.
631.21.6-pre11.21.7-rc11.21.6Added oversized_in_gui item model field and introduced new player head special model type. In 1.21.7 Release Candidate 1, new textures were added, but the pack format was not incremented.
641.21.7-rc21.21.81.21.71.21.8Pack format bump missed in 1.21.7-rc1. No changes.

Notes

  1. Tag changes, additions and removals are not listed here.

Navigation