Custom Panoramas#

Custom Panoramas control the behaviour of the main menu panorama.

Location

/assets/minecraft/optifine/gui/background.properties

_images/icon11.png

1.17 main menu#

Alternative panorama folders#

Note

This is optional

Alternative panorama folders can include a background.properties file to define custom properties for each panorama.

For example:

┗/assets/minecraft/optifine/gui/background1
    ┣/panorama_0.png
    ┣/panorama_1.png
    ┣/panorama_2.png
    ┣/panorama_3.png
    ┣/panorama_4.png
    ┗/panorama_5.png

Weight#

Note

This is optional

Weight for the random selection, higher weights will be selected more often.

Key

Values

Meaning

weight

Values: Integer
Required: ❌ No
Default: 1

Weights of selections, in descending order

Blur level#

Note

This is optional

Warning

Higher blur levels may decrease the main menu FPS

Warning

This feature does not work past 1.12

The main menu background uses 3 types of blur:

Key

Values

Meaning

blur1

Values: Integer, 1 through 64
Required: ❌ No
Default: 1

?

blur2

Values: Integer, 1 through 3
Required: ❌ No
Default: 1

?

blur3

Values: Integer, 1 through 3
Required: ❌ No
Default: 1

?

Overlay colors#

Note

This is optional

Note

When the top and bottom colors are both 0 the overlay is disabled.

If enabled, 2 gradient overlays can be drawn on top of the background panorama.

The color format is ARGB (alpha, red, green, blue), in hexadecimal. To read it, convert each 2-value to decimal. (AABBCCDD0xAA, 0xBB, 0xCC, 0xDD170, 187, 204, 221)

Possible values are shown below:

Key

Values

Meaning

Default

overlay1.top

Hexadecimal, AARRGGBB

First overlay, top gradient color

80FFFFFF

overlay1.bottom

Hexadecimal, AARRGGBB

First overlay, bottom gradient color

00FFFFFF

overlay2.top

Hexadecimal, AARRGGBB

Second overlay, top gradient color

00000000

overlay2.bottom

Hexadecimal, AARRGGBB

Second overlay, top gradient color

80000000


🆚️ This documentation assumes the latest OptiFine version. Notes are not made for legacy versions (1.8).
🔙️ This documentation is updated to commit 8410499f.
©️ This file is offered without any copyright restrictions. Please copy and modify it to suit your needs. Credit is optional, but appreciated.