Setting Up a Gradient Background or Vanilla Blur in Blur+

Blur+ controls how menu and container backgrounds look, letting you choose between a two-color gradient and the standard blurred backdrop. All options live in the mod's settings interface, and every change applies immediately to the screens you have enabled.

Choosing Between Gradient and Blur

The useGradient option decides which background style is active. Turn it on to replace the blurred backdrop with a color gradient. Turn it off to fall back to the vanilla-style blur, which the mod manages through its own blur settings.

Configuring the Gradient

When useGradient is enabled, four values define the gradient's appearance:

• gradientStart — the color at the beginning of the gradient.
• gradientEnd — the color at the end of the gradient.
• gradientStartAlpha — the transparency level at the start of the gradient.
• gradientEndAlpha — the transparency level at the end of the gradient.

Adjust the two colors to set the gradient's hues, then adjust the two alpha values to control how opaque or see-through each end is. The gradient animates according to backgroundAnimationCurve, which shapes how the transition between the two ends behaves over time.

Configuring Blur Targets

If you prefer the blur effect, several toggles decide where it appears:

• blurContainers — applies blur to container screens.
• blurBooks — applies blur to book screens.
• blurCommandBlocks — applies blur to command block screens.
• blurDeathScreen — applies blur to the death screen.
• blurSigns — applies blur to sign screens.
• blurTitleScreen — applies blur to the title screen.

Two further options refine this:

• reduceInGameBlur — lessens the blur strength on in-game screens.
• darkenTitleScreen — darkens the title screen background.

The tooltip attached to the blur settings notes that this mirrors the "Menu Background Blur" toggle found in Minecraft's Accessibility Settings, so the two stay in sync.

Animation Timing

Blur and background transitions are animated rather than instant. Three settings control that motion:

• fadeTimeMillis — how long the fade-in takes, measured in milliseconds.
• fadeOutTimeMillis — how long the fade-out takes, measured in milliseconds.
• blurAnimationCurve — the curve that shapes the blur animation.

Alongside these, backgroundAnimationCurve shapes the gradient's animation. Raising or lowering the millisecond values makes transitions slower or faster; the curves change how the motion is distributed across that time.

Per-Screen Overrides

Blur+ can animate only some screens and skip others. Two list fields handle exceptions:

• forceEnabledScreens — screens where the vanilla blur effect is forced on.
• forceDisabledScreens — screens where the vanilla blur effect is forced off.

A related tooltip explains that these fields exist to exclude specific screens from Blur+'s animations. To fill them in, you need each screen's identifier.

Finding Screen IDs

A separate tooltip describes a diagnostic aid: it displays the current screen's ID in the top-left corner of the game window. Open the screen you want to exempt or force, read the ID shown there, and add that ID to the appropriate field — forceEnabledScreens or forceDisabledScreens.

Operating the Settings

Open the mod's settings interface to reach every option described above. Toggle useGradient to pick your background style, edit the four gradient values if it is on, or work through the blur toggles if it is off. Set your fade times and animation curves, then use the screen ID display to populate the force-enabled and force-disabled lists. No crafting or item is involved — everything is configured directly through the interface. Any hotkeys the mod provides are bound in the controls menu, where you can assign the corresponding hotkey to each action.