Custom Loading Screens#

Custom Loading Screens define the screen when changing worlds, loading a world, starting the game, or reloading datapacks.

Location

/assets/minecraft/optifine/gui/loading/loading.properties

Controls the behaviour of the world loading screen,

_images/icon10.png

Dimension switching screen#

_images/mojang.png

The Vanilla loading screen since 1.16.#

Custom loading screen backgrounds per dimension can be defined as:

/assets/minecraft/optifine/gui/loading/background<dim>.png

Where <dim> is the dimension id:

  • The End: 1

  • Overworld: 0

  • Nether: -1

Note

Modded dimensions can also be configured in this way.

Properties#

Note

The properties scaleMode, scale, and center can also be configured per dimension:

dim<dim>.scaleMode=<fixed|full|stretch>
dim<dim>.scale=2
dim<dim>.center=<true|false>

Key

Values

Meaning

scaleMode

Values: String, one of: fixed, full, stretch
Required: ❌ No
Default: default
Custom scale mode for the background texture.
Values:
fixed: use fixed scale (default)
full: full screen, keep aspect ratio
stretch: fullscreen

scale

Values: Integer
Required: ❌ No
Default: Fixed: 2, Full: 1
Custom scale for the background texture.
For scale mode fixed, it defines the scale to use.
This is combined with the curent GUI scale.
For scale modes full and stretch, it defines how many full textures should fit on the screen.

center

Values: Boolean
Required: ❌ No
Default: false

Defines if the background texture should be centered on the screen.


🆚️ 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.