PerceptiFrame
by KarmaSpace
PerceptiFrame cuts the render cost of small entity details that players rarely notice, so crowded scenes can run at higher frame rates.
What it does
Rather than a fixed rule set, the mod measures how long each entity feature pass takes on the CPU and learns a cost model from those timings. A scheduler then compares that measured cost with the projected on-screen size of each entity type, so the work that adds the least visible detail is the first to be trimmed. Eight safe warm-up samples are collected per entity type before the model is used.
When the Maximum FPS mode is switched on, extra layers with the lowest visibility and highest cost are removed, while base entity models stay visible. The effect is most noticeable in crowded places such as mob farms, multiplayer hubs, trading halls and armor stand displays, or any area with many equipped entities.
PerceptiFrame requires Fabric API and runs on the client alone, so a server needs no installation. Mod Menu is optional and adds a Configure button for the settings screen, which also opens with F10. The mod is published for Fabric only, for 1.21.11, under the MIT License; the code is not open source.
Key features
Self-learning performance model
Real CPU time of each entity feature pass is measured and used to build a moving cost estimate.
Maximum FPS mode
Work with the highest measured cost and the lowest visible value is dropped first, within a target frame budget.
Pixel-based detail prioritization
Each entity type is compared against its projected screen size, so distant or small entities lose detail first.
Adaptive shadow and layer protection
Entity shadow optimization can be tuned, and nearby outlined entities and optional player equipment layers can be protected from removal.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
How it compares
Smart Optimization, Xylene and StackCluster Optimizer are all client-side only Fabric mods for 1.21.11, released under All rights reserved and not open source. FPSFlow is client-side only and open source under the GNU Affero General Public License v3.0 only, for 1.21.11 – 26.2. Rhenium runs on either side, and neither side needs it, for 1.21.1 – 26.3, under All rights reserved.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| PerceptiFrame | Fabric | 1.21.11 | Client-side only | 2026-08-20 |
| Smart Optimization | Fabric | 1.21.11 | Client-side only | 2026-06-09 |
| Xylene | Fabric | 1.21.11 | Client-side only | 2026-05-21 |
| StackCluster Optimizer | Fabric | 1.21.11 | Client-side only | 2026-05-01 |
| FPSFlow | Fabric | 1.21.11 – 26.2 | Client-side only | 2026-07-29 |
| Rhenium | Fabric | 1.21.1 – 26.3 | Client or server, optional | 2026-10-06 |
Questions
Does PerceptiFrame need Fabric API?
Does a server need PerceptiFrame?
Which game version does PerceptiFrame support?
In the catalog
PerceptiFrame is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 19,862 mods support Minecraft 1.21.11.
More from KarmaSpace
Similar mods
What the author says
PerceptiFrame is a standalone client-side Fabric optimization mod for Minecraft 1.21.11 with a self-profiling render-cost scheduler. It measures the real CPU time of individual entity feature passes, learns a moving cost model for every entity type, and compares that cost with the entity's projected screen size…
Official listing
- Modrinth page
- modrinth.com/mod/perceptiframe
- Owner
- KarmaSpace
- Published
- 2026-08-20
- Updated on Modrinth
- 2026-08-20
- Facts verified
- 2026-10-15