PapiOptimization is an adaptive, zero-config performance mod for Forge. Unlike most optimization mods that apply the same static tweaks all the time, PapiOptimization monitors your FPS in real time and automatically scales its optimizations up or down — staying invisible when your game runs smoothly and stepping in aggressively when frames start to drop.
Install it and forget it. No config files, no setup, no commands.
The mod tracks your smoothed FPS and switches between three optimization levels:
| Level | When | What happens |
|---|---|---|
| 🟢 Normal | 60+ FPS | Light optimizations only, full visual quality |
| 🟡 Medium | 30–60 FPS | Moderate culling, reduced particles |
| 🔴 Aggressive | below 30 FPS | Maximum optimizations to recover playable framerates |
When your FPS recovers, everything (render distance, particles) is restored back to your original settings — the mod never permanently overrides your options.
Entities hidden behind walls are skipped from rendering using budgeted raycasts (no stutter from the checks themselves). Entities outside your field of view are culled too. Big FPS gains in mob farms, villages and caves.
Chests, barrels, furnaces and other block entities behind walls aren't rendered. Massive help in storage rooms and warehouses.
Leaf faces touching other leaves are not rendered — dramatically fewer faces in forests and jungles, where vanilla FPS usually tanks.
When many mobs are on screen, far-away mobs are progressively hidden based on distance, keeping crowded areas (farms, raids) smooth.
Mobs far from any player run their AI at reduced rates (down to 5% for very distant ones), smoothly scaling back to 100% as players approach. Mobs near you always behave completely normally. Works on servers and in singleplayer — reduces TPS lag from large mob counts.
Distant hostile/neutral mob sounds that you'd barely hear anyway are skipped, reducing sound engine overhead.
When FPS drops hard, render distance is gradually lowered; when performance recovers, it's gradually restored to your chosen value. Automatically disables itself if Voxy or Distant Horizons is installed to avoid conflicts.
Particle density is temporarily reduced under heavy load and restored when FPS is back to normal.
