PapiOptimization
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.
⚙️ How it works
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.
✨ Features
🎯 Smart Entity Culling
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.
📦 Block Entity Culling
Chests, barrels, furnaces and other block entities behind walls aren't rendered. Massive help in storage rooms and warehouses.
🌲 Fast Leaves
Leaf faces touching other leaves are not rendered — dramatically fewer faces in forests and jungles, where vanilla FPS usually tanks.
🐷 Distance-Based Mob LOD
When many mobs are on screen, far-away mobs are progressively hidden based on distance, keeping crowded areas (farms, raids) smooth.
🧠 Server-Side Mob AI Throttling
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.
🔇 Sound Culling
Distant hostile/neutral mob sounds that you'd barely hear anyway are skipped, reducing sound engine overhead.
🔭 Dynamic Render Distance
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.
✨ Adaptive Particles
Particle density is temporarily reduced under heavy load and restored when FPS is back to normal.
❓ Why PapiOptimization?
- ✅ Adaptive — only sacrifices visuals when you actually need the frames
- ✅ Respects your settings — everything is restored when FPS recovers
- ✅ Lightweight — optimization logic itself is heavily optimized (cached raycasts, pooled objects, fastutil collections)
- ✅ Client & server — helps both FPS and TPS