FPSFlow
Real FPS improvements — no placebo, no bloat.
FPSFlow is a client-side Fabric optimization mod that targets the biggest rendering bottlenecks in vanilla Minecraft. Every feature is measurably effective, individually toggleable, and automatically adjusts to your hardware via four built-in performance profiles.
✦ Features at a Glance
| Feature | What it does | |
|---|---|---|
| 🔍 | Entity Culling | Frustum, occlusion, and distance culling. Dual-point raycasting prevents false-positives on small entities. Auto-disables when EntityCulling is detected. |
| 📐 | Entity LOD | Entities beyond a configurable distance render every 2nd tick. Server NPCs and entities within nameplate range are always fully exempt — no flicker, even in busy lobbies. |
| 🏷️ | Nameplate Culling | Hides name tags beyond a configurable distance. Server-forced labels are never hidden. |
| 🧱 | Block Entity Culling | Skips chests, furnaces, signs, banners, and item frames beyond the configured range. |
| ✨ | Particle Optimization | Count cap + three-zone density LOD (full / ~50 % / none) based on distance from player. |
| 🖼️ | Painting Back-Face Culling | Instantly skips paintings when the camera is behind them — they are never visible from the back. |
| 🌙 | Background FPS Limiter | Caps frame rate when the window loses focus, is minimised, or on any loading/menu screen (reduces GPU spinning during startup). |
| 🌍 | Singleplayer Boost | More aggressive adaptive culling in singleplayer — frees CPU for chunk generation threads so exploration stays smooth. |
| ⚡ | World Join Optimizer | Culling distances ramp up from 35 % on join and return to 100 % over ~10 seconds — eliminates the initial FPS spike. |
| 🎮 | GUI & HUD Optimizer | Dirty-flag hotbar caching (including CustomModelData); HUD throttling with immediate response to actual stat changes. Caches auto-clear on resource-pack reload to prevent stale item textures. |
✦ Performance Profiles
One setting, four presets — changing the profile rewrites all other settings automatically.
| Profile | Entity Dist. | BE Dist. | LOD threshold | Nameplate | Particle (mid/max) | BG FPS (unfoc/min/menu) |
|---|---|---|---|---|---|---|
| Quality | 128 b | Off | 128 b | Off | Off | 30/10/120 |
| Balanced (default) | 64 b | 64 b | 96 b | 32 b | 32/64 b | 60/30/120 |
| Performance | 48 b | 48 b | 64 b | 24 b | 16/32 b | 10/3/120 |
| Ultra Performance | 32 b | 32 b | 40 b | 16 b | 8/16 b | 5/2/60 |
Set
"profile": nullin the config to use fully custom values.
✦ Compatibility
FPSFlow detects installed mods at startup and automatically disables overlapping features.
| Mod | Status |
|---|---|
| 🟢 Sodium | Fully compatible — FPSFlow adds entity/GUI optimizations on top |
| 🟢 Lithium | No overlap — both run independently |
| 🟢 FerriteCore | No overlap — both run independently |
| 🟢 ModernFix | No overlap — both run independently |
| 🟢 ModMenu | Optional — enables in-game config screen |
| ⚡ EntityCulling (tr7zw) | FPSFlow's built-in culling disables automatically — recommended companion for superior occlusion accuracy |
| ⚡ ImmediatelyFast | FPSFlow's HUD caching defers automatically |
Recommended stack: Sodium + Lithium + FerriteCore + ImmediatelyFast + EntityCulling + ModMenu + FPSFlow
✦ Installation
- Install Fabric Loader for Minecraft 1.21.11
- Download and install Fabric API
- Drop the FPSFlow
.jarinto yourmods/folder - (Optional) Install ModMenu for the in-game settings screen
- Launch — the config is written automatically on first run
✦ FAQ
Does FPSFlow conflict with Sodium, Lithium, or FerriteCore? No. FPSFlow is designed to complement these mods — install all of them together.
Can entities "pop in" with occlusion culling? Rarely. The cache refreshes every 10 ticks (configurable). FPSFlow samples the entity's eye position for the raycast — naturally above the geometric centre, which avoids false-positives for small entities like floating heads and armor stands.
Does this work on servers? FPSFlow is purely client-side — works with any server, no server installation required. Servers that send a custom resource pack are fully supported: FPSFlow detects the pack reload and pauses render throttles for ~3 seconds so item-frame maps and hotbar items always show the correct textures after the pack loads.
✦ Partner
🎨 Create Custom Minecraft Content with NexoMaker
Create custom items, mobs, blocks, recipes, and more — without coding.
Compatible with Nexo, ItemsAdder, and other modern custom-content systems.
💜 Use code MCAFFE13 to get 15% off!
👉 Get started with NexoMaker
⚠️ ItemsAdder or Nexo required for exported content.
✦ Source & License
GitHub — McAffe13/FPSFlow · Licensed under the Mozilla Public License 2.0
