Potassium

Potassium is a Fabric mod that improves rendering safety, frame pacing, and stability fixes. It maintains vanilla visual feedback while reducing redundant rendering in particle-heavy scenes, UI updates, map changes, and the 26.x renderer paths. As a lightweight client-side mod, Potassium enhances areas of Minecraft not heavily optimised by other mods.

Instead of replacing the rendering engine or rewriting major systems, it targets small inefficiencies in UI updates, animations, particles, and background systems.

It is designed to work alongside other popular optimisation mods such as Sodium and Lithium.

✨ Features

HUD Render State Throttle

Reduces redundant HUD processing when values haven't changed.

Health, hunger, and status effects skip state extraction for up to 3 frames when unchanged.
Prevents unnecessary UI recalculation.
Status-effect overlay extraction is skipped when the same effect state is rebuilt multiple times in the same tick. Prevents unnecessary UI recalculation without causing HUD flashing.

Entity Animation LOD

Introduces distance-based animation updates for entities.

Mobs beyond 32 blocks stop updating their walk animations.
Movement, AI, attacks, and damage are completely unaffected.
Only the cosmetic leg-swing animation pauses.

Particle Group Throttle

Optimises particle updates when many particles are on screen.

When more than 64 particles are visible, particle ticking is slightly reduced.
Helps stabilise performance during particle-heavy effects.

Text Width Cache

Caches text width calculations used by UI elements.

Avoids repeated font measurement operations.
Improves performance in menus, chat, and scoreboards.

Map Texture Throttle

Reduces how often map textures refresh.

Maps update 4× slower visually.
Significantly reduces texture updates.

Sound Engine Tracking

Adds lightweight monitoring for sound updates.

Tracks sound system behaviour to identify redundant updates.

Scoreboard Sidebar Throttle

Optimises scoreboard update frequency.

EXPECT BUGS

📦 Requirements

Fabric Loader 0.18.4+
Fabric API >0.145.2
Java 21 or newer for 1.21.x builds
Java 25 or newer for 26.x builds