AnimationBudget
AnimationBudget is a client-side performance mod for Minecraft 1.21.1 that reduces Distant Horizons load when the frame rate drops and gradually restores quality after performance recovers.
Features
- Adaptive Distant Horizons render distance and quality based on a 10-second frame-time window, average FPS, and tail-frame performance.
- Fast stepped reduction after sustained low FPS, slow recovery after sustained stable performance, and a rebuild cooldown between adjustments.
- Uses Distant Horizons API overrides without rewriting the user's DistantHorizons.toml file.
- Ignores menus, paused or loading screens, inactive windows, non-player cameras, and abnormal long frames.
- Optional client-side block entity animation throttling using an exact registry ID allowlist.
- Observation mode reports block entity animation candidates without skipping them.
Block Entity Animation Policy
This feature is disabled by default, and the default allowlist is empty. No block entity animations are skipped until you explicitly enable the feature and configure full registry IDs.
When enabled for an allowlisted type:
- Within 32 blocks: full-speed animation.
- Between 32 and 64 blocks: one update every four ticks with staggered phases.
- Beyond 64 blocks: animation updates pause.
Server-side tickers always run normally. AnimationBudget does not freeze server machines, Create contraptions, networking, world saves, or arbitrary mods.
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.248 or newer
- Java 21
- Distant Horizons 3.3.3 or newer is optional, but required for adaptive distant-terrain control
Configuration
The client configuration is stored at config/animationbudget-client.toml.
distantHorizons.adaptiveEnabled: enables adaptive Distant Horizons control.distantHorizons.targetFps: target frame rate, 60 by default.blockEntityAnimation.enabled: enables animation throttling, false by default.blockEntityAnimation.observationMode: enables candidate statistics, true by default.blockEntityAnimation.targets: exact block entity registry ID allowlist, empty by default.
Example allowlist entry: minecraft:chest.
License
LGPL-3.0.