Skip to content

Background

There are two types of backgrounds:

Advancement Background

This background works like vanilla advancement background. The texture should be 16x16 and it is tiled across the whole space:

Example

json
{
	...
    "background": "minecraft:textures/gui/advancements/backgrounds/adventure.png"
	...
}

Custom Background

Properties

Texture

Property texture defines the texture that will be used as background.

Width and Height

Properties width and height define respectively width and height of the texture.

Position

Property position defines how the texture will be positioned on the screen. Possible options are:

  • tile - Texture is tiled and repeated across the whole screen.
  • fill - Textures is scaled such that it covers the whole screen.
  • fill_width - Textures is scaled such that it covers the width of screen.
  • fill_height - Textures is scaled such that it covers the height of screen.

If not set defaults the texture is centered on the screen and has original size.

Example

json
{
	...
    "background": {
    	"texture": "minecraft:textures/gui/title/background/panorama_0.png",
		"width": 1024,
		"height": 1024,
		"position": "fill"
	}
	...
}

JSON Structure

PropertyTypeRequired
texturestringyes
widthintegeryes
heightintegeryes
positiontile or fill or fill_width or fill_heightno