Settings

Settings

Optimum adds an Extra tab to the client settings dialog. All toggles default to ON.

Switches

Setting	What it controls	Default
Background FPS Limit	Cap to 20 FPS when the window is unfocused	ON
Precise Frame Pacing	Hybrid sleep/yield/spin frame limiter	ON
Entity Shadow Cull	Skip shadow draws beyond the distance threshold	ON
Entity Repulsion Gate	Skip repulsion physics beyond the distance threshold	ON
Dynamic Light Scale	Scale held-item light radius by view distance	ON
Animated Block LOD	Reduce animation tick rate for distant block entities	ON

Sliders

Setting	Range	Default	Unit
Shadow Cull Distance	20-200	80	blocks
Repulsion Gate Distance	16-128	64	blocks

Non-Configurable Optimizations

The following run unconditionally because they produce identical output to vanilla with zero tradeoff:

• Weather wind cache (4 frames)
• Ambient sound position gate (skip when stationary)
• Fly sound volume deduplication (skip below 1% delta)
• BlockPos reuse in particle ticks
• Mat4f.Multiply inlining (compile-time)
• Animation check reorder (distance before frustum)
• Name-tag frustum reuse
• Bilateral blur 7-tap shader
• Water foam 3x3 shader

Persistence

Settings persist to clientsettings.json in your data path under the Optimum* keys. Removing Optimum and reverting to vanilla ignores these keys harmlessly.