Potassium

Potassium is a lightweight, client-only Fabric optimisation mod focused on reducing repeated rendering and UI work while preserving Minecraft's vanilla gameplay and renderer behaviour.

It targets small, frequent costs in HUD updates, text measurement, maps, particles, and supported 3D-world rendering paths. Potassium does not change world generation, mob AI, combat, redstone, game rules, or server tick logic.

It is designed to work alongside popular Fabric optimisation mods such as Sodium, Lithium, FerriteCore, Entity Culling, ModernFix, and Iris.

Features

3D-world render scaling

On supported vanilla/OpenGL-style framebuffer paths, Potassium can render the 3D world below the window resolution and upscale it before Minecraft draws the native-resolution UI.

• Potassium Spatial: fast linear scaling with low overhead.
• Potassium Edge-Aware: an original five-tap edge-aware filter.
• Potassium Sharp: an original nine-tap sharpening filter with slightly higher GPU cost.

Render scaling is automatically paused when Iris, VulkanMod, or another renderer owns final frame composition. It is most useful when the game is GPU-bound and is not guaranteed to increase FPS on CPU-bound systems.

Cosmetic particle pacing

During dense particle scenes, allowlisted cosmetic particles beyond the normal visibility range may tick less often.

• Gameplay-critical particles, unknown particle classes, and interaction feedback keep vanilla behaviour.
• Mining and attack input bypass the cosmetic pacing path.
• The goal is steadier frame pacing during explosions, campfires, and other particle-heavy scenes.

Particle light reuse

Repeated light lookups for an unchanged particle position can reuse a bounded result while the particle state remains valid.

Bounded text & layout caches

Repeated short text-width and wrapped-layout calculations use bounded in-memory caches.

• Helps menus, chat, scoreboards, overlays, and Mod Menu screens.
• Cache entries are cleared after font resources reload.
• Bounded storage avoids unrestrained memory growth during long sessions.

Map update pacing

Initialised map render states can pace refresh calls to approximately once every 33 milliseconds while their decorations remain unchanged.

New map textures and decoration changes update normally. Pixel updates may therefore appear slightly later, while item-frame maps remain protected from uninitialized-texture crashes.

Chunk compile pacing

The combined 26.1 build includes conservative distant-chunk compile admission, with larger budgets during fast movement or larger dirty-section backlogs. This hook is disabled when Sodium owns chunk rendering.

In-game counters & settings

Potassium provides a Mod Menu settings screen with upscaling choices, compatibility status, and performance counters. Counters report work avoided by Potassium’s paths; they are not an FPS benchmark.

Supported versions

• Minecraft 1.21.11, Java 21+
• Minecraft 26.1-26.1.2, Java 25+
• Minecraft 26.2, Java 25+

Fabric API is required. Mod Menu is optional.

Reporting issues

Please report crashes, visual problems, and compatibility issues at:

https://github.com/topluci/potassium/issues

Include the Minecraft version, Potassium version, installed rendering mods, steps to reproduce, and the relevant log or crash report.