View source for Minecraft:Resource pack

{{about|the system to customize assets|other uses|Texture pack (disambiguation)}}
{{relevant tutorial|Creating a resource pack|Loading a resource pack}}
[[File:TexturesComparison.png|thumb|right|350px|The default textures on the left side, and a custom resource pack ([https://modrinth.com/resourcepack/rodrigos-pack/ Rodrigo's Pack 8x8]) on the right.]]
The '''resource pack''' system provides a way for players to customize textures, [[Minecraft:model]]s, [[Minecraft:music]], [[Minecraft:sound]]s, [[Minecraft:language]]s, texts such as the [[Minecraft:End Poem]], [[Minecraft:splash]]es, [[Minecraft:Credit sequence|credits]], and fonts without any code modification. They are often used together with [[Minecraft:data pack]]s or [[Minecraft:behavior pack]]s to add new content to the game. {{IN|BE}}, resource packs are often included in [[Minecraft:add-on]]s in the [[Minecraft:Marketplace]].

== ''Java Edition'' ==
=== Behavior ===
[[File:Select resource pack.png|thumb|The default resource pack settings.]]
Each resource pack is either a directory or a [[Minecraft:w:ZIP (file format)|ZIP archive]] (with {{code|.zip}} extension). Resource packs can be added by placing them in the {{file|directory|resourcepacks|inline=1}} directory within {{file|directory|[[Minecraft:.minecraft]]|inline=1}}, or by dragging and dropping onto the "Select Resource Packs" screen, which copies them there automatically. Resource packs present in the directory can then be managed from the [[Minecraft:options]], where they can be moved between "Available" (disabled) and "Selected" (enabled), and reordered.

Resource packs load their assets based on the order they appear in on the "Selected" list. The bottom-most pack loads first, then each pack above it replaces or merges loaded assets with ones it contains.

==== Built-in resource packs ====
There are currently three resource packs that are included as part of the game.

{| class="wikitable"
|-
! Pack name !! Pack description !! Description
|-
| [[File:Default pack.png|32px]] [[Minecraft:Resource pack#Default resource pack|Default]] || The default look and feel of Minecraft (built-in) || Selected by default, can't be unselected. Contains essential files.
|-
| [[File:Programmer Art pack.png|32px]] [[Minecraft:Programmer Art]] || The classic look of Minecraft (built-in) || The old (pre-[[Minecraft:Java Edition 1.14|1.14]]) textures. They are typically not updated when the game receives new textures and are only modified to account for formatting changes. This resource pack is stored as <code>minecraft/resourcepacks/programmer_art.zip</code> in the [[#Asset object store|asset object store]].
|-
| [[File:HC pack.png|32px]] High Contrast || Enhances the UI contrast of Minecraft (built-in) || Increases the contrast of menu GUIs. This resource pack is stored as <code>minecraft/resourcepacks/high_contrast.zip</code> in the [[#Asset object store|asset object store]].
|}

==== Preloaded resource packs ====
A ZIP archive resource pack can be bundled with a [[Minecraft:world]] by placing it in the world directory under the name {{code|resources.zip}}. When playing the world, that resource pack appears as the default pack, right above the default resource pack. It is, however, not distributed to other players connecting via [[Minecraft:Multiplayer#LAN connections|LAN]].

A resource pack can be set on a server by setting {{code|resource-pack}} to an HTTP(S) URL pointing to a ZIP archive resource pack in [[Minecraft:server.properties]]. Players can then choose if they want to download the resource pack or not when joining. Players can also be forced to accept the resource pack by setting {{code|require-resource-pack{{=}}true}}; in this case, rejecting the resource pack disconnects the player from the server.

There is no way to force the use of a resource pack in a [[Minecraft:Realm]].{{needs testing}}

=== Directory structure ===
Resource packs in ''Java Edition'' have the following directory structure:

<div class="treeview">
*{{File|directory|''name''}} or {{File|archive|''name''.zip}}
**{{File|file|[[Minecraft:pack.mcmeta]]}}: Metadata of the resource pack. This is the only mandatory file.
**{{File|file|pack.png}}: The picture to display next to the resource pack in the "Select Resource Packs" screen.
**{{File|directory|assets}}
***{{File|directory|{{ph|namespace}}}}: Directory of the namespace to use, see {{slink|Resource location|Namespaces}}. More than one directory for different namespaces may exist under the {{cd|assets}} directory. The {{cd|minecraft}} namespace is used for vanilla files and can be used to override them.
****{{File|directory|[[Minecraft:atlas]]es}}: {{cd|.json}} files controlling which textures are included in atlases.
****{{File|directory|[[Minecraft:Blockstates definition|blockstates]]}}: {{cd|.json}} files defining the models for each block state of blocks.
****{{File|directory|[[Minecraft:equipment]]}}: {{cd|.json}} files controlling the appearance of worn equipment.
****{{File|directory|[[Minecraft:Font#Providers|font]]}}: {{cd|.json}} files defining font providers.
****{{File|directory|[[Minecraft:Items model definition|items]]}}: {{cd|.json}} files controlling the rendering of items.
****{{File|directory|[[#Language|lang]]}}: {{cd|{{ph|language code}}.json}} files containing translations of text.
****{{File|directory|[[Minecraft:model]]s}}: {{cd|.json}} files defining three-dimensional shapes used to render blocks and items.
****{{File|directory|particles}}: {{cd|.json}} files specifying the textures to use for particles.
****{{File|directory|[[Minecraft:Shader#Post-processing effects|post_effect]]}}: {{cd|.json}} files controlling the use of shaders for post-processing effects.
****{{File|directory|[[Minecraft:shader]]s}}
*****{{File|directory|core}}: {{cd|.fsh}} and {{cd|.vsh}} files controlling the rendering of the game.
*****{{File|directory|include}}: {{cd|.glsl}}, {{cd|.fsh}} and {{cd|.vsh}} files that can be included in core and post shaders.
*****{{File|directory|post}}: {{cd|.fsh}} and {{cd|.vsh}} files controlling the rendering of post-processing effects.
****{{File|directory|[[Minecraft:sounds]]}}: {{cd|[[Minecraft:w:Vorbis|.ogg]]}} files that provide audio such as music and sound effects for the game.
****{{File|directory|[[#Texts|texts]]}}: {{cd|.txt}} file containing specific untranslated text.
****{{File|directory|textures}}: {{cd|.png}} files used as textures for blocks, items, mobs, etc. <ul class="mw-collapsible mw-collapsed"> <!-- using div doesn't work -->
<!-- START COLLAPSIBLE LIST -->
****{{File|directory|block}}
*****{{File|file|''texture''.png}}
*****{{File|file|''texture''.png.mcmeta}}
****{{File|directory|colormap}}
*****{{File|file|foliage.png}}
*****{{File|file|grass.png}}
****{{File|directory|effect}}
*****{{File|file|dither.png}}
****{{File|directory|entity}}
*****{{File|file|''texture''.png}}
*****{{File|directory|''entity_type''}}
******{{File|file|''texture''.png}}
****{{File|directory|environment}}
*****{{File|file|''texture''.png}}
****{{File|directory|font}}
*****{{File|file|''texture''.png}}
****{{File|directory|gui}}
*****{{File|directory|''texture''}}
*****{{File|file|''texture''.png}}
****{{File|directory|item}}
*****{{File|file|''texture''.png}}
****{{File|directory|map}}
*****{{File|file|''texture''.png}}
*****{{File|directory|decorations}}
******{{File|file|''texture''.png}}
****{{File|directory|misc}}
*****{{File|file|''texture''.png}}
*****{{File|file|''texture''.png.mcmeta}}
****{{File|directory|mob_effect}}
*****{{File|file|''texture''.png}}
****{{File|directory|painting}}
*****{{File|file|''texture''.png}}
****{{File|directory|particle}}
*****{{File|file|''texture''.png}}
*****{{File|file|''texture''.png.mcmeta}}
****{{File|directory|trims}}
*****{{File|directory|color_palettes}}
******{{File|file|''color_palette''.png}}
*****{{File|directory|entity}}
******{{File|directory|humanoid}}
*******{{File|file|''trims''.png}}
******{{File|directory|humanoid_leggings}}
*******{{File|file|''trims''.png}}
*****{{File|directory|items}}
<!-- END COLLAPSIBLE LIST -->
******{{File|file|''trims''.png}}</ul>
****{{File|directory|[[Minecraft:waypoint_style]]}}: {{cd|.json}} files controlling the appearance of waypoints on the [[Minecraft:locator_bar]].
****{{File|file|gpu_warnlist.json}}
****{{File|file|[[#Regional_compliancies_warnings|regional_compliancies.json]]}}: Warnings displayed based on region of the player.
****{{File|file|[[Minecraft:sounds.json]]}}: Used to tell the sound system what sound files to play when a sound event is triggered by one or more in-game events. 
***{{File|file|.mcassetsroot}}: Empty file identifying the [[#Default resource pack|vanilla resource pack]].
**{{File|directory|{{ph|overlay_directory}}/assets}}: If defined in the {{file|file|[[Minecraft:pack.mcmeta]]|inline=1}} ''overlays'' object, these optional ''directories'' mimic the above {{file|directory|assets|inline=1}} structure.
</div>

=== Contents ===
A resource pack is identified by ''Minecraft'' based on the presence of {{file|file|[[Minecraft:pack.mcmeta]]|inline=1}} in the root directory.

The root directory also contains an optional {{w|PNG}} image called {{file|file|pack.png|inline=1}}, which appears as the thumbnail for the pack on the resource pack selection menu.

==== Language ====
Language files are [[Minecraft:JSON]] files, which contain text data translated to different [[Minecraft:languages]]. They are located in {{file|directory|assets/''[[Minecraft:namespace]]''/lang|inline=1}} and named {{file|file|''language code''.json|inline=1}}. Languages other than default can be defined in {{file|file|pack.mcmeta|inline=1}}.

<div class="treeview">
* {{Nbt|compound}} The root object.
** {{Nbt|string|''ID''}}: Displayed translation for the text ''ID''.
</div>

A language file consists of an object containing ID and translation pairs. The ID uniquely identifies any translatable text in the game, and the translation is displayed as that text when the language is selected. For example, {{code|block.minecraft.stone}} is the ID of the text used for the name of the [[Minecraft:stone]] block, and its translation in the {{code|en_us}} language is {{code|Stone}}.

Language files are merged with other selected packs, so any names that are not present are loaded from packs of lesser priority.

In language key values, placeholders to be replaced by other text or numbers later can also be used; for example, using the {{code|with}} of a [[Minecraft:Text component format#Translated Text|translatable text component]].

Placeholders are defined using {{code|%s}} as a short form, or {{code|%''<number>''$s}} to specify the index explicitly. Placeholder indices start at {{code|1}}. When not specifying the index explicitly, the game will pick the next available index in sequential order, and placeholders are assigned an index in the order they are encountered in the string. If translators need to swap the order of placeholders for grammatical reasons, they can swap a {{code|%s}} placeholder with an indexed one.

A literal {{code|%}} character, which should render as such in the text shown by the game and is not part of a translation placeholder, must be escaped by using {{code|%%}}; otherwise, the game may fail to parse other placeholders within that string.

==== Textures ====
[[File:Missing Model.png|thumb|The "missing model" for invalid or missing models, prominently using the black and magenta "missing texture".]]

Textures are image files in PNG format, which provide images to be used as textures for models such as items, blocks and mobs.

Before 1.13 for block or item textures to function, they must have equal width and height (or height that is a multiple of the width if [[#Texture animation|animated]]); otherwise it appears as a magenta and black checkerboard. For most other textures, the file is stretched to fit the required dimensions. 
As of 1.13 non-square textures can be used for blocks and items just fine (although they will look stretched/squashed on default models).

Most solid blocks turn any transparent area fully opaque. Some other blocks, which have "cutout" transparency (like glass) turn all pixels that are less than 10% opaque fully transparent and all other pixels completely opaque. Every other block renders textures with semi-transparency as-is. All items, blocks or entities that are semi-transparent by default support semi-transparency. All items that do not have a corresponding block do support semi-transparency.

If a texture does not exist in any resource pack, including the default, the [[Minecraft:missing texture]] appears in its place. As of 1.19.1, six such cases exist in the vanilla resource pack, all particle-related.

==== Texture animation ====
All textures that get stitched to an [[Minecraft:atlas]] support animation. This includes:
* Block and item textures
* Banner and shield textures
* Some block entities including: bed, chest, conduit, decorated pot, enchanting table book, bell, shulker box and sign textures
* Item frame and painting textures
* GUI sprites (all textures in the {{file|directory|assets/<namespace>/textures/gui/sprites/|inline=1}} directory)
* Mob effect icon textures
* Map decoration textures
* Particle textures
* Armor trim textures. This doesn't work with the {{code|paletted_permutations}} atlas source type, so textures must be added to the atlas using either the {{code|directory}} or {{code|single}} source types to be animated
* Sun, moon, and end flash

An animated texture is created by placing additional frames either vertically below the first, or horizontally to the right of the first. Alternatively, the frames can be arranged in a table by defining a <code>width</code> and <code>height</code> in the animation properties; in this case they are ordered row by row, top to bottom, left to right.

Each frame of the animation must be the same size, and the total dimensions of the image must be divisible by the <code>width</code> and <code>height</code> in the animation properties; otherwise a [[Minecraft:missing texture]] is shown. If a <code>width</code> and <code>height</code> are not specified, the game assumes each frame is square and the size of the smallest dimension of the image.

The animation properties are specified with a JSON file, named like the texture (including the extension), but with <code>.mcmeta</code> suffix appended. For example, the animation properties for {{code|stone.png}} would be {{code|stone.png.mcmeta}}.

;Texture animation properties format
<div class="treeview">
*{{nbt|compound}} The root tag 
**{{nbt|compound|animation}}: Contains the animation properties
***{{nbt|boolean|interpolate}}: If true, the game generates additional frames between frames if the <code>frametime</code> is greater than 1 between them. Defaults to {{code|false}}.
***{{nbt|int|width}}: The width of a single frame in pixels. Defaults to the image's width if <code>height</code> is defined, or the smaller of the image's dimensions if it isn't.
***{{nbt|int|height}}: The height of a single frame, in pixels. Defaults to the image's height if <code>width</code> is defined, or the smaller of the image's dimensions if it isn't.
***{{nbt|int|frametime}}: Sets the default time for each frame in increments of one game tick. Defaults to {{code|1}}.
***{{nbt|list|frames}}: Contains a list of frames. Defaults to displaying all the frames from first to last.
****{{nbt|int}} The index of a frame, with the first frame being <code>0</code>.
****{{nbt|compound}} An object containing additional data about a frame
*****{{nbt|int|index}}: The index of a frame, with the first frame being <code>0</code>.
*****{{nbt|int|time}}: The time in ticks to show this frame, overriding <code>frametime</code> above.
</div>

If the animation properties file does not exist in the pack and the texture does, the game assumes it isn't animated and displays the entire texture at once.

==== Villagers ====
Textures from {{code|assets/minecraft/textures/entity/villager}} and {{code|assets/minecraft/textures/entity/zombie_villager}} support a {{code|.mcmeta}} file in JSON format containing additional effects to apply to the hat layer. The file is contained in the same directory as the texture, and has the same name as the texture, except appended with {{code|.mcmeta}}. For example, the file {{code|profession/farmer.png}} can have a properties file called {{code|profession/farmer.png.mcmeta}}

<div class="treeview">
*{{nbt|compound}} The root tag 
**{{nbt|compound|villager}}: Contains data for the texture
***{{nbt|string|hat}}: Can be {{code|full}}, {{code|partial}}, or default (no {{code|.mcmeta}} file). Determines whether the villager's 'profession' hat layer should allow the 'type' hat layer to render or not. Can also be set to {{code|full}} on the 'type' hat layer to not render the aforementioned hat layer if the 'profession' hat layer is set to {{code|partial}}. Setting the 'type' hat layer to {{code|partial}} is ignored.
</div>

If the {{code|.mcmeta}} file does not exist in the pack and the texture does, the game loads the default settings, rather than loading a {{code|.mcmeta}} file from a pack below that pack.

==== GUI ==== 
Textures from {{code|assets/minecraft/textures/gui/sprites}} support a {{code|.mcmeta}} file in JSON format containing scaling behavior of the texture. For example, the file {{code|button.png}} can have a properties file called {{code|button.png.mcmeta}}

<div class="treeview">
* {{nbt|compound}} The root tag 
** {{nbt|compound|gui}}: Contains data for the texture
*** {{nbt|compound|scaling}}: Scaling behavior of the texture.
**** {{nbt|string|type}}: Can be {{code|stretch}} (default), {{code|tile}}, or {{code|nine_slice}}. Determines the type of scaling method of the texture. 
***** When {{Code|tile}}, the sprite is repeated across the desired space, starting from the top-left.
***** When {{Code|nine_slice}}, the sprite is sliced into ''4 corners'', ''4 edges'', and ''1 center slice'', which is tiled across the desired space.<ref>snapshot description https://www.minecraft.net/it-it/article/minecraft-snapshot-23w31a</ref>
**** {{nbt|int|width}}: Number of pixels for this sprite to cover on-screen across its width. Required if {{nbt|string|type}} is set to <code>tile</code> or <code>nine_slice</code>.
**** {{nbt|int|height}}: Number of pixels for this sprite to cover on-screen across its height. Required if {{nbt|string|type}} is set to <code>tile</code> or <code>nine_slice</code>.
**** {{nbt|boolean|stretch_inner}}: If true, the inner parts of the texture is stretched instead of tiled. Defaults to {{code|false}}. Required if {{nbt|string|type}} is set to <code>nine_slice</code>.
**** {{nbt|int|border}}: The size in pixels that the border slices should cover on-screen. Required if {{nbt|string|type}} is set to <code>nine_slice</code>.
**** {{nbt|compound|border}}: The size in pixels that the border slices should cover on-screen, respectively. Required if {{nbt|string|type}} is set to <code>nine_slice</code>.
***** {{nbt|int|left}}: Number of pixels of the left border.
***** {{nbt|int|top}}: Number of pixels of the top border.
***** {{nbt|int|right}}: Number of pixels of the right border.
***** {{nbt|int|bottom}}: Number of pixels of the bottom border.
</div>

==== Colormaps ====
Colormaps are 256×256 pixel images that tell the game which color to use in each biome. They are located in {{code|assets/minecraft/textures/colormap}}. The game contains three colormaps: {{code|foliage.png}} colors plants such as [[Minecraft:leaves]] (except birch and spruce) and [[Minecraft:vines]], {{code|grass.png}} colors [[Minecraft:grass]] and [[Minecraft:grass blocks]], and {{code|dry_foliage.png}} colors [[Minecraft:leaf litter]]. Colormaps can be disabled on individual blocks by removing the {{code|tintindex}} tag from the block model.

Birch leaves, spruce leaves, swamp grass, mangrove swamp grass and midlands grass are not controlled by colormaps {{in|JE}}, unlike {{in|BE}}.

==== Properties ====
Textures from {{code|assets/minecraft/textures/misc}}{{verify|are textures elsewhere supported? I tested this for the pause menu background and it seemed to work}} support a {{code|.mcmeta}} file in JSON format containing additional effects to apply to the texture. The file is contained in the same directory as the texture, and has the same name as the texture, except appended with {{code|.mcmeta}}. For example, the file {{code|pumpkinblur.png}} can have a properties file called {{code|pumpkinblur.png.mcmeta}}

<div class="treeview">
*{{nbt|compound}} The root tag 
**{{nbt|compound|texture}}: Contains data for the texture
***{{nbt|boolean|blur}}: Causes the texture to blur when viewed from close up. Defaults to {{code|false}}
***{{nbt|boolean|clamp}}: Causes the texture to stretch instead of tiling in cases where it otherwise would, such as on the shadow. Defaults to {{code|false}}
***{{nbt|int-array|mipmaps}}: Custom mipmap values for the texture
</div>

If the {{code|.mcmeta}} file does not exist in the pack and the texture does, the game loads the default settings, rather than loading a {{code|.mcmeta}} file from a pack below that pack.

==== Texts ====
Two text files in UTF-8 format and one JSON file exist in {{file|directory|assets/minecraft/texts|inline=1}}. They are used to display specific untranslated text.

The file {{file|file|end.txt|inline=1}} contains the text of the [[Minecraft:End Poem]], using [[Minecraft:formatting codes]] to apply the colors to the two speakers, and with the text {{code|PLAYERNAME}} being replaced with the player's name. After that file is shown, [[Minecraft:Credit sequence|credits]] based on contents of {{file|file|credits.json|inline=1}} are shown.

The following [[Minecraft:JSON]] format is used for {{file|file|credits.json|inline=1}}:
<div class="treeview">
*{{nbt|list}} The root list
**{{nbt|string|section}}: Title of this section
**{{nbt|list|disciplines}}: List of disciplines in this section
***{{nbt|string|discipline}}: Name of this discipline
***{{nbt|list|titles}}: List of titles(roles) credit given to
****{{nbt|string|title}}: Name of title
****{{nbt|list|names}}: List of people's names in this title
</div>

The file {{file|file|splashes.txt|inline=1}} contains texts separated by LF line breaks used as [[Minecraft:splash]]es.

==== Texture sheets ====
{{main|Texture atlas/Predefined}}
''Minecraft'' generally does not store multiple different textures in combined sheets and instead stores them in separate files. The only current exceptions are [[Minecraft:experience orb]]s.<ref>https://feedback.minecraft.net/hc/en-us/community/posts/360058097892-Split-up-the-experience-orb-texture-file-into-individual-sprites</ref>

==== Regional compliancies warnings ====
Regional compliancies warnings can be customized in {{file|file|assets/''[[Minecraft:namespace]]''/regional_compliancies.json|inline=1}}.

<div class="treeview"> 
*{{nbt|compound}} The root tag
**{{nbt|list|''Region''}}: Contains a list of warnings. Note that the key itself is an {{wikipedia|ISO 3166-1 alpha-3}} region code determined by the device's locale setting.  
***{{nbt|compound}} An individual warning message
****{{nbt|int|delay}}: Optional. Defines how long should the game wait until showing this message in minutes. This can not be zero.
****{{nbt|int|period}}: The time interval this message should be shown in minutes. This can not be zero.
****{{nbt|string|title}}: The translation identifier of the title of the message. A slot is provided for the translation string, containing how many times this warning has been shown.
****{{nbt|string|message}}: The translation identifier of the message. A slot is provided for the translation string, how many times this warning has been shown.
</div>

The game includes a compliancy warning for South Korea (<code>KOR</code>) about excessive playing, shown every hour and telling the exact number of hours the game is open for. An additional warning is shown if the game is open for a day or more.

=== Default resource pack ===
The default resource pack is special, as it does not exist in the same form as other resource packs. It combines assets from two sources: the {{File|directory|assets|inline=1}} directory in [[Minecraft:client.jar]] and the asset object store.

The default resource pack also provides the other built-in resource packs, as regular resource pack ZIP files.

==== Asset object store ====
The asset object store is a system used to efficiently download, store and retrieve assets across multiple versions. It resides in {{File|directory|assets|inline=1}} inside the launcher {{File|directory|[[Minecraft:.minecraft]]|inline=1}} directory.

The path to the directory of the store is provided to the game with the <code>--assetsDir</code> command line parameter. The ID of the asset index, describing asset metadata for a specific version, is provided with the <code>--assetIndex</code> command line parameter.

Asset files for all versions are stored inside {{File|directory|objects|inline=1}}, in subdirectories named with two hexadecimal digits (0-f), for example {{File|directory|7f|inline=1}}. The names correspond to the first two digits of the SHA1 hashes of the asset files stored inside. The asset files inside are named with their full SHA1 hash, which is 40 hexadecimal digits (without a filename extension), for example {{File|file|7f7777e5d5b163c5d64201fd53e5682599548a49|inline=1}}.

For the game to find assets, the asset index corresponding to the version is required. Indexes are stored in {{File|directory|indexes|inline=1}}. An index is a [[Minecraft:JSON]] file named {{File|file|''id''.json|inline=true}}, where ''id'' is the index ID. The file structure is as follows:

<div class="treeview">
* {{Nbt|compound|}}: The root object
** {{Nbt|compound|objects}}
*** {{Nbt|compound|''id''}}: Asset (object) data, where ''id'' is the asset ID
**** {{Nbt|string|hash}}: SHA1 hash of the asset, which allows to find the asset in the {{File|directory|objects|inline=1}} directory
**** {{Nbt|double|size}}: Size of the asset, in bytes
</div>

The mapping of versions to asset index IDs is as follows:

{| class="wikitable"
|-
! Version !! Asset index ID
|-
| 26.1 || 30
|-
| 1.21.11 || 29
|-
| 1.21.10 || 27
|-
| 1.21.9 || 27
|-
| 1.21.8 || 26
|-
| 1.21.7 || 26
|-
| 1.21.6 || 26
|-
| 1.21.5 || 24
|-
| 1.21.4 || 19
|-
| 1.21.2 || 18
|-
| 1.21 || 17
|-
| 1.20.5 || 16
|-
| 1.20.3 || 12
|-
| 1.20.2 || 8
|-
| 1.20 || 5
|-
| 1.19.3 || 2
|-
| 1.13 || 1.13
|-
| 1.12 || 1.12
|}

== ''Bedrock Edition'' ==
{{Warning|section=1|'''Warning''': [[Minecraft:Ore UI]] is hard-coded and cannot be modified by resource packs.<ref>{{tweet|Volgar|1866176785815392544|No. Allowing directly changing screens is what made improving the UI design of Minecraft impossible: any change breaks existing mods. It's the same reason why there is a graveyard of abandoned mods for Java Minecraft – not every modder has time to make updates for every release.}}</ref><ref>{{cite|url=https://wiki.bedrock.dev/json-ui/json-ui-intro.html#introduction|title=Intro to JSON UI|website=Bedrock Wiki|date=April 1, 2024}}</ref><ref>{{bug|MCPE-180757|MCPE-180757|HBUI texture files are not in the "resource_packs" folder|WAI}}</ref>}}
=== Behavior ===
[[File:BE Global Resources settings.png|thumb|The global resources tab in the settings.]]
[[File:Ore UI - Create New World Screen Menu "Resource Packs" Tab Settings (Bedrock).png|thumb|The resource packs tab in the Create New World screen.]]
Similarly to [[Minecraft:behavior pack]]s, resource packs can be created and imported {{in|be}}. Users can download external resource packs with the {{cd|.mcpack}} [[Minecraft:File extensions|file extension]], if the game platform allows file importation. When these files are opened, they are automatically imported into the {{code|resource_packs}} directory in {{code|[[Minecraft:com.mojang]]}} without any need for file system access. Resource packs can also be put manually in the {{code|development_resource_packs}} directory. Each resource pack must either be a subdirectory or a {{code|.zip}} file.

Resource packs can be applied locally on the Global Resources option from the [[Minecraft:settings]] menu from the main menu screen. Resource packs can be moved between "Active" and "My Packs". 

One or more resource packs can be bundled with a world from the [[Minecraft:Create New World]] and [[Minecraft:Edit World]] screens. These resource packs will be imported into the world files, and are kept when exporting the world. Players joining a [[Minecraft:multiplayer]] world with resource packs get an option to download the resource pack or not. When "Shared packs" (or {{code|texturepack-required}} in [[Minecraft:server.properties]]) is enabled, all global resources will be ignored and players are forced to download and enable all resource packs stored in the world files. Developmental resource packs cannot be applied to worlds on [[Minecraft:Realms]], but worlds uploaded to Realms or [[Minecraft:Bedrock Dedicated Server]] keep the resource packs applied to the world.

In Bedrock Dedicated Server, resource packs also can be stored outside of worlds. Packs need to be enabled in the {{Cd|world_resource_packs.json}} file in a world file. 

Resource packs load their assets based on the order of the packs on the list. The bottom-most pack loads first, then each pack placed above it replaces assets of the same name with its assets. Global resources are always applied above world resource packs.

Resource packs cannot be edited unless put into the {{code|development_resource_packs}} directory, and will update themselves when joining a world or changing active resource packs.

==== Settings ====
Resource packs can contain custom settings that affect features in the pack.<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/addons/custompacksettings?view=minecraft-bedrock-stable|title=Creating a Pack with Custom Settings|website=Microsoft Learn|date=August 1, 2025}}</ref> Settings need to be specified in {{Cd|[[Minecraft:manifest.json]]}}, with the options to create an on/off toggle, or a slider with specific values. The settings menu for custom and Marketplace resource packs can be opened with a button next to the pack button in the edit world screen to change settings for the whole world, or in the pack description in the global resources settings to change settings locally. Custom labels for each setting can be applied, which support text [[Minecraft:Formatting codes|formatting]].

Custom settings currently can't affect any features in the resource pack, but Mojang Studios plans to create a [[Minecraft:Molang]] query function for this purpose.

The settings menu can also be used to change the memory tier, which affects the [[Minecraft:Add-on#Sub-packs|sub-packs]] being used.<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/buildingsubpacks?view=minecraft-bedrock-stable|title=Building Sub-Packs|website=Microsoft Learn|date=August 28, 2025}}</ref> The memory tier can be set to any specified value from the device's memory tier and lower. Sub-packs are resource packs within the root of the behavior pack, with the same directory structure. They can be added to the pack in {{Cd|manifest.json}}.

==== Marketplace resource packs ====
[[Minecraft:Add-ons]] and worlds from the [[Minecraft:Marketplace]] often contain or consist entirely of a resource pack. These packs are stored internally and can't be accessed from {{code|[[Minecraft:com.mojang]]}}. Players can only access Marketplace resource packs or play on worlds with resource packs applied when they own the pack, by purchasing it in the Marketplace or by owning the [[Minecraft:Marketplace Pass]]. Which packs a player owns is stored in the online player profile, so resource packs can only be accessed when signed in. Marketplace packs can be applied the same way as custom resource packs including Realms, but not to worlds in external servers.

When a player joins a multiplayer world or Realm with Marketplace packs, the player is offered to download these packs to apply them, even when the player does not own the pack.

Marketplace resource packs update automatically depending on the "Auto Update Unlocked Packs" settings, or can be updated manually from the purchase screen.

==== Built-in resource pack ====

There is currently one resource pack that is included as part of the game.

{| class="wikitable"
|-
! Pack name !! Pack description !! Description
|-
| [[File:Default pack.png|32px]] [[Minecraft:Resource pack#Internal resource packs|Minecraft Texture Pack]] || The default Minecraft graphics, now updated with stylish new textures! || Selected by default, can't be unselected. Contains essential files.
|}

=== Directory structure ===
Resource packs in ''Bedrock Edition'' use the following directory structure:<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/documents/comprehensivepackcontents?view=minecraft-bedrock-stable|title=Comprehensive List of Add-On Pack Contents|website=Microsoft Learn}}</ref>

<div class="treeview">
*{{File|directory|''name''}} or {{File|archive|''name''.zip}}
** {{File|file|[[Minecraft:Resource pack#Default values|biomes_client.json]]}}. Used to define some fallback values for biomes without settings in {{File|directory|biomes|inline=1}}, overwriting all vanilla settings.
** {{File|file|blocks.json}}
** {{File|file|bug_pack_icon.png}}: The picture to display next to the resource pack in the settings in-game when it cannot be loaded.
** {{File|file|[[Minecraft:manifest.json]]}}
** {{File|file|pack_icon.png}}: The picture to display next to the resource pack in the settings in-game.
** {{File|file|sounds.json}}
** {{File|file|splashes.json}}: Contains [[Minecraft:splash]] texts.
** {{File|directory|''[[Minecraft:Add-on#Sub-pack|sub-pack]]''}}: A resource pack with the same directory structure inside the resource pack, which can be toggled as a setting in-game. Multiple sub-packs can be used, and need to be specified in {{File|file|[[Minecraft:manifest.json]]|inline=1}}.
** {{File|directory|animation_controllers}}
*** {{File|file|''entity''_animation_controllers.json}}
** {{File|directory|animations}}
*** {{File|file|''entity''.animation.json}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Atmospherics|atmospherics]]}}{{Fn||name=pbr}}
***{{File|file|atmospherics.json}}: Contains default atmospherics configurations for [[Minecraft:Vibrant Visuals]].
***{{File|file|''location''.json}}: Contains atmospherics configurations for specified locations.
** {{File|directory|attachables}}
*** {{File|file|''attachable_entity_name''.json}}
**{{File|directory|[[Minecraft:Resource pack#Biomes|biomes]]}}
***{{File|file|''biome''.client_biome.json}}: Contains some settings for individual biomes, including [[Minecraft:music]] and what location identifiers for each Vibrant Visuals setting should be used.
** {{File|directory|block_culling}}
*** {{File|file|''block''_culling.json}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Color grading|color_grading]]}}{{Fn||name=pbr}}
***{{File|file|color_grading.json}}: Contains default configurations for color grading and tone mapping in Vibrant Visuals.
***{{File|file|''location''.json}}: Contains color grading and tone mapping configurations for specified locations.
**{{File|directory|[[Minecraft:Vibrant Visuals#Cubemaps|cubemaps]]}}{{Fn||name=pbr}}
***{{File|file|''cubemap''.json}}: Contains configurations for cubemaps in Vibrant Visuals for specified locations.
** {{File|directory|entity}}
*** {{File|file|''entity''.entity.json}}{{fn|File may be inside a directory.|name=May be inside a directory}}
** {{File|directory|[[Minecraft:Fog definition|fogs]]}}
*** {{File|file|default_fog_settings.json}}: Contains default configurations for [[Minecraft:fog]].
*** {{File|file|''location''.json}}: Contains fog configurations for specified locations.
** {{File|directory|items}}
*** {{File|file|''item''.json}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Lighting|lighting]]}}{{Fn||name=pbr}}
***{{File|file|global.json}}: Contains configurations for global light sources in Vibrant Visuals, including the sun, moon, End flash, emissiveness, ambient lighting, and sky lighting.
***{{File|file|''location''.json}}: Contains configurations for global light sources for specified locations.
**{{File|directory|[[Minecraft:Vibrant Visuals#Lighting|local_lighting]]}}{{Fn||name=pbr}}
***{{File|file|local_lighting.json}}: Contains settings for local lighting for individual blocks in Vibrant Visuals.
** {{File|directory|materials}}
*** {{File|file|''entity''.material}}
** {{File|directory|models}}
*** {{File|file|''entity''.geo.json}}{{fn|File may be inside a directory.|name=May be inside a directory}}
** {{File|directory|particles}}
*** {{File|file|''particle''.json}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Fallback values|pbr]]}}{{Fn||name=pbr}}
***{{File|file|global.json}}: Contains default MERS values for different object types when no texture set is provided for an object in Vibrant Visuals.
** {{File|directory|render_controllers}}
*** {{File|file|''entity''_render_controllers.json}}
*** {{File|file|default.render_controllers.json}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Shadows|shadows]]}}{{Fn||name=pbr}}
***{{File|file|global.json}}: Contains settings for shadow effects in Vibrant Visuals.
** {{File|directory|sounds}}
*** {{File|file|music_definitions.json}}
*** {{File|file|sound_definitions.json}}
*** {{File|file|''sound''.fsb}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''sound''.ogg}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''sound''.wav}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''sound''.mp3}}{{fn|File may be inside a directory.|name=May be inside a directory}}{{fn|.mp3 files aren't fully supported.}}
** {{File|directory|texts}}
*** {{File|file|languages.json}}
*** {{File|file|language_names.json}}
*** {{File|file|''<languagecode>''_''<COUNTRYCODE>''.lang}}
***{{File|file| ''<languagecode>''_''<COUNTRYCODE>''}}{{fn|For languages using a different font.}}
**** {{File|directory|font}}{{fn|Directory may be at the root of the resoursepack instead of in the texts directory|.name=May be at root}}
***** {{File|file|ascii_sga.png}}{{fn|Deprecated? (needs confirmation)|.name=Deprecated?}}
***** {{File|file|default8.png}}{{fn|Deprecated? (needs confirmation)|.name=Deprecated?}}
***** {{File|file|font_metadata.json}}{{fn|Existence confirmed, purpose unknown|.name Usage unknown at this time}}
***** {{File|file|glyph_''code''.png}}
** {{File|directory|textures}}
*** {{File|file|flipbook_textures.json}}
*** {{File|file|terrain_texture.json}}
*** {{File|file|textures_list.json}}
*** {{File|file|''texture''.png}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''texture''.tga}}{{fn|File may be inside a directory.|name=May be inside a directory}}
** {{File|directory|ui}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''graphic''.png}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''graphic''.jpg}}{{fn|File may be inside a directory.|name=May be inside a directory}}
*** {{File|file|''file''.json}}{{fn|File may be inside a directory.|name=May be inside a directory}}
**{{File|directory|[[Minecraft:Vibrant Visuals#Water|water]]}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***{{File|file|water.json}}: Contains configurations for water effects in Vibrant Visuals, including particles, waves, and caustics.
***{{File|file|''location''.json}}: Contains water configurations for specified locations.
</div>

{{fnlist}}

=== Contents ===
{{Expand section|Include information about all contents of a resource pack, either here or on a separate page.}}

==== Biomes ====
JSON files in the {{File|directory|biomes|inline=1}} directory define client-side environmental settings that change per [[Minecraft:biome]].<ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/clientbiomesreference/examples/clientbiomesoverview?view=minecraft-bedrock-stable|title=Client Biome JSON and Overview|website=Microsoft Learn}}</ref><ref>{{Cite|url=https://learn.microsoft.com/en-us/minecraft/creator/reference/content/clientbiomesreference/examples/componentlist?view=minecraft-bedrock-stable|title=Client Biomes Documentation|website=Microsoft Learn}}</ref> They are named like <code>''[[Minecraft:Biome/ID|biome ID]]''.client_biome.json</code>.<div class="treeview">
* {{nbt|compound}} The root tag
** {{nbt|string|format_version}}: The 3-part schema version used in the file. It needs to be at least <code>"1.21.40"</code>, any newer minor releases can be used.
** {{nbt|compound|minecraft:client_biome}}
*** {{nbt|compound|description}}
**** {{nbt|string|identifier}}: The unique [[Minecraft:Biome/ID|identifier]] of the biome, without a namespace.
*** {{nbt|compound|components}}
**** {{nbt|compound|minecraft:ambient_sounds}}: Regular [[Minecraft:ambience]] and underwater ambience for the biome.
***** {{nbt|string|addition}}: Named sound that occasionally plays at the listener position.
***** {{nbt|string|loop}}: Named sound that loops while the listener position is inside the biome.
***** {{nbt|string|mood}}: Named sound that rarely plays at a nearby air block position when the light level is low, which defaults to <code>ambient.cave</code>.
***** {{nbt|compound|underwater_addition}}
****** {{nbt|string|asset}}: Named sound that occasionally plays at the listener position underwater.
****** {{nbt|float|chance}}: How commonly this loop addition plays.
***** {{nbt|string|underwater_loop}}: Named sound that loops while the listener position is inside the biome underwater.
**** {{nbt|compound|minecraft:atmosphere_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|atmosphere_identifier}}: The identifier of the [[Minecraft:Vibrant Visuals]] atmospherics configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Atmospherics|atmospherics]]|inline=1}}.
**** {{nbt|compound|minecraft:biome_music}}
***** {{nbt|string|music_definition}}: The set of [[Minecraft:music]] to be played in this biome, which can be defined in {{File|file|music_definitions.json|inline=1}}. Empty will result in no music in this biome.
***** {{nbt|float|volume_multiplier}}: A multiplier added to music volume while in the biome, between 0 and 1.
**** {{nbt|compound|minecraft:color_grading_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The identifier of the Vibrant Visuals color grading configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Color Grading|color_grading]]|inline=1}}.
**** {{nbt|compound|minecraft:cubemap_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|cubemap_identifier}}: The identifier of the Vibrant Visuals cubemap configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Cubemaps|cubemaps]]|inline=1}}.
**** {{nbt|compound|minecraft:dry_foliage_color}}
***** {{nbt|string}}{{nbt|int array|color}}: The color of dry foliage used to color [[Minecraft:Leaf Litter|leaf litter]]; supports HEX string or RGB array. When not specified, the color is calculated with [[Minecraft:Dry foliage.png|<code>dry_foliage.png</code>]], which is based on temperature.
**** {{nbt|compound|minecraft:fog_appearance}}
***** {{nbt|string|fog_identifier}}: The identifier of the [[Minecraft:fog]] definition used for this biome, with a namespace.
**** {{nbt|compound|minecraft:foliage_appearance}}
***** {{nbt|compound}}{{nbt|string|color}}: The color for biome-tinted [[Minecraft:foliage]]; supports HEX string or an object with a colormap.
****** {{nbt|string|color_map}}: The name of a colormap placed in {{File|directory|textures/colormaps|inline=1}}, without the <code>.png</code> suffix.
**** {{nbt|compound|minecraft:grass_appearance}}
***** {{nbt|compound}}{{nbt|string|color}}: The color for biome-tinted [[Minecraft:grass blocks]]; supports HEX string or an object with a colormap.
****** {{nbt|string|color_map}}: The name of a colormap placed in {{File|directory|textures/colormaps|inline=1}}, without the <code>.png</code> suffix.
**** {{nbt|compound|minecraft:precipitation}}: Visuals of a biome's [[Minecraft:precipitation]]. Only one type can be set.
***** {{nbt|float|ash}}: Density of ash particles and visuals from [[Minecraft:Basalt Deltas|basalt deltas]].
***** {{nbt|float|blue_spores}}: Density of blue spore particles and visuals from [[Minecraft:Warped Forest|warped forests]].
***** {{nbt|float|red_spores}}: Density of red spore particles and visuals from [[Minecraft:Crimson Forest|crimson forests]].
***** {{nbt|float|white_ash}}: Density of white ash particles and visuals from [[Minecraft:Soul Sand Valleys|soul sand valleys]].
**** {{nbt|compound|minecraft:lighting_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The identifier of the Vibrant Visuals lighting configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Lighting|lighting]]|inline=1}}.
**** {{nbt|compound|minecraft:sky_color}}
***** {{nbt|string}}{{nbt|int array|color}}: The color of the [[Minecraft:sky]] without Vibrant Visuals; supports HEX string or RGB array.
**** {{nbt|compound|minecraft:water_appearance}}
***** {{nbt|string}}{{nbt|int array|surface_color}}: The color of the [[Minecraft:water]] surface without Vibrant Visuals; supports HEX string or RGB array.
***** {{nbt|float|surface_opacity}}: The opacity of the water surface without Vibrant Visuals, between 0 (invisible) and 1 (opaque).
**** {{nbt|compound|minecraft:water_identifier}}{{Fn|Only in resource packs with <code>"pbr"</code> capability|name=pbr}}
***** {{nbt|string|color_grading_identifier}}: The identifier of the Vibrant Visuals water configurations used for this biome, in {{File|directory|[[Minecraft:Vibrant Visuals#Water|water]]|inline=1}}.
</div>
{{fnlist}}

===== Default values =====
In the <code>biomes_client.json</code> file in the root of the resource pack, fallback values for all biome settings can be provided under the objects <code>biomes</code> <code>default</code>. These settings will be used for all biomes that don't provide them in their own client biome JSON files, and it will override all vanilla settings.

=== Internal resource packs ===
Most entities, biomes, loot tables, and various things from the base game are defined by the vanilla resource pack, which is built inside the game itself and can be found at {{cd|[[Minecraft:Microsoft.MinecraftUWP|''game directory'']]\data\resource_packs}}. Mojang Studios releases the [https://github.com/Mojang/bedrock-samples Bedrock Add-On Sample Files] with every new [[Minecraft:update]] of ''Bedrock Edition'', which provide the latest vanilla behavior and resource packs from the game.

Multiple internal resource packs exist for different situations. Some [[Minecraft:experiments]] may have their own resource pack, in addition to ''[[Minecraft:Minecraft Education]]'' features and ''[[Minecraft:Minecraft Preview]]''. Each resource pack contains the same structure and assets as custom resource packs, defined for the whole game. Some packs also have an icon or description, which is not visible in-game.

''Bedrock Edition'' supports backwards-compatibility for add-ons and old worlds. This is done for the {{cd|vanilla}} and {{cd|chemistry}} resource packs since [[Minecraft:Bedrock Edition 1.14.0|1.14]] and [[Minecraft:Bedrock Edition 1.20.50|1.20.50]] respectively, with the regular resource pack supporting the latest version before. Each update with changes to features defined in resource packs has its own resource packs, with all the features that changed. Some Marketplace add-ons can lock a world in an older version by disabling internal resource packs from higher versions.
{| class="wikitable"
|-
!File name
! Pack icon, name, and description !! Description
|-
|beta
| [[File:Beta pack icon.jpg|32px]]|| Resources for [[Minecraft:Version types#Betas and previews|beta]] versions of the game. Contains a unique [[Minecraft:logo]], [[Minecraft:splashes]], [[Minecraft:panorama]], and [[Minecraft:loading tips]].
|-
|cdn
|[[File:Pack icon.png|width=32x32]] SoulSteel
SoulSteel pack
|Contains some resources for the button and animations on the [[Minecraft:Title Screen|title screen]] promoting the [[Minecraft:SoulSteel]] featured server. Unlike other packs, this is stored in {{Cd|%appdata%\Minecraft Bedrock}}, similar to <code>[[Minecraft:com.mojang]]</code>.
|-
|chemistry
|[[File:Chemistry Pack icon.png|32px]]
|Resources for the "Minecraft Education features" [[Minecraft:World Options#Cheats|cheat setting]]. Includes several features from the [[Minecraft:Chemistry Update]] in ''[[Minecraft:Minecraft Education]]''. Multiple versions of this pack are available to support backwards-compatibility.
|-
|editor
|[[File:Editor pack icon.png|32px]]
|Resources for ''[[Minecraft:Bedrock Editor]]'', applied when the Editor is enabled upon launch. Contains five unique [[Minecraft:entities]] exclusive to the Editor, some textures for the GUI, and the compass on the HUD. This pack does not contain all features from the Editor GUI because that uses [[Minecraft:Ore UI]] and is hard-coded outside of resource packs.
|-
|experimental_deferred_technical_preview
|Experimental RenderDragon Features for Creators resource pack
|Contains features from the "Render Dragon for Creators" [[Minecraft:Experiments|experiment]], available in ''[[Minecraft:Preview]]'' only. It contains all default configurations for local lighting in [[Minecraft:Vibrant Visuals]], such as [[Minecraft:Colored lighting|light colors]].
|-
|experimental_y_2026_drop_1
|Drop 1 of 2026<br>Experimental resource pack for Drop 1 of 2026 content
|Adds resources for [[Minecraft:Tiny Takeover]], including new textures, models, and sounds of [[Minecraft:baby mobs]] and more.
|-
|experimental_y_2026_drop_2
|Drop 2 of 2026
Experimental resource pack for Drop 2 of 2026 content
|Adds features for Chaos Cubed, including the [[Minecraft:Sulfur Caves|sulfur caves]], [[Minecraft:Sulfur Cube|sulfur cube]], [[Minecraft:cinnabar]], and [[Minecraft:sulfur]].
|-
|furnace_recipe_book
|furnace recipe book
|Adds resources for the experimental smelting [[Minecraft:recipe book]], including the UI, texts, and textures.
|-
|oreui
|[[File:Default pack.png|32px]] Minecraft UI Resource Pack
The default Minecraft UI resources.
|Translations for [[Minecraft:Ore UI]] menu screens.
|-
|persona
|[[File:Persona Test Pack.png|32px]] Persona Built-in Pack
|Contains all individual cosmetics and some UI elements for the [[Minecraft:default skins]] in the [[Minecraft:Character Creator]].
|-
|platform_gdk_pc
|
|Contains few texts for the GDK build of ''Minecraft Preview''.
|-
|previewapp
|
|Resources for ''Minecraft Preview''. Contains a unique [[Minecraft:logo]], [[Minecraft:splashes]], [[Minecraft:panorama]], and [[Minecraft:loading tips]].
|-
|vanilla
|[[File:Default pack.png|32px]] 
|All resources for the default ''Minecraft'' game. Multiple versions of this pack are available to support backwards-compatibility.
|-
|vanilla_base
|
|Contains few basic resources for the game, such as the [[Minecraft:crosshair]] texture and the initial loading screen.
|-
|vanilla_music
|
|Contains all game [[Minecraft:music]] files and Nether [[Minecraft:ambience]].
|-
|vanilla_trial
|
|Contains UI elements for the [[Minecraft:Demo Mode|trial]] version of the game.
|}

== History ==
{{cleanup|section=1|Should we remove the pack number changes since we have a dedicated page for that now?}}
{{for|the history of resource pack format numbers specifically|Pack format#Resource pack format history}}

=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.6.1|dev=13w24a|Added resource packs, replacing the functionality of [[Minecraft:texture pack]]s.
|[https://web.archive.org/web/20211215093936if_/http://s3.amazonaws.com/Minecraft.Download/utilities/TextureEnder.jar Minecraft Texture Ender] is available from Mojang to automatically convert 1.5 compatible texture packs to resource packs. See [[Minecraft:Java Edition 1.6.1/Resource pack changes]] for the list of file names changed.}}
|{{HistoryLine||1.6.2|dev=reupload|slink=Java Edition 1.6.2#Reuploads|Fixed distorted font when HD font is used.<ref>{{bug|MC-17673||Distorted fonts when using a converted texturepack on startup|Fixed}}</ref>}}
|{{HistoryLine||1.7.2|dev=13w36a|Added the ability to apply multiple resource packs at once.
|Servers can now recommend a default resource pack via the server-side resource packs system.<ref>{{Bug|MC-18569||Server resourcepacks not implemented yet|Fixed}}</ref><ref>https://mcupdate.tumblr.com/post/65040832258/minecraft-172</ref>}}
|{{HistoryLine|||dev=13w42a|Moved files from {{cd|assets/minecraft/music}} to {{cd|assets/minecraft/sounds/music}} and files from {{cd|assets/minecraft/sound}} to {{cd|assets/minecraft/sounds}}.}}
|{{HistoryLine||1.7.4|dev=13w47a|The {{code|description}} value of {{code|pack.mcmeta}} can now use the [[Minecraft:text component format]].}}
|{{HistoryLine|||dev=13w48a|Removed the ability to change the Mojang logo.}}
|{{HistoryLine||1.8|dev=14w06a|Added the ability to change the [[Minecraft:block models]].}}
|{{HistoryLine|||dev=14w07a|Resource packs can now be bundled with a map.}}
|{{HistoryLine|||dev=14w25a|The model format now supports custom item models.
|Textures can now be specified for blocks and items.
|Added the {{cd|interpolate}} tag for animations.}}
|{{HistoryLine||1.8.8|dev=pre|Resource packs now display an error if the format number is wrong. At this time, it requires a format number of {{cd|1}}.}}
|{{HistoryLine||1.9|dev=15w31a|Changed format number to {{cd|2}}, due to changes in the [[Minecraft:model]] system, such as [[Minecraft:Model#Item tags|item tags]], [[Minecraft:Model#Block states|multipart]], and changes to display tags.
|Using resource packs with outdated display tags causes the models to seem abnormally up-scaled and the wielded block cannot be rotated in the hand, along with blocks in the inventory replaced with a 2D texture. This is similar to what happens when a model has no display tags. See [https://web.archive.org/web/20190710004554/http://i.imgur.com/7wilQfO.png here] for an example.}}
|{{HistoryLine||1.11|dev=16w32a|Resource packs version number changed to {{cd|3}}, due to the change that all files should have lowercase letters.}}
|{{HistoryLine||1.13|dev=17w43a|The default resource pack can now be moved up and down, just like other resource packs.}}
|{{HistoryLine|||dev=17w48a|Changed format number to {{cd|4}}, due to ''[[Minecraft:The Flattening]]''. See [[Minecraft:Java Edition 1.13/Resource pack changes]] for the list of file names changed.}}
|{{HistoryLine|||dev=pre7|Several punctuation characters in {{code|ascii.png}} were shortened by one pixel, either vertically or horizontally. A stray pixel on the {{key|Ø}} character was also removed.}}
|{{HistoryLine|||dev=pre8|Several more punctuation characters in {{code|ascii.png}} were shortened and the {{key|@}} was lowered by one pixel.}}
|{{HistoryLine||1.14|dev=18w45a|Added "Programmer Art – The classic look of Minecraft" to the resource pack menu, due to the old textures being replaced by new ones in the ''[[Minecraft:Texture Update]]''.}}
|{{HistoryLine|||dev=19w06a|Significantly improved resource pack loading speed.<ref>{{tweet|Dinnerbone|1093575528794214400|It should have already affected resource pack loading! It's all the same thing internally.|February 7th, 2019}}</ref>
|[[Minecraft:Particles]] textures are now split into individual files.}}
|{{HistoryLine|||dev=19w07a|[[Minecraft:Painting]] textures are now split into individual files.}}
|{{HistoryLine|||dev=19w08a|[[Minecraft:Status effect]] textures are now split into individual files.}}
|{{HistoryLine|||dev=19w09a|Particles are now configurable.}}
|{{HistoryLine||1.15|dev=Pre-release 1|Changed format number to {{cd|5}}, due to texture mechanic changes in earlier snapshots.}}
|{{HistoryLine||1.16.2|dev=Release Candidate 1|Changed format number to {{cd|6}}, due to changes to wall blocks made in 1.16 according to {{bug|MC-197275}}.}}
|{{HistoryLine||1.17|dev=20w45a|Changed format number to {{cd|7}}.}}
|{{HistoryLine|||dev=21w05a|Improved performance when using many overrides on an item model.
|toasts.png GUI texture has a new icon for the bundle tutorial.}}
|{{HistoryLine|||dev=pre1|The file {{code|credits.txt}} in {{code|assets/minecraft/texts}} was changed to {{code|credits.json}}, and the format also changed from plain text to structured JSON format.}}
|{{HistoryLine||1.18|dev=21w37a|Added {{cd|illageralt}}, the rune-like font from ''[[Minecraft:Minecraft Dungeons]]'' (currently usable only via commands).}}
|{{HistoryLine|||dev=21w39a|Changed format number to {{cd|8}}, because [[Minecraft:inventory.png]] now contains an extra sprite for a thin-layout version of the effect list in the inventory.}}
|{{HistoryLine||1.18.2|dev=22w06a|Added {{code|assets/minecraft/regional_compliancies.json}} to control the gameplay timer and in-game notice strings as to respect the compliance requirements in South Korea. For South Korea only by default.}}
|{{HistoryLine||1.19|dev=22w11a|Changed format number to {{cd|9}}, due to new {{cd|filter}} section in pack.mcmeta.}}
|{{HistoryLine||1.19.3|dev=22w42a|Changed format number to {{cd|11}}, due to the removal of "fixers" for resource packs with format numbers {{cd|3}} and {{cd|4}}.}}
|{{HistoryLine|||dev=22w45a|Changed format number to {{cd|12}}.}}
|{{HistoryLine||1.19.4|dev=23w07a|The vanilla resource pack <code>en_us</code> language file is now sorted alphanumerically by key.}}
|{{HistoryLine|||dev=pre1|Added a built-in "High Contrast" resource pack that enhances the contrast of UI elements.|Changed format number to {{cd|13}}, due to the enchantment glint now being separate between entities and items.}}
|{{HistoryLine||1.20|dev=23w14a|Changed format number to {{cd|14}} due to updates to the layout of {{cd|minecraft.png}} and {{cd|invite_icon.png}}.}}
|{{HistoryLine|||dev=23w17a|Changed format number to {{cd|15}} due to updates to the font and the credits.|{{cd|uniform}} font has been updated to use Unifont 15.0.01.}}
|{{HistoryLine|||dev=Pre-release 5|{{cd|uniform}} font has been updated to use Unifont 15.0.03.}}
|{{HistoryLine||1.20.2|dev=23w31a|Changed format number to {{cd|16}}.
|The process of upgrading a pack can now be assisted by using an automated Slicer tool.<ref>https://github.com/Mojang/slicer/releases/tag/v1.1</ref>}}
|{{HistoryLine|||dev=23w32a|Changed format number to {{cd|17}}.|The text field background is now a nine-sliced sprite at <code>widget/text_field</code> and <code>widget/text_field_highlighted</code>.|The scroll bar in lists and text fields is now a nine-sliced sprite at <code>widget/scroller</code>.}}
|{{HistoryLine|||dev=1.20.2 Pre-release 2|Changed format number to {{cd|18}}.}}
|{{HistoryLine||1.20.3|dev=23w42a|Changed format number to {{cd|19}}.|Added block model, item model and block state definitions for <code>crafter</code>.|Added GUI container texture and sprites for <code>crafter</code>.|Added <code>white_smoke</code> particle definition.}}
|{{HistoryLine|||dev=23w43a|Changed format number to {{cd|20}}.|<code>bat.png</code> has been updated for the new bat model.|Added block models, items models, block state definitions  and unique sprites for new blocks.}}
|{{HistoryLine|||dev=23w45a|Changed format number to {{cd|21}}.|<code>uniform</code> font has been updated to use Unifont 15.1.04 (from 15.0.06).|The only supported texture format is now <code>.png</code>.|Added entity models and textures for experimental breeze mob {{cd|d=,|breeze|wind_charge}}.|Added shader <code>breeze_wind</code>.}}
|{{HistoryLine|||dev=Pre-Release 1|Changed format number to {{cd|22}}.|Changes to downloaded/world resource pack handling.|UI Download screen has been replaced with a toast.|World resource pack application starts together with chunk loading.|Downloaded packs are now stored in downloads directory (with different file organization than old server-resource-packs).|Downloaded packs now have unique id (GUID/UUID) that can be used to differentiate them.}}
|{{HistoryLine||1.20.5|dev=24w03a|Changed format number to {{cd|24}}.}}
|{{HistoryLine|||dev=24w05a|Changed format number to {{cd|25}}.}}
|{{HistoryLine|||dev=24w06a|Added font variant filters to font providers.|Changed format number to {{cd|26}}.}}
|{{HistoryLine|||dev=24w09a|Changed format number to {{cd|28}} due to menu GUI changes.}}
|{{HistoryLine|||dev=24w11a|Changed format number to {{cd|29}} due to menu GUI changes.}}
|{{HistoryLine|||dev=24w12a|Changed format number to {{cd|30}} due to changes to <code>map_icons.png</code>.}}
|{{HistoryLine|||dev=24w13a|Changed format number to {{cd|31}}.}}
|{{HistoryLine|||dev=1.20.5-pre4|Changed format number to {{cd|32}}.}}
|{{HistoryLine||1.21|Changed format number to {{cd|34}}.}}
|{{HistoryLine||1.21.2|dev=24w33a|Changed format number to {{cd|35}}.}}
|{{HistoryLine|||dev=24w34a|Changed format number to {{cd|36}}.}}
|{{HistoryLine|||dev=24w36a|Changed format number to {{cd|37}}.}}
|{{HistoryLine|||dev=24w37a|Changed format number to {{cd|38}}.}}
|{{HistoryLine|||dev=24w38a|Changed format number to {{cd|39}}.}}
|{{HistoryLine|||dev=24w40a|Changed format number to {{cd|40}}.}}
|{{HistoryLine|||dev=1.21.2-pre1|Changed format number to {{cd|41}}.}}
|{{HistoryLine|||dev=1.21.2-pre3|Changed format number to {{cd|42}}.}}
|{{HistoryLine||1.21.4|dev=24w44a|Changed format number to {{cd|43}}.}}
|{{HistoryLine|||dev=24w45a|Changed format number to {{cd|44}}.|Added support for [[Minecraft:items model definition]]s in the {{code|assets/minecraft/items}} directory.}}
|{{HistoryLine|||dev=24w46a|Changed format number to {{cd|45}}.|Most blocks that previously rendered only block entity will now also render a normal block model, notably this excludes end portals and end gateways.}}
|{{HistoryLine|||dev=Pre-Release 1|Changed format number to {{cd|46}}.}}
|{{HistoryLine||1.21.5|dev=25w02a|Changed format number to {{cd|47}}.}}
|{{HistoryLine|||dev=25w03a|Changed format number to {{cd|48}}.}}
|{{HistoryLine|||dev=25w04a|Changed format number to {{cd|49}}.}}
|{{HistoryLine|||dev=25w05a|Changed format number to {{cd|50}}.}}
|{{HistoryLine|||dev=25w06a|Changed format number to {{cd|51}}.}}
|{{HistoryLine|||dev=25w07a|Changed format number to {{cd|52}}.}}
|{{HistoryLine|||dev=25w08a|Changed format number to {{cd|53}}.}}
|{{HistoryLine|||dev=25w10a|Changed format number to {{cd|54}}.|"Global" uniforms may now be defined in any shader, and the game will attempt to fill it.}}
|{{HistoryLine|||dev=Pre-Release 1|Changed format number to {{cd|55}}.}}
|{{HistoryLine||1.21.6|dev=25w15a|Changed format number to {{cd|56}}.}}
|{{HistoryLine|||dev=25w16a|Changed format number to {{cd|57}}.|All core shader uniforms are now uniform blocks.}}
|{{HistoryLine|||dev=25w17a|Changed format number to {{cd|58}}.}}
|{{HistoryLine|||dev=25w18a|Changed format number to {{cd|59}}.|All JSON files are now parsed in strict mode.|The {{cd|hud/locator_bar_arrow_up}} and {{cd|hud/locator_bar_arrow_down}} sprites are now animated with a standard {{cd|animation}} definition in the corresponding {{cd|.mcmeta}} files.}}
|{{HistoryLine|||dev=25w19a|Changed format number to {{cd|60}}.|[[Minecraft:Panorama]] textures must now all be the same size, and square.}}
|{{HistoryLine|||dev=25w20a|Changed format number to {{cd|61}}.}}
|{{HistoryLine|||dev=25w21a|Changed format number to {{cd|62}}.}}
|{{HistoryLine|||dev=pre1|Changed format number to {{cd|63}}.|Added {{cd|oversized_in_gui}} item model field.|A new special model type has been added, <code>player_head</code>, which loads textures from a profile component on the item stack.|The <code>head</code> special model type no longer loads textures from a profile component on the item stack.}}
|{{HistoryLine||1.21.7|dev=Release Candidate 2|slink=Java Edition 1.21.7 Release Candidate 2|Changed format number to {{cd|64}}.}}
|{{HistoryLine||1.21.9|dev=25w31a|Changed format number to {{cd|65.0}}.}}
|{{HistoryLine|||dev=25w32a|Changed format number to {{cd|65.1}}.}}
|{{HistoryLine|||dev=25w33a|Changed format number to {{cd|65.2}}.}}
|{{HistoryLine|||dev=25w34a|Changed format number to {{cd|66.0}}.}}
|{{HistoryLine|||dev=25w35a|Changed format number to {{cd|67.0}}.}}
|{{HistoryLine|||dev=25w36a|Changed format number to {{cd|68.0}}.}}
|{{HistoryLine|||dev=25w37a|Changed format number to {{cd|69.0}}.}}
|{{HistoryLine||1.21.11|dev=25w41a|Changed format number to {{cd|70.0}}.}}
|{{HistoryLine|||dev=25w42a|Changed format number to {{cd|70.1}}.}}
|{{HistoryLine|||dev=25w43a|Changed format number to {{cd|71.0}}.}}
|{{HistoryLine|||dev=25w44a|Changed format number to {{cd|72.0}}.|<samp>block.vsh/fsh</samp> copies <samp>terrain.vsh/fsh</samp> and handles ad-hoc blocks (e.g. held by entities).|Added {{cd|ChunkSection}} uniform, used by <samp>terrain.vsh</samp> (which replaces {{cd|DynamicTransforms}}).|New shaders have been introduced to perform GPU based sprite animations.|{{cd|Globals}} uniform now has camera coordinates.}}
|{{HistoryLine|||dev=25w45a|Changed format number to {{cd|73.0}}.}}
|{{HistoryLine|||dev=25w46a|Changed format number to {{cd|74.0}}.|The game will now print a warning if any defined sprites in any atlases share a name.|Block model and state format has been expanded to allow more rotations.}}
|{{HistoryLine|||dev=pre1|Changed format number to {{cd|75.0}}.}}
|{{HistoryLine||26.1|dev=snap1|Changed format number to {{cd|76.0}}.}}
|{{HistoryLine|||dev=snap2|Changed format number to {{cd|77.0}}.}}
|{{HistoryLine|||dev=snap3|Changed format number to {{cd|78.0}}.}}
|{{HistoryLine|||dev=snap5|Changed format number to {{cd|79.0}}.|The glow particles emitted by glow squids, lightning rods, blocks being waxed, unwaxed and scraped is now rendered as opaque, since they never actually used translucency.|Removed <samp>demo_background.png</samp> in favor of <samp>popup/background.png</samp> sprite.}}
|{{HistoryLine|||dev=snap6|Changed format number to {{cd|80.0}}.}}
|{{HistoryLine|||dev=snap7|Changed format number to {{cd|81.0}}.|Updated <samp>mule_baby.png</samp> and <samp>donkey_baby.png</samp> to fit the model properly.}}
|{{HistoryLine|||dev=snap8|Changed format number to {{cd|81.1}}.}}
|{{HistoryLine|||dev=snap10|Changed format number to {{cd|82.0}}.}}
|{{HistoryLine|||dev=snap11|Changed format number to {{cd|83.0}}.}}
|{{HistoryLine|||dev=pre1|Changed format number to {{cd|84.0}}.}}
|{{HistoryLine|java upcoming}}
|{{HistoryLine||26.2|dev=snap1|Changed format number to {{cd|85.0}}.}}
|{{HistoryLine|||dev=snap3|Changed format number to {{cd|86.0}}.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|pocket alpha}}
|{{HistoryLine||v0.15.0|dev=release|Added the first custom in-game resource packs, Plastic and City.}}
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.4|dev=?|/modules in a pack manifest file is now mandatory.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.10.0|dev=beta 1.10.0.3|Resource packs are now separate from world templates and can be updated independently in existing worlds.}}
}}

== Trivia ==
=== pack.png ===
[[File:Alpha v1.2.2 pack.png|thumb|The world that the {{mono|pack.png}} screenshot was taken in, loaded in Alpha v1.2.2.]] 

The {{file|file|pack.png|inline=1}} was an image file used for the default resource pack icon before [[Minecraft:Java Edition 1.14]], and a grayscaled version of it is still used as a fallback for the world icon on the [[Minecraft:Select World]] screen as well as the [[Minecraft:server icon]] on the server list. The file shows a screenshot taken in what is likely a development version of [[Minecraft:Java Edition Alpha v1.2.2]], in a world generated with the [[Minecraft:Seed (world generation)|seed]] {{cd|3257840388504953787}}.<ref>{{ytl|ea6py9q46QU|Pack.PNG has been FOUND! - Here's how they did it.|SalC1|September 7, 2020}}</ref> It was taken approximately at X=49.16, Z=0.72, with [[Minecraft:view angle]] facing RX=-119.23, RY=-8.297. This image has been referenced officially multiple times in the "[[Minecraft:One Trillion Minecraft Views on YouTube and Counting]]" video and ''Unpacked'' [[Minecraft:painting]] in the game.

* The seed can be used in versions Alpha 1.2.0 through Beta 1.7.3, with minor population differences between versions.
* It's possible to generate an identical world and take an identical screenshot, a guide on how to do that can be found here: https://pastebin.com/CmsEKDev.<ref>https://www.reddit.com/r/MinecraftAtHome/comments/iocx6f/packpng_seed_was_found_explanation_tutorial_and</ref>

== Gallery ==
<gallery>
File:Select Resource Packs.png|Select resource packs menu.
File:Custom splash.png|A custom splash saying ''Also try {{w|Tomodachi Life}}!''
File:Loaded layer textures.png|[[Minecraft:Missing texture]] with a black and magenta checkerboard pattern seen in ''Java Edition''.
File:Custom biome with missing texture blocks.png|Blocks with missing textures seen in a broken custom biome in ''Bedrock Edition''.
File:Resourcepackedtitlescreen.png|Another example of a custom splash text
</gallery>

=== Resource pack icons ===
<gallery>
Default pack.png|The pack.png file used by the default resource pack.
Programmer Art pack.png|The pack.png file used by the programmer art resource pack.
Unknown pack.png|The fallback resource pack icon.
HC pack.png|The pack.png file used by the high contrast resource pack.
</gallery>

=== pack.png ===
<gallery>
Pack.png|The pack.png file used by the default resource pack before 1.14.
Unknown server.png|The grayscale variant still present in the game. Used as a fallback server icon.
Unpacked (texture).png|The ''Unpacked'' [[Minecraft:painting]] referencing pack.png.
</gallery>

=== Historical screenshots ===
<gallery>
NotchTexturePacks.png|The first image released by [[Minecraft:Notch]] of the texture pack selection menu.
Dinnerbone Select Resource Packs.png|The "Select Resource Packs" screen in old ''Java Edition'', screenshot by [[Minecraft:Dinnerbone]].
Dinnerbone Resource Packs.gif|Resource packs being managed.
Block Alternatives.png|Unimplemented "block alternatives" option for resource packs.
Resource Packs Button.jpg|The resource packs button.
</gallery>

== See also == 
* [[Minecraft:Tutorial:Creating a resource pack]]{{only|java}}
* [https://learn.microsoft.com/en-us/minecraft/creator/documents/resourcepack Introduction to Resource Packs] {{only|bedrock}}
* [[Minecraft:Programs and editors/Resource pack creators]]

== External links ==
* [https://misode.github.io/pack-mcmeta/ Pack.mcmeta Generator on misode.github.io]

== References ==
{{reflist}}

== Navigation ==
{{Navbox resource packs}}
{{Navbox Java Edition technical|resourcepack}}
{{Navbox Minecraft|general}}

[[Category:Game customization]]

[[Minecraft:cs:Balíček modifikací]]
[[Minecraft:de:Ressourcenpaket]]
[[Minecraft:es:Paquete de recursos]]
[[Minecraft:fr:Pack de ressources]]
[[Minecraft:it:Pacchetto di risorse]]
[[Minecraft:ja:リソースパック (Java Edition)]]
[[Minecraft:ko:리소스 팩]]
[[Minecraft:nl:Bronpakket]]
[[Minecraft:pl:Paczki zasobów]]
[[Minecraft:pt:Pacote de recursos]]
[[Minecraft:ru:Пакет ресурсов]]
[[Minecraft:th:รีซอร์ซแพ็ก]]
[[Minecraft:uk:Пакет ресурсів]]
[[Minecraft:zh:资源包]]