Skip to content

FPSFlow

Improve FPS with smart rendering, entity culling, adaptive optimizations, and configurable performance profiles

by McAffe13· SniperJohnnyOptimization
Fabric
Loaders
Fabric
Downloads on Modrinth
18.7K
Followers on Modrinth
12
versions
36
Updated
July 29, 2026Jul 29
Published
in 2026

At a glance

Runs on Fabric
For Minecraft 1.21.11–26.2
Client only — no need to install it on the server
Latest version — 1.8.3 from July 29, 2026
License AGPL-3.0-only — free
Where it's needed
In gamerequiredOn servernot needed

Install in the game only; not needed on the server

Game versions1.21.11–26.2

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

FeatureWhat it does
🔍Entity CullingFrustum, occlusion, and distance culling. Dual-point raycasting prevents false-positives on small entities. Auto-disables when EntityCulling is detected.
📐Entity LODEntities 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 CullingHides name tags beyond a configurable distance. Server-forced labels are never hidden.
🧱Block Entity CullingSkips chests, furnaces, signs, banners, and item frames beyond the configured range.
✨Particle OptimizationCount cap + three-zone density LOD (full / ~50 % / none) based on distance from player.
🖼️Painting Back-Face CullingInstantly skips paintings when the camera is behind them — they are never visible from the back.
🌙Background FPS LimiterCaps frame rate when the window loses focus, is minimised, or on any loading/menu screen (reduces GPU spinning during startup).
🌍Singleplayer BoostMore aggressive adaptive culling in singleplayer — frees CPU for chunk generation threads so exploration stays smooth.
⚡World Join OptimizerCulling distances ramp up from 35 % on join and return to 100 % over ~10 seconds — eliminates the initial FPS spike.
🎮GUI & HUD OptimizerDirty-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.

ProfileEntity Dist.BE Dist.LOD thresholdNameplateParticle (mid/max)BG FPS (unfoc/min/menu)
Quality128 bOff128 bOffOff30/10/120
Balanced (default)64 b64 b96 b32 b32/64 b60/30/120
Performance48 b48 b64 b24 b16/32 b10/3/120
Ultra Performance32 b32 b40 b16 b8/16 b5/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.

ModStatus
🟢 SodiumFully compatible — FPSFlow adds entity/GUI optimizations on top
🟢 LithiumNo overlap — both run independently
🟢 FerriteCoreNo overlap — both run independently
🟢 ModernFixNo overlap — both run independently
🟢 ModMenuOptional — enables in-game config screen
⚡ EntityCulling (tr7zw)FPSFlow's built-in culling disables automatically — recommended companion for superior occlusion accuracy
⚡ ImmediatelyFastFPSFlow'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.

⚠️ ItemsAdder or Nexo required for exported content.

✦ Source & License

GitHub — McAffe13/FPSFlow · Licensed under the Mozilla Public License 2.0

FAQ

How to install FPSFlow?

Install Fabric for your Minecraft version, download FPSFlow for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does FPSFlow support?

FPSFlow has builds for Minecraft 1.21.11–26.2.

Is FPSFlow needed on the server?

Client only — no need to install it on the server

License and source
GNU Affero General Public License v3.0 onlyfree to use and share; changes to the mod itself must be published under the same license
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More