Modrinth · Minecraft mod
FPSFlow
Improve FPS with smart rendering, entity culling, adaptive optimizations, and configurable performance profiles
Quick answer
Which FPSFlow release should I use?
FPSFlow 1.8.3 targets 1.21.11 with Fabric. It must be installed on the client. Do not install it on the dedicated server. No extra mods listed for this file.
Where it goes
Is FPSFlow required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does FPSFlow 1.8.3 need?
1.8.3. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add FPSFlow without breaking your instance.
Built for FPSFlow 1.8.3. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.8.3. It targets 1.21.11 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.8.3. It opens that exact file at the source.
About this project
What does FPSFlow add?
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
Project description from Modrinth.
Pick your setup
FPSFlow by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
FPSFlow versions and loaders
1.8.3
fpsflow-1.8.3-mc1.21.11-java21.jar
29 Jul 2026
1.8.3
fpsflow-1.8.3-mc26.2-java25.jar
29 Jul 2026
1.8.2
fpsflow-1.8.2-mc1.21.11-java21.jar
26 Jul 2026
1.8.2
fpsflow-1.8.2-mc26.2-java25.jar
26 Jul 2026
1.8.1
fpsflow-1.8.1-mc1.21.11-java21.jar
24 Jul 2026
1.8.1
fpsflow-1.8.1-mc26.2-java25.jar
24 Jul 2026
1.8
fpsflow-1.8-mc1.21.11-java25.jar
23 Jul 2026
1.8
fpsflow-1.8-mc1.21.11-java21.jar
23 Jul 2026
1.7.14
fpsflow-1.7.14.jar
24 Jun 2026
1.7.13
fpsflow-1.7.13.jar
23 Jun 2026
1.7.12
fpsflow-1.7.12.jar
22 Jun 2026
1.7.11
fpsflow-1.7.11.jar
13 Jun 2026
Looking for an older file? The official Modrinth project page is in Resources.
