Resource Reload Guard

Resource Reload Guard is a client-side mod for Minecraft Java Edition 1.20.1.

Reloading client resources can take several minutes in large modpacks and may cause long garbage-collection pauses, hangs, or crashes. This mod does not make resource loading faster. Instead, it guards known user actions so an expensive reload does not begin accidentally or unnecessarily.

Supported environments

Minecraft 1.20.1
Forge 47.x
Fabric Loader (Fabric API required)

Forge and Fabric use separate JARs. Install the JAR for your loader in the client mods directory. The Fabric build also requires Fabric API.

Features

Resource packs

Detects enabled, disabled, and reordered packs.
Skips applying a selection when the pack IDs and order are unchanged.
Lets you return to editing without losing the current selection.
Can discard the selection and restore the state from before the screen was opened.
Can apply now or save the selection for the next launch.

Language

Skips the reload when the selected language is unchanged.
Shows the current and selected languages before applying.
Can apply now or save the language for the next launch.

Mipmap levels

Detects a mipmap-level change before leaving Video Settings.
Can return to Video Settings, discard only the mipmap change, defer it until the next launch, or apply it now.
Reloads client textures only when Apply now is selected.

Safety measures

Dangerous actions never receive initial focus.
Esc always returns to a safe screen.
Dangerous buttons remain disabled until both the configured number of client ticks and the equivalent monotonic time have elapsed.
Initial loading, mod-initiated reloads, server resource packs, recovery reloads, and reloads of unknown origin are not globally cancelled.

F3+T

Stops the vanilla reload before it starts.
Runs it only after explicit confirmation.
Prevents duplicate prompts and reloads caused by key repeat.
Rejects additional user requests while a reload is active.

Configuration

A commented TOML file is generated on first launch:

config/resource_reload_guard.toml

Key	Default	Description
`debugKeyPolicy`	`CONFIRM`	Policy for F3+T
`resourcePackPolicy`	`CONFIRM`	Policy for resource-pack changes
`languagePolicy`	`CONFIRM`	Policy for language changes
`mipmapPolicy`	`CONFIRM`	Policy for mipmap-level changes
`skipUnchangedResourcePackApply`	`true`	Skip unchanged pack selections
`allowDeferredResourcePackApply`	`true`	Allow pack changes to be deferred
`allowDeferredLanguageApply`	`true`	Allow language changes to be deferred
`allowDeferredMipmapApply`	`true`	Allow mipmap changes to be deferred
`blockUserRequestsWhileReloading`	`true`	Reject additional guarded requests during reloads
`dangerousButtonDelayTicks`	`20`	Delay before dangerous buttons become active
`showLoadedModCount`	`true`	Show the loaded mod count as context
`largeEnvironmentWarningThreshold`	`200`	Mod-count threshold for a non-blocking warning

Available policy values are ALLOW, CONFIRM, BLOCK, and RESTART_ONLY. The loaded mod count is used only for an informational warning; it never automatically blocks a reload or estimates its duration.

Known limitations

The mod does not predict reload duration or optimize the reload pipeline.
Mods that substantially replace the Resource Packs, Language, or Video Settings screens—or inject into the same vanilla methods—may conflict with its Mixins.
Server resource packs and reloads whose origin cannot be identified are outside the guard's scope.
The mod does not restart the Minecraft process automatically.