fps boost adaptive

# FPS Boost

**Stop FPS drops before you notice them.** FPS Boost watches your framerate and automatically lowers expensive settings when it dips, then restores them when your game runs smoothly again. Always relative to *your own* settings.

## How it works

FPS are sampled once per second (menus, pause and unfocused windows are ignored). If you stay below your target for a few seconds, quality drops one level at a time:

| Level | Change |
|---|---|
| 1 | Fewer particles, entity shadows off |
| 2 | Clouds off, shorter entity distance and rain radius |
| 3 | Minimal particles, render distance -2 |
| 4 | Render distance -4, simulation distance capped at 8 |
| 5 | Render distance -6, simulation distance capped at 6 |

When FPS are comfortable again, it climbs back one level at a time, with anti-flapping protection so settings don't bounce up and down.

## Safe by design

- Your original settings are restored when you leave the world, disable the mod, or close the game.
- If the game crashes while settings are lowered, they are restored on the next launch.
- If you change a setting yourself while a level is active, your value becomes the new reference.
- Every setting the mod may touch can be disabled individually in the config.

## Works with everything

FPS Boost works on its own and stacks with Sodium, Lithium, EntityCulling, ImmediatelyFast, FerriteCore, Iris and more.
It does **not** replace them: it doesn't rewrite the renderer. For the biggest raw FPS gain, install **Sodium** too, and let FPS Boost handle the sudden drops.

## Commands

- `/fpsboost` : show status (level, FPS, target)
- `/fpsboost on` / `/fpsboost off`
- `/fpsboost target <20-240>` : set your target FPS

## Configuration

`config/fpsboost.json` : `targetFps`, `minRenderDistance`, `minSimulationDistance`, `degradeAfterSeconds`, `recoverAfterSeconds`, and `adjustParticles`, `adjustShadows`, `adjustClouds`, `adjustEntityDistance`, `adjustWeather`, `adjustRenderDistance`, `adjustSimulationDistance` (true/false).

## Requirements

Minecraft 26.2+, Fabric Loader 0.19+, Fabric API, Java 25. Client-side only: no need to install it on servers.

Available in English and French.