Dynamic FPS Idle Timing, Idle Conditions, and Forced Unfocused Mode

guide

Dynamic FPS lowers how much of your computer's resources Minecraft uses when the game is not the active window or when you have stopped providing input for a while. This guide covers the idle timer, the idle condition choices, forced unfocused mode, and the option that stops an accidental click from registering when you return to the game.

Idle Timing

The idle time setting controls how long the game waits before Dynamic FPS switches to the Idle state. Specifically, it sets the number of minutes without input until the Idle state activates while the game window is still focused. If you keep Minecraft in front of you but step away from the keyboard and mouse, this timer is what eventually triggers the reduction. A shorter time means the mod reacts sooner; a longer time means it waits before acting.

Idle Conditions

The idle condition setting decides when the Idle state is allowed to trigger. There are three choices.

None — Always activate the Idle state when the game has been inactive for too long. Under this choice, the idle timer applies regardless of power source.
Vanilla — Disable Dynamic FPS idling and use the vanilla setting instead. Choosing this hands idle behaviour over to the game itself rather than the mod.
On battery — Enable the Idle state when the game has been inactive for too long and the computer is running on battery.

Forced Unfocused Mode

Force Unfocused Mode (Toggle) makes the game behave as though its window is not focused, even when it is. Use the toggle to turn this on or off. While it is active, the mod shows the message Dynamic FPS: Forcing Reduced FPS, so you can tell at a glance that the reduced frame rate is being applied deliberately rather than because you switched away.

If you want to stop the mod from doing anything at all, use Disable Dynamic FPS (Toggle). When it is engaged, the game reports Dynamic FPS Disabled.

Ignoring Initial Clicks

Ignore Initial Click prevents accidental input from being registered when you click on the unfocused game window. Without it, that first click both brings Minecraft back to the foreground and lands on whatever is under your cursor. With it enabled, the click that refocuses the window is not passed through as game input.

Battery features sit alongside the idle settings and affect when the reduced state kicks in.

Battery Tracker — a master toggle for every battery-related feature.
Enable On Battery State — automatically turns on the On Battery state when the machine is running on battery power.
Battery Notifications — delivers in-game notifications about your battery status.
Critical Charge Threshold — sets which charge level counts as critical.
Use Mock Battery Data — supplies simulated battery data.
Battery Indicator Condition and Battery Indicator Placement — control the on-screen battery indicator, including whether it appears while the debug overlay is open.

Battery features rely on an additional library. You are asked whether the mod may obtain this component for you. If that is declined, the library is unavailable; if the machine is unsupported, the feature cannot run; and if the transfer fails, an error is shown. In these cases the game reports Dynamic FPS Battery Error.

Uncap Menu Frame Rate — removes the 60 FPS limit in the main menu.
Show Toasts — decides whether notifications are displayed right away or held back.
Invoke Garbage Collector — frees unused memory when the game switches to this status.
Minimal Graphics State — a lower graphics setting; note that it causes the world to reload.
Upward Volume Transition Speed and Downward Volume Transition Speed — set how quickly game volume is adjusted per second.

Opening the Settings

The configuration screen is titled Configure Dynamic FPS. To reach it from inside Minecraft, Cloth Config must be present. If it is not, you have three options: add Cloth Config, edit the configuration outside the game, or simply keep the default settings.

Hotkey-driven actions such as the forced unfocused toggle are bound through the corresponding hotkey, which you set in the controls menu.