Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
7,442
pages
English

Resource pack

Sign in to edit
Clock JE3
This article needs to be updated. 
Please update this page to reflect recent updates or newly available information.
Reason: Add missing atlas source type paletted_permutations (atlases).
This article is about the current system to customize assets. For other uses, see Texture Pack (disambiguation).
TexturesComparison

The default textures at the left side with a custom resource pack (Rodrigo's Pack 8x8) in the right side.

The resource pack system provides a way for players to customize textures, models, music, sounds, languages, texts such as the end poem, splashes, credits, and fonts without any code modification.

Java Edition[]

Behavior[]

Select resource pack

The default resource pack settings.

Resource packs can be placed in the folder resourcepacks within the .minecraft folder. Each resource pack is either a sub-folder or a .zip file within the resourcepacks folder. Once in the folder, a resource pack can be added from the options, where resource packs can be moved between "Available resource packs" and "Selected resource packs". "Selected resource packs" also contain the default assets on the bottom, which cannot be removed.

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.

Default resource packs[]

A resource pack can be bundled with a world by saving it as a .zip file under the name resources.zip and placing it directly in the world's folder. When playing the world, that resource pack appears as the default right above the default resource pack. A resource pack can be set on a server by adding a link to a .zip file download after the line resource-pack= in the server.properties file. Users then have an option of whether to download the resource pack or not. Resource packs can also be forced on a server using resource-pack-required=true in the server.properties file. Rejecting the resource pack disconnects the player from the server.

The old (pre-1.14) textures are available in a resource pack titled "Programmer Art". These textures are not updated when the game receives new textures.

Folder structure[]

More than one directory for different namespaces may exist under the assets directory.

Contents[]

A resource pack is identified by Minecraft based on the presence of the file pack.mcmeta in the root directory, which contains a JSON file with the following information:

  • The root tag
    •  pack: Holds the resource pack information
      •  pack_format: Pack version. If this number does not match the current required number, the resource pack displays an error and requires additional confirmation to load the pack. See Pack format for a full list of pack format numbers.
      •  description: Text shown below the pack name in the resource pack menu. The text is shown on two lines. If the text is too long it is truncated.
      •  description: Contains a raw JSON text object that is shown instead as the pack description in the resource pack menu. Same behavior as the string version of the description tag, but they cannot exist together.
    •  language: Contains additional languages to add to the language menu
      • Language code for a language, corresponding to a .json file with the same name in the folder assets/<namespace>/lang.
        •  name: The full name of the language
        •  region: The country or region name
        •  bidirectional: If true, the language reads right to left.
    •  filter: Section for filtering out files from resource packs applied below this one. Any file that matches one of the patterns inside block will be treated as if it was not present in the pack at all.
      •  block: List of patterns
        • Pattern entry.
          •  namespace: A regular expression for the namespace of files to be filtered out. If unspecified, it applies to every namespace.
          •  path: A regular expression for the paths of files to be filtered out. If unspecified, it applies to every file.

The root directory also contains an optional image called pack.png, which appears as the thumbnail for the pack on the resource pack selection menu.

Pack format[]

Main article: pack_format § Resource Pack

Language[]

Resource packs can create language files of the type .json in the folder assets/<namespace>/lang. Each file either replaces information from a file of the same name in the default or a lower pack, or it creates a new language as defined by pack.mcmeta.

Each line in the .json file is in the standard json format of "identifier":"name" followed by a comma in case it is followed by another value in the next line. identifier is what the game uses to look up the name for something, and as such it should not be translated or changed. name is the name that is displayed. For example, stone in the default language file is "block.minecraft.stone":"Stone", with block.minecraft.stone being the identifier, and Stone being the displayed name. Blank lines are ignored. The file needs to be valid JSON syntax, meaning it starts with a {, has a comma after every key value pair except the last one, and ends with a }.

Language files need to add only those lines that are changed by the pack. Any names that are not in the pack are loaded from the pack below, or default if no pack changes the names.

Models[]

Main article: Model

Models are files in JSON format with the extension .json, which determine the shape and textures of blocks and items.

Blocks use a block state file from assets/minecraft/blockstates to determine which model is loaded for each variant from the folder assets/minecraft/models/block. Meanwhile, each item has an item model in assets/minecraft/models/item to determine its model, which either loads from a block's model, contains data for its own custom model, or uses the default "flat" or "entity" model.

Models and block states used in packs below the top one are still loaded unless overridden in the top pack, which may cause some textures and models used by the top pack to no longer be loaded.

Sounds[]

Resource packs load additional sounds with the file type of .ogg. Each sound placed in the pack overrides the sounds from packs below, and packs also contain a file called sounds.json, which is placed within assets/minecraft. Unlike most other files in resource packs, sounds.json merges sound information from packs below the top pack, rather than each sounds.json file overriding the previous completely.

Textures[]

Missing Model

The "missing model" for invalid or missing models, prominently using the black and magenta "missing texture".

For block or item textures to function, they must have equal width and height (or height that is a multiple of the width if animated); otherwise it appears as a magenta and black checkerboard. For most other textures, the file is stretched to fit the required dimensions.

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 and any blocks or entities that are semi-transparent by default support semi-transparency.

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

Atlases[]

Atlases are configuration files, located in atlases directory, that control which images are included in the atlases. That directory contains following JSON entries for configuring atlases:

  • The root tag
    •  sources: Contains a list of sources. Every entry runs in during load, in order of definition, adding or removing new files to the texture list.
      • Source element
        •  type: The type of the atlas source. Can be one of the following:
          • directory: Lists all files in a directory and its subdirectories, across all namespaces.
            •  source: Directory in pack to be listed (relative to textures directory).
            •  prefix: String to be preprended to the sprite name when loaded.
          • single: Adds a single file.
            •  resource: Location of a resource within the pack (relative to textures directory, implied .png extension).
            •  sprite: Sprite name (optional, defaults to resource).
          • filter: Removes sprites matching the given pattern (only works for entries already in the list).
            •  namespace: Regular expression of the namespace indentificator to be removed, if omitted, any value will be matched.
            •  path: Regular expression of the path to be removed, if omitted, any value will be matched.
          • unstitch: Copies rectangular regions from other images.
            •  resource: Location of a resource within the pack (relative to textures directory, implied .png extension).
            •  divisor_x: Used for determining the units used by in the x coordinate of regions.
            •  divisor_y: Used for determining the units used by in the y coordinate of regions.
            •  regions: List of regions to copy from the source image.
              •  sprite: Specifies the sprite name.
              •  x: Specifies the x coordinate of the top-left corner of the region.
              •  y: Specifies the y coordinate of the top-left corner of the region.
              •  width: Specifies the width of the region.
              •  height: Specifies the height of the region.

Animation[]

Block, item, particle, painting, item frame, and status effect icon (assets/minecraft/textures/mob_effect) textures support animation by placing each additional frame below the last. The animation is then controlled using a .mcmeta file in JSON format with the same name and .png at the end of the filename, in the same directory. For example, the .mcmeta file for stone.png would be stone.png.mcmeta.

  • The root tag
    •  animation: Contains data for the animation
      •  interpolate: If true, Minecraft generates additional frames between frames with a frame time greater than 1 between them. Defaults to false.
      •  width: The width of the tile, as a direct ratio rather than in pixels. This is unused in vanilla's files but can be used by resource packs to have frames that are not perfect squares.
      •  height: The height of the tile as a ratio rather than in pixels. This is unused in vanilla's files but can be used by resource packs to have frames that are not perfect squares.
      •  frametime: Sets the default time for each frame in increments of one game tick. Defaults to 1.
      •  frames: Contains a list of frames. Defaults to displaying all the frames from top to bottom.
        • A number corresponding to position of a frame from the top, with the top frame being 0.
        • A frame specifies a frame with additional data.
          •  index: A number corresponding to position of a frame from the top, with the top frame being 0.
          •  time: The time in ticks to show this frame, overriding "frametime" above.

If the .mcmeta file does not exist in the pack and the texture does, the game assumes the texture is not animated, rather than loading a .mcmeta file from a pack below that pack. If no .mcmeta file exists for a texture with unequal dimensions, the texture appears as a purple and black checkerboard.

Villagers[]

Textures from assets/minecraft/textures/entity/villager and assets/minecraft/textures/entity/zombie_villager support a .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 .mcmeta. For example, the file profession/farmer.png can have a properties file called profession/farmer.png.mcmeta

  • The root tag
    •  villager: Contains data for the texture
      •  hat: Can be full, partial, or default (no .mcmeta file). Determines whether the villager's 'profession' hat layer should allow the 'type' hat layer to render or not. [more information needed]

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

Colormaps[]

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

Properties[]

Textures from assets/minecraft/textures/misc support a .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 .mcmeta. For example, the file pumpkinblur.png can have a properties file called pumpkinblur.png.mcmeta
  • The root tag
    •  texture: Contains data for the texture
      •  blur: Causes the texture to blur when viewed from close up. Defaults to false
      •  clamp: Causes the texture to stretch instead of tiling in cases where it otherwise would, such as on the shadow. Defaults to false
      •  mipmaps: Custom mipmap values for the texture

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

Texts[]

Two .txt files in UTF-8 format and one .json file exist in assets/minecraft/texts. They are used by the game to determine the text to display.

The file end.txt contains the text of the end poem, using formatting codes to apply the colors to the two speakers, and with the text PLAYERNAME being replaced with the player's name. After that file is shown, the contents of credits.json are shown.[more information needed]

The file splashes.txt contains lines of text separated using line breaks to determine the splashes to display in-game. Any splash can be replaced with different text.

Fonts[]

A font file is a JSON file located at assets/<namespace>/font within a resource pack and contains a list of providers that each tie a character set to a resource location along with some extra information. The default font is defined by the font minecraft:default while the default font used by enchantment tables is defined by the font minecraft:alt. The resource locations given in font providers should also include the file extensions.

  • The root tag
    •  providers: A list of providers that are merged onto this font.
      • A font provider. The contents depend on the value of the "type" tag.
        •  type: The type of the font provider. Can be one of the following:
          • bitmap: A bitmap font.
            •  file: The resource location of the used file, starting from assets/minecraft/textures by default. Prefacing the location with <namespace>: changes the location to assets/<namespace>/textures.
            •  height: Optional. The height of the character, measured in pixels. Can be negative. This tag is separate from the area used in the source texture and just rescales the displayed result. Default is 8.
            •  ascent: The ascent of the character, measured in pixels. This value adds a vertical shift to the displayed result.
            •  chars: A list of strings containing the characters replaced by this provider, as well as their order within the texture. All elements must describe the same number of characters. The texture is split into one equally sized row for each element of this list. Each row is split into one equally sized character for each character within one list element.
          • legacy_unicode: A legacy unicode font. This format is deprecated, prioritized only when the "Force Unicode Font" option is turned on.
            •  sizes: The resource location of a binary file describing the horizontal start and end positions for each character from 0 to 15. The file extension of the target file should be .bin. The resource location path is relative to the namespace root.
            •  template: The resource location inside assets/<namespace>/textures that leads to the texture files that should be used for this provider. The game replaces %s from the value of this tag with the first two characters of the hex code of the replaced characters, so a single provider of this type can point into multiple texture files.
          • ttf: A TrueType font or OpenType font. Despite its name, it supports both TTF and OTF.
            •  file: The resource location of the TrueType/OpenType font file within assets/<namespace>/font.
            •  shift: The distance by which the characters of this provider are shifted.
              • Left shift, negative values are allowed.
              • Downward shift, negative values are allowed.
            •  size: Font size to render at.
            •  oversample: Resolution to render at, increasing anti-aliasing factor.
            •  skip: String of characters or array of characters to exclude.
          • space: Show chosen characters as spaces
            •  advances
              •  A character: The amount of pixels that the following characters are moved to the right. Can be negative. Decimal numbers can be used for precise movement on higher gui scales.

Font texture sheets automatically resize based on the amount of characters in each array line, and some sheets may use a 16-character wide sheet, in order to conform with a Unicode block. This is how Vanilla formats the default font JSON.

Default textures[]

The texture files of the default fonts contain a grid of white characters, which are automatically colored by Minecraft as needed in-game. The character sizes are automatically determined based on the last line of pixels containing any alpha value. Due to the way fonts are detected, filling the background of a character with a color containing a 5% alpha background causes the full width to render without generally having a visible background to the character. The default font character is 8×8 pixels, while accented.png is 9×12 pixels.

  • Glyphs 0x20 (space) through 0x7E (tilde) display the standard ASCII characters
  • Glyphs 0x7F (<control>) through 0xFF (y with diaeresis) display the Code page 437 characters

The default texture is located in assets/minecraft/textures/font/ascii.png. It contains these characters: 

 !"#$%&'()*+,-./
0123456789:;<=>?
@ABCDEFGHIJKLMNO
PQRSTUVWXYZ[\]^_
`abcdefghijklmno
pqrstuvwxyz{|}~ 
                
            £  ƒ
      ªº  ¬   «»
░▒▓│┤╡╢╖╕╣║╗╝╜╛┐
└┴┬├─┼╞╟╚╔╩╦╠═╬╧
╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀
             ∅∈ 
≡±≥≤⌠⌡÷≈°∙ √ⁿ²■

A texture sheet in assets/minecraft/textures/font/nonlatin_european.png contains many accented characters and most of the symbols Minecraft supports. Contrary to its name, it also includes characters that are non-European[1] and some obscure Latin script characters. It contains these characters: 

¡‰­·₴≠¿×ØÞһðøþΑΒ
ΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣ
ΤΥΦΧΨΩαβγδεζηθικ
λμνξοπρςστυφχψωЂ
ЅІЈЉЊЋАБВГДЕЖЗИК
ЛМНОПРСТУФХЦЧШЩЪ
ЫЬЭЮЯабвгдежзикл
мнопрстуфхцчшщъы
ьэюяєѕіјљњ–—‘’“”
„…⁊←↑→↓⇄＋ƏəɛɪҮүӨ
өʻˌ;ĸẞß₽€ѢѣѴѵӀѲѳ
⁰¹³⁴⁵⁶⁷⁸⁹⁺⁻⁼⁽⁾ⁱ™
ʔʕ⧈⚔☠ҚқҒғҰұӘәҖҗҢ
ңҺאבגדהוזחטיכלמם
נןסעפףצץקר¢¤¥©®µ
¶¼½¾·‐‚†‡•‱′″‴‵‶
‷‹›※‼‽⁂⁈⁉⁋⁎⁏⁑⁒⁗℗
−∓∞☀☁☈Є☲☵☽♀♂⚥♠♣♥
♦♩♪♫♬♭♮♯⚀⚁��⚃⚄⚅ʬ⚡
⛏✔❄❌❤⭐⸘⸮⸵⸸⹁⹋⥝ᘔƐ߈
ϛㄥⱯᗺƆᗡƎℲ⅁ꞰꞀԀꝹᴚ⟘∩
Ʌ⅄ɐɔǝɟᵷɥᴉɾʞꞁɯɹʇʌ
ʍʎԱԲԳԴԶԷԹԺԻԼԽԾԿՀ
ՁՂՃՄՅՆՇՈՉՋՌՍՎՏՐՑ
ՒՓՔՕՖՙաբգդեզէըթժ
իլխծկհձղճմյնշոչպ
ջռսվտրցւփքօֆևשתԸ
՚՛՜՝՞՟ՠֈ֏¯ſƷʒǷƿȜ
ȝȤȥ˙Ꝛꝛ‑⅋⏏⏩⏪⏭⏮⏯⏴⏵
⏶⏷⏸⏹⏺⏻⏼⏽⭘▲▶▼◀●◦◘
⚓⛨IJijljꜨꜩꜹꜻfffiflffiſt�Ե
Պᚠᚢᚣᚤᚥᚦᚧᚨᚩᚪᚫᚬᚭᚮᚯ
ᚰᚱᚲᚳᚴᚶᚷᚸᚹᚺᚻᚼᚽᚾᚿᛀ
ᛁᛂᛃᛄᛅᛆᛇᛈᛉᛊᛋᛌᛍᛎᛏᛐ
ᛑᛒᛓᛔᛕᛖᛗᛘᛙᛚᛛᛜᛝᛞᛟᛠ
ᛡᛢᛣᛤᛥᛦᛧᛨᛩᛪ᛫᛬᛭ᛮᛯᛰ
ᛱᛲᛳᛴᛵᛶᛷᛸ☺☻¦☹ך׳״װ
ױײ־׃׆´¨ᴀʙᴄᴅᴇꜰɢʜᴊ
ᴋʟᴍɴᴏᴘꞯʀꜱᴛᴜᴠᴡʏᴢ§
ɱɳɲʈɖɡʡɕʑɸʝʢɻʁɦʋ
ɰɬɮʘǀǃǂǁɓɗᶑʄɠʛɧɫ
ɨʉʊɘɵɤɜɞɑɒɚɝƁƉƑƩ
ƲႠႡႢႣႤႥႦႧႨႩႪႫႬႭႮ
ႯႰႱႲႳႴႵႶႷႸႹႺႻႼႽႾ
ႿჀჁჂჃჄჅჇჍაბგდევზ
თიკლმნოპჟრსტუფქღ
ყშჩცძწჭხჯჰჱჲჳჴჵჶ
ჷჸჹჺ჻ჼჽჾჿתּשׂפֿפּכּײַיִ
וֹוּבֿבּꜧꜦɺⱱʠʗʖɭɷɿʅʆ
ʓʚ₪₾֊ⴀⴁⴂⴃⴄⴅⴆⴡⴇⴈⴉ
ⴊⴋⴌⴢⴍⴎⴏⴐⴑⴒⴣⴓⴔⴕⴖⴗ
ⴘⴙⴚⴛⴜⴝⴞⴤⴟⴠⴥ⅛⅜⅝⅞⅓
⅔✉☂☔☄⛄☃⌛⌚⚐✎❣♤♧♡♢
⛈☰☱☳☴☶☷↔⇒⇏⇔⇵∀∃∄∉
∋∌⊂⊃⊄⊅∧∨⊻⊼⊽∥≢⋆∑⊤
⊥⊢⊨≔∁∴∵∛∜∂⋃⊆⊇□△▷
▽◁◆◇○◎☆★✘₀₁₂₃₄₅₆
₇₈₉₊₋₌₍₎∫∮∝⌀⌂⌘〒ɼ
ƄƅẟȽƚƛȠƞƟƧƨƪƸƹƻƼ
ƽƾȡȴȵȶȺⱥȻȼɆɇȾⱦɁɂ
ɃɄɈɉɊɋɌɍɎɏẜẝỼỽỾỿ
Ꞩꞩ𐌰𐌱𐌲𐌳𐌴𐌵𐌶𐌷𐌸𐌹𐌺𐌻𐌼𐌽
𐌾𐌿𐍀𐍁𐍂𐍃𐍄𐍅𐍆𐍇𐍈𐍉𐍊🌧🔥🌊
⅐⅑⅕⅖⅗⅙⅚⅟↉🗡🏹🪓🔱🎣🧪⚗
⯪⯫Ɑ🛡✂🍖🪣🔔⏳⚑₠₡₢₣₤₥
₦₩₫₭₮₰₱₲₳₵₶₷₸₹₺₻
₼₿

A secondary texture is located in assets/minecraft/textures/font/accented.png. It supports most basic accented characters, Greek letters, Cyrillic characters, as well as some enclosed alphanumerics and other symbols. It contains these characters: 

ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏ
ÐÑÒÓÔÕÖÙÚÛÜÝàáâã
äåæçìíîïñòóôõöùú
ûüýÿĀāĂ㥹ĆćĈĉĊċ
ČčĎďĐđĒēĔĕĖėĘęĚě
ĜĝḠḡĞğĠġĢģĤĥĦħĨĩ
ĪīĬĭĮįİıĴĵĶķĹĺĻļ
ĽľĿŀŁłŃńŅņŇňŊŋŌō
ŎŏŐőŒœŔŕŖŗŘřŚśŜŝ
ŞşŠšŢţŤťŦŧŨũŪūŬŭ
ŮůŰűŲųŴŵŶŷŸŹźŻżŽ
žǼǽǾǿȘșȚțΆΈΉΊΌΎΏ
ΐΪΫάέήίΰϊϋόύώЀЁЃ
ЇЌЍЎЙйѐёђѓїћќѝўџ
ҐґḂḃḊḋḞḟḢḣḰḱṀṁṖṗ
ṠṡṪṫẀẁẂẃẄẅỲỳèéêë
ʼnǧǫЏḍḥṛṭẒỊịỌọỤụ№
ȇƔɣʃ⁇DZDzdzDŽDždžLJLjNJNjnj
ℹᵫꜲꜳꜴꜵꜶꜷꜸꜺꜼꜽꝎꝏꝠꝡ
fflstᚡᚵƠơƯưẮắẤấẾếốỚ
ớỨứẰằẦầỀềồỜờỪừẢả
ẲẳẨẩẺẻổỞỂểỈỉỎỏỔở
ỦủỬửỶỷẠạẶặẬậẸẹỆệ
ỘộỢợỰựỴỵỐƕẪẫỖỗữ☞
☜☮ẴẵẼẽỄễỒỠỡỮỸỹҘҙ
ҠҡҪҫǶ⚠⓪①②③④⑤⑥⑦⑧⑨
⑩⑪⑫⑬⑭⑮⑯⑰⑱⑲⑳ⒶⒷⒸⒹⒺ
ⒻⒼⒽⒾⒿⓀⓁⓂⓃⓄⓅⓆⓇⓈⓉⓊ
ⓋⓌⓍⓎⓏⓐⓑⓒⓓⓔⓕⓖⓗⓘⓙⓚ
ⓛⓜⓝⓞⓟⓠⓡⓢⓣⓤⓥⓦⓧⓨⓩ◌̧
ʂʐɶǍǎǞǟǺǻȂȃȦȧǠǡḀ
ḁȀȁḆḇḄḅᵬḈḉḐḑḒḓḎḏ
ḌᵭḔḕḖḗḘḙḜḝȨȩḚḛȄȅ
ȆᵮǴǵǦḦḧḨḩḪḫȞȟḤẖḮ
ḯȊȋǏǐȈȉḬḭǰȷǨǩḲḳḴ
ḵḺḻḼḽḶḷḸḹⱢḾḿṂṃᵯṄ
ṅṆṇṊṋǸǹṈṉᵰǬǭȬȭṌṍ
ṎṏṐṑṒṓȎȏȪȫǑǒȮȯȰȱ
ȌȍǪṔṕᵱȒȓṘṙṜṝṞṟȐȑ
ṚᵳᵲṤṥṦṧṢṣṨṩᵴṰṱṮṯ
ṬẗᵵṲṳṶṷṸṹṺṻǓǔǕǖǗ
ǘǙǚǛǜṴṵȔȕȖṾṿṼṽẆẇ
ẈẉẘẌẍẊẋȲȳẎẏẙẔẕẐẑ
ẓᵶǮǯẛꜾꜿǢǣᵺỻᴂᴔꭣȸʣ
ʥʤʩʪʫȹʨʦʧꭐꭑ₧Ỻאַאָƀ
ƂƃƇƈƊƋƌƓǤǥƗƖɩƘƙƝ
ƤƥɽƦƬƭƫƮȗƱƜƳƴƵƶƢ
ƣȢȣʭʮʯﬔﬕﬗﬖﬓӐӑӒӓӶ
ӷҔҕӖӗҼҽҾҿӚӛӜӝӁӂӞ
ӟӢӣӤӥӦӧӪӫӰӱӮӯӲӳӴ
ӵӸӹӬӭѶѷӔӺԂꚂꚀꚈԪԬꚄ
ԄԐӠԆҊӃҞҜԞԚӅԮԒԠԈԔ
ӍӉԨӇҤԢԊҨԤҦҎԖԌꚐҬꚊ
ꚌԎҲӼӾԦꚔҴꚎҶӋҸꚒꚖꚆҌ
ԘԜӕӻԃꚃꚁꚉԫԭꚅԅԑӡԇҋ
ӄҟҝԟԛӆԯԓԡԉԕӎӊԩӈҥ
ԣԋҩԥҧҏԗԍꚑҭꚋꚍԏҳӽӿ
ԧꚕҵꚏҷӌҹꚓꚗꚇҍԙԝἈἀἉ
ἁἊἂἋἃἌἄἍἅἎἆἏἇᾺὰᾸ
ᾰᾹᾱΆάᾈᾀᾉᾁᾊᾂᾋᾃᾌᾄᾍ
ᾅᾎᾆᾏᾇᾼᾴᾶᾷᾲᾳἘἐἙἑἚ
ἒἛἓἜἔἝἕῈΈὲέἨἠῊὴἩ
ἡἪἢἫἣἬἤἭἥἮἦἯἧᾘᾐᾙ
ᾑᾚᾒᾛᾓᾜᾔᾝᾕᾞᾖᾟᾗΉήῌ
ῃῂῄῆῇῚὶΊίἸἰἹἱἺἲἻ
ἳἼἴἽἵἾἶἿἷῘῐῙῑῒΐῖ
ῗῸὸΌόὈὀὉὁὊὂὋὃὌὄὍ
ὅῬῤῥῪὺΎύὙὑὛὓὝὕὟὗ
ῨῠῩῡϓϔῢΰῧὐὒὔῦὖῺὼ
ΏώὨὠὩὡὪὢὫὣὬὤὭὥὮὦ
Ὧὧᾨᾠᾩᾡᾪᾢᾫᾣᾬᾤᾭᾥᾮᾦ
ᾯᾧῼῳῲῴῶῷ☯☐☑☒ƍƺⱾȿ
ⱿɀᶀꟄꞔᶁᶂᶃꞕᶄᶅᶆᶇᶈᶉᶊ
ᶋᶌᶍꟆᶎᶏᶐᶒᶓᶔᶕᶖᶗᶘᶙᶚ
ẚ⅒⅘₨₯

The default texture used when displaying the Standard Galactic Alphabet (a.k.a. the enchanting text or "alien font") is assets/minecraft/textures/font/ascii_sga.png.

There is another currently unused texture called illageralt, which is the rune-like font from Minecraft Dungeons. It is located at assets/minecraft/textures/font/asciillager.png.

Legacy Unicode[]

As a fallback for untextured characters, Minecraft uses GNU Unifont. Each sheet of characters is stored following the format of unicode_page_##, where ## are the hexadecimal numbers 00 through FF. These pages are 16×16 pixels, and appear small and rough in-game. The version of GNU Unifont used is 9.0.04[2], and is outdated as of 1.17.1. It provides the support for the CJK characters as well as a fallback for every character not provided by any loaded font.

The Unifont entries use a glyph_sizes.bin for recording glyph widths. Each entry is one byte large; the higher nibble records the starting position while the lower records the ending position in the 16×16 glyph grid. For example, a square character occupying the entire grid (pixel #0 through #15) would have a byte of 0F.

Codepoints beyond U+FFFF are not handled and are ignored.

Emoji[]

Since 1.15, Minecraft can support UTF-16 sequences for emojis, or any character in the Unicode SMP plane.

For the emoji to be read properly in the  char array of the font file, the character can either:

  • be split from its' UTF-16 codepoint into two UTF-8 codepoints (surrogates); for example, 1F603 = D83D DE03
  • be input directly

The first method is used in the Vanilla font file, but either works equally well. To convert a character into a surrogate pair, one can use the following equations, where C is the codepoint in decimal:

  • High Surrogate (first): ((C - 65536) - (C % 1024)) ÷ 1024 + 55296
  • Low Surrogate (second): (C % 1024) + 56320

As of 1.17.1, Minecraft has default support for the following emojis: 

☀ ☁ ☂ ☃ ☄ ☑ ☔ ☠ ☮ ☯ ☹ ☺ ♀ ♂ ♠ ♣ ♥ ♦ ⚓ ⚔ ⚗ ⚠ ⚡ ⛄ ⛈ ⛏ ✉ ✔ ❣ ❄ 🔥 🌊 🗡 🏹 🪓 🔱 🎣 🧪 ✂ 🍖 🪣 🔔 ⏳
Shadows[]

In most places text is rendered, a shadow appears beneath every character. This shadow is a copy of the character's bitmap, with the r, g and b values divided by 4, and positioned 12.5% south-east of the character, relative to its spacing. Regardless of the resolution of the character's texture, the shadow is always moved by 12.5%; whether there exists any way to change this value using resource packs is unknown. In the default font (assets/minecraft/textures/font/ascii.png), the shadow is equivalent to being moved 1 pixel down and to the right.

Glowing text[]

Glow ink on a sign causes a character to create eight copies of itself, similar to the shadows, but in all eight directions. This results in the font appearing to have a thick outline.

Texture sheets[]

Main article: Texture atlas

Minecraft generally does not store multiple different textures on sheets and instead stores them on separate files. Two current exceptions are map icons[3] and experience orbs.[4]

Shaders[]

Main article: Shaders

Shaders are a way for resource packs to change how the game renders. They are written in OpenGL Shading Language (GLSL).

Regional compliancies warnings[]

Regional compliancies warnings can be customized at assets/<namespace>/regional_compliancies.json.

  • The root tag
    •  Region: Contains a list of warnings. Note that the key itself is an ISO 3166-1 alpha-3 region code determined by the device's locale setting.
      •  delay: Optional. Defines how long should the game wait until showing this message in minutes. This can not be zero.
      •  period: The time interval this message should be shown in minutes. This can not be zero.
      •  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.
      •  message: The translation identifier of the message. A slot is provided for the translation string, how many times this warning has been shown.

Template[]

The folder structure of Vanilla Resource Pack:

Bedrock Edition[]

Jigsaw Block (top texture) JE2 BE2
This section needs expansion. 
You can help by expanding it.

Behavior[]

Similarly to skins, resource packs can be bought or made in Bedrock Edition. Users can download resource packs on the system itself with the .mcpack file names, if the game platform allows file importation. When these files are opened, they are automatically imported into the game without any need for file system access. Resource packs can also be put manually in the resource_packs folder in the com.mojang folder. Each resource pack must either be a sub-folder or a .zip file.

Resource packs can be applied on the Global Resources option from the settings menu from the main menu screen. Resource packs can be moved between "Active" and "My Packs". "Active" also contains the default assets at the bottom, and cannot be removed.

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.

Default packs[]

One or more resource packs can be bundled with a world in the world settings. When playing the world, that resource pack appears as the default right above the default resource pack. A resource pack can be set on a server by bundling the resource pack in the world, and then re-uploading the world folder to the server. Users then have an option whether to use the resource pack or not if the texturepack-required option is disabled in the server settings and if the world has the "Require players to accept resource packs to join" option disabled. Resource packs can also be forced on a server by using the texturepack-required=true property on the server settings.

Folder Structure[]

History[]

Java Edition
1.6.113w24aAdded resource packs, replacing the functionality of texture packs.
Minecraft Texture Ender is available from Mojang to automatically convert 1.5 compatible texture packs to resource packs. See Java Edition 1.6.1/Resource pack changes for the list of file names changed.
1.6.2reuploadFixed distorted font when HD font is used.[5]
1.7.213w36aAdded the ability to apply multiple resource packs at once.
Servers can now recommend a default resource pack via the server-side resource packs system.[6][7]
13w42aMoved files from assets/minecraft/music to assets/minecraft/sounds/music and files from assets/minecraft/sound to assets/minecraft/sounds.
1.7.413w47aThe description value of pack.mcmeta can now be raw JSON text format.
13w48aRemoved the ability to change the Mojang logo.
1.814w06aAdded the ability to change the block models.
14w07aResource packs can now be bundled with a map.
14w25aThe model format now supports custom item models.
Textures can now be specified for blocks and items.
Added the interpolate tag for animations.
1.8.8preResource packs now display an error if the format number is wrong. At this time, it requires a format number of 1.
1.915w31aChanged format number to 2, due to changes in the model system, such as item tags, 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 here for an example.
1.1116w32aResource packs version number changed to 3, due to the change that all files should have lowercase letters.
1.1317w43aThe default resource pack can now be moved up and down, just like other resource packs.
17w48aChanged format number to 4, due to The Flattening. See Java Edition 1.13/Resource pack changes for the list of file names changed.
pre7Several punctuation characters in ascii.png were shortened by one pixel, either vertically or horizontally. A stray pixel on the Ø character was also removed.
pre8Several more punctuation characters in ascii.png were shortened and the @ was lowered by one pixel.
1.1418w45aAdded "Programmer Art – The classic look of Minecraft" to the resource pack menu, due to the old textures being replaced by new ones in the Texture Update.
19w06aSignificantly improved resource pack loading speed.[8]
Particles textures are now split into individual files.
19w07aPainting textures are now split into individual files.
19w08aStatus effect textures are now split into individual files.
19w09aParticles are now configurable.
1.15Pre-release 1Changed format number to 5, due to texture mechanic changes in earlier snapshots.
1.16.2Release Candidate 1Changed format number to 6, due to changes to wall blocks made in 1.16 according to MC-197275.
1.1720w45aChanged format number to 7.
21w05aImproved performance when using many overrides on an item model.
toasts.png GUI texture has a new icon for the bundle tutorial.
pre1The file credits.txt in assets/minecraft/texts was changed to credits.json, and the format also changed from plain text to structured JSON format.
1.1821w37aAdded illageralt, the rune-like font from Minecraft Dungeons (currently usable only via commands).
21w39aChanged format number to 8, because inventory.png now contains an extra sprite for a thin-layout version of the effect list in the inventory.
1.18.222w06aAdded 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.
1.1922w11aChanged format number to 9, due to new filter section in pack.mcmeta.
1.19.322w42aChanged format number to 11, due to the removal of "fixers" for resource packs with format numbers 3 and 4.
22w45aChanged format number to 12.
1.19.423w07aThe vanilla resource pack en_us language file is now sorted alphanumerically by key.
1.19.4-pre1Added a built-in "High Contrast" resource pack that enhances the contrast of UI elements.
Changed format number to 13, due to the enchantment glint now being separate between entities and items.
1.2023w14aChanged the pack format to 14 due to updates to the layout of minecraft.png and invite_icon.png.
23w17aChanged the pack format to 15 due to updates to the font and the credits.
uniform font has been updated to use Unifont 15.0.01.
Pre-release 5uniform font has been updated to use Unifont 15.0.03.
1.20.223w31aChanged the pack format to 16.
The process of upgrading a pack can now be assisted by using an automated Slicer tool.[9]
23w32aThe version is now 17.
The text field background is now a nine-sliced sprite at idget/text_field and widget/text_field_highlighted.
The scroll bar in lists and text fields is now a nine-sliced sprite at widget/scroller.
1.20.2 Pre-release 2The version is now 18.
1.20.3releaseThe pack format is now 21.
Pocket Edition Alpha
v0.15.0releaseAdded the first custom in-game resource packs, Plastic and City.
Bedrock Edition
1.10.0beta 1.10.0.3Resource packs are now separate from world templates and can be updated independently in existing worlds.

Trivia[]

Alpha v1.2

The world that the pack.png screenshot was taken in, loaded in Alpha v1.2.2.

Gallery[]

  • The old pack.png file.

    The old pack.png file.

  • The grayscale variant currently still in the game. Used for icons for unknown servers.

    The grayscale variant currently still in the game. Used for icons for unknown servers.

  • The first image released by Notch of the texture pack selection menu.

    The first image released by Notch of the texture pack selection menu.

  • The default resource pack icon.

    The default resource pack icon.

  • The programmer art resource pack icon.

    The programmer art resource pack icon.

  • The unknown resource pack icon.

    The unknown resource pack icon.

  • 64x64 version of pack.png that is used in server icons and resource packs by default.

    64x64 version of pack.png that is used in server icons and resource packs by default.

  • A splash screen in Minecraft version 1.6.1 saying Also try Tomodachi Life!

    A splash screen in Minecraft version 1.6.1 saying Also try Tomodachi Life!

  • Missing texture blocks seen in a custom biome in Bedrock edition 1.17.2 Hotfix (iOS).

    Missing texture blocks seen in a custom biome in Bedrock edition 1.17.2 Hotfix (iOS).

  • The "select resource packs" screen.

    The "select resource packs" screen.

  • Resource packs being ordered.

    Resource packs being ordered.

  • Unimplemented "block alternatives" option for resource packs.

    Unimplemented "block alternatives" option for resource packs.

  • The resource packs button.

    The resource packs button.

See also[]

References[]

  1. ↑ MC-199249
  2. ↑ MC-108045
  3. ↑ https://feedback.minecraft.net/hc/en-us/community/posts/360058199792-Split-up-map-icon-textures-into-individual-files
  4. ↑ https://feedback.minecraft.net/hc/en-us/community/posts/360058097892-Split-up-the-experience-orb-texture-file-into-individual-sprites
  5. ↑ MC-17673 — "Distorted fonts when using a converted texturepack on startup" — resolved as "Fixed".
  6. ↑ MC-18569 — "Server resourcepacks not implemented yet" — resolved as "Fixed".
  7. ↑ https://mcupdate.tumblr.com/post/65040832258/minecraft-172
  8. ↑ "It should have already affected resource pack loading! It's all the same thing internally." – @Dinnerbone (Nathan Adams) on X, February 7, 2019
  9. ↑ https://github.com/Mojang/slicer/releases/tag/v1.1
  10. ↑ "Pack.PNG has been FOUND! - Here's how they did it." – SalC1 on YouTube, September 7, 2020
  11. ↑ https://www.reddit.com/r/MinecraftAtHome/comments/iocx6f/packpng_seed_was_found_explanation_tutorial_and
Minecraft
Help
Menu screens
Aspects
Examples
Game customization
Editions
Java
Bedrock
Merged
Ports to consoles
Discontinued
Other
Discontinued
Legacy Console
Other
Miscellaneous
Čeština Deutsch Español Français Italiano 日本語 한국어 Nederlands Polski Português Русский ไทย Українська 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki