gui.png-atlas

This feature is exclusive to Java Edition.
 
gui.png-atlas in Java Edition 1.21.6.

gui.png-atlas is a procedurally-generated texture atlas used to store textures for many GUI elements.

Format

gui.png-atlas is a generated 1024×512-pixel file that stores textures for many GUI elements.

Bleeding

There are several known ways in which to render parts of this atlas through unintended means:

  • In 23w31a, editing the NBT of a furnace such that its fuel time or cooking duration exceeds normal values causes these elements to display areas outwith the normal bounds.[1]
  • Having a greater amount of XP than what is needed to reach the next level also causes the atlas to bleed.[2] For some versions, this requires resizing of the window to see. Values of XpP 11734884 and above will instead render an empty bar.
  • If the border value for nine_slice scaling is specified to be greater than or equal to 2^30 in mcmeta files, the elements in question is replaced with other parts of the atlas accordingly due to integer overflow.[3]
  • The jump bar at full capacity renders an around one pixel wide area of the atlas it shouldn't, which are usually transparent and therefore unnoticeable.[4]

History

Java Edition
1.20.223w31aAdded gui.png-atlas following the splitting and deprecation of many, many preceding atlases.
1.21.625w19agui.png-atlas now includes all of the sprites that mob_effects.png-atlas, which has been removed in this version, previously did.

Versions of the atlas

Note: atlasdumper is currently broken for versions 25w08a and beyond, so accurate, consistent versions of the atlas cannot currently be obtained.
Game version Atlas Additions Changes Removals Notes
Main Development
1.20.2 23w31a Introduction
23w32a
Pre-release 1
1.20.3 23w41a
23w42a
1.20.5 23w51a
24w09a
24w14potato
1.21.2 24w33a
24w35a
24w36a
24w37a
24w39a
Pre-Release 1
Pre-Release 3
1.21.4 24w44a
24w46a
25w14craftmine
1.21.6 25w15a
25w17a
25w18a
25w19a
25w20a

References


Navigation