Potassium

Potassium is a lightweight client-side optimisation mod for Fabric that focuses on improving parts of Minecraft not heavily optimised by other performance mods.

Instead of replacing the rendering engine or rewriting major systems, Potassium targets small but frequent inefficiencies in UI updates, animations, particles, and other 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 API >0.145.2+26.1.1
• Java 25+