PotatoMode – Smart FPS Booster

Love the clear, player‑friendly writeup you already have; here’s a refreshed version that matches the v2 upgrade and keeps your tone.

PotatoMode v2 – Smart FPS Booster (Fabric 1.21.4)

PotatoMode v2 is a lightweight, client‑side Fabric mod that boosts performance on low‑end systems by dynamically adjusting Minecraft’s built‑in video settings using real‑time FPS monitoring.

This mod does not replace the renderer or inject custom graphics pipelines. It simply manages vanilla options intelligently to reduce load when needed.

How It Works (Technical Explanation)

PotatoMode v2 continuously samples client FPS and frame time.

When performance drops below a configurable target, the mod applies staged optimizations in steps (Light, Medium, Heavy) instead of a single hard switch. These stages can be tuned with presets:

Balanced, Aggressive, and Extreme.

When FPS recovers above a separate Recovery FPS value, PotatoMode can gradually restore your original settings using Smart Restore.

Affected vanilla settings may include:

Render distance

Simulation distance

Particle count

Entity distance scaling

Cloud rendering

Smooth lighting

Biome blend

Mipmap levels

The mod is client‑only and never changes:

Game logic

World generation

Server performance

Renderer internals

It only modifies existing Minecraft client video settings.

Features

Staged FPS‑based optimization (Light, Medium, Heavy)

One‑click MAX FPS mode

Configurable Recovery FPS + Smart Restore

3 tuning presets: Balanced, Aggressive, Extreme

Lag spike detection

Expanded HUD with avg FPS and frame time (optional)

Hotkeys: F8 opens settings, F9 toggles Max Mode

Sodium‑friendly access to the config screen

Fully configurable

Intended Audience

Low‑end PCs

Integrated graphics users

Players who experience FPS drops in dense environments

Users who want automatic optimization without manual tweaking

Disclaimer

This mod does not guarantee a fixed FPS increase. Performance gains depend on hardware, installed mods, and in‑game conditions.