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": null in 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

1. Install Fabric Loader for Minecraft 1.21.11
2. Download and install Fabric API
3. Drop the FPSFlow .jar into your mods/ folder
4. (Optional) Install ModMenu for the in-game settings screen
5. 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