mcmodwiki
Mods › FramePilot

FramePilot

FramePilot is a Fabric Minecraft mod that boosts performance automatically. It detects your GPU and applies a tuned settings profile, then dynamically adjusts render distance, particles, and entity scaling to hold a target FPS.

24 config settings

Build 1.0.0 · checked 13 September 2026

Guides

Config

  • Adjust Entity Distance adjust_entity framepilot — Scale entity render distance up or down with FPS changes.
  • Adjust Particles adjust_particles framepilot — Reduce particle count when FPS is low.
  • Adjust Render Distance adjust_render framepilot — Uses a soft render cap to reduce visible chunks without full reloads.
Show all 24 settings
  • Adjust Simulation Distance adjust_simulation framepilot — Adjusts simulation distance (can trigger chunk/simulation reloads).
  • Adjustment Cooldown cooldown framepilot — Minimum seconds between adjustments to avoid rapid switching.
  • FramePilot Auto Tune enabled framepilot — Automatically applies a GPU-based preset to your settings. Use Apply Now to run it immediately.
  • Max Entity Distance max_entity framepilot — Maximum entity distance scaling (percentage).
  • Max Render Distance max_render framepilot — Highest render distance the governor can use.
  • Max Simulation Distance max_simulation framepilot — Highest simulation distance the governor can use.
  • Min Entity Distance min_entity framepilot — Minimum entity distance scaling (percentage).
  • Min Render Distance min_render framepilot — Lowest render distance the governor can use.
  • Min Simulation Distance min_simulation framepilot — Lowest simulation distance the governor can use.
  • Target FPS target_fps framepilot — Target FPS the governor aims to hold. Higher targets may lower visuals more often.
  • FPS Tolerance tolerance framepilot — How far FPS can drift from target before changes kick in.
  • Apply Once apply_once framepilot — When ON, tuning runs only once per GPU model. Turn OFF to re-apply on every launch.
  • Block Entity Culling block_entity_culling framepilot — Stops rendering block entities (chests, signs) at long distances.
  • Block Entity Culling Distance block_entity_culling_distance framepilot — Max distance for block entities when culling is enabled.
  • Chunk Upload Throttle chunk_upload_throttle framepilot — Limits chunk mesh uploads per frame to reduce frame spikes.
  • Max Uploads Per Frame chunk_upload_throttle_max framepilot — Maximum mesh uploads allowed per frame.
  • Entity Culling entity_culling framepilot — Stops rendering entities beyond the distance limit to save FPS.
  • Entity Culling Distance entity_culling_distance framepilot — Max distance for entity rendering when culling is enabled.
  • FPS Overlay hud_enabled framepilot — Show a small FPS-change overlay above the hotbar.
  • Mode mode framepilot — Performance boosts FPS, Balanced mixes FPS and visuals, Quality favors visuals.
  • Reset to Defaults reset_defaults framepilot — Restore all FramePilot settings to their defaults.

Requires

ModNeededVersions
fabric-api required *

Needs Java >=21.

Frequently Asked Questions

How does FramePilot optimize frame rates automatically?

It identifies installed graphics hardware on launch to select a baseline preset and runs an adaptive governor to tune render distance and entity limits during gameplay.

What do the different tuning modes do in FramePilot?

Performance focuses purely on high frame rates, Balanced offers a middle ground between visuals and speed, and Quality preserves visual fidelity.

Can FramePilot cull chests and signs in large bases?

Yes, enabling Block Entity Culling stops rendering containers and signposts that sit beyond the configured distance threshold.

How do you stop FramePilot from switching settings too rapidly?

Increase the Adjustment Cooldown timer or widen the FPS Tolerance range so the governor requires sustained frame drops before adjusting visual options.

Download Links

Mods › FramePilot