Skip to content

Settings

Zaldaryon edited this page Jul 3, 2026 · 6 revisions

Settings

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

Switches

Setting What it controls Default
Limit Background FPS Cap to 30 FPS when the window loses focus ON
Smooth Frame Pacing Hybrid sleep/yield/spin frame limiter ON
Skip Distant Shadows Skip shadow draws beyond the distance threshold ON
Skip Distant Collisions Skip repulsion physics beyond the distance threshold ON
Scale Light Range Scale held-item light radius by view distance ON
Reduce Distant Animations Reduce tick rate for distant animated block entities ON
Skip Foliage Far Shadows Skip vegetation in the far shadow cascade ON
Throttle Wind Updates Cache wind speed for 4 frames instead of every frame ON
Reduce Distant Particles Skip particle emitters beyond 48 blocks ON
Simplify Distant Chiseled Blocks Render far chiseled blocks as solid cubes ON

Sliders

Setting Range Default Unit
Shadow Distance 20-200 80 blocks
Collision Distance 16-128 64 blocks
Chisel LOD Distance 32-256 48 blocks

Non-Configurable Optimizations

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

  • 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 (IsRendered flag)
  • Entity render distance pre-cull
  • Lock contention reduction (System.Threading.Lock)
  • Server GC with DATAS
  • Bilateral blur 7-tap shader
  • Water foam 3x3 shader

Persistence

Settings persist to ModConfig/optimum.json in your data path. Each toggle and slider writes immediately on change. Removing Optimum and reverting to vanilla ignores this file.

Clone this wiki locally