Sodium Relief

🚀 Smooth your Minecraft inventory experience

Minecraft inventories can feel slightly stuttery — especially when hovering items, opening chests, or using modded GUIs.
Sodium Relief is a lightweight, client-side optimization mod that reduces small tooltip and hover-related stutter without changing gameplay.

⚙️ What it does

Smooths tooltip rendering on inventory-like screens
Reduces redundant tooltip recalculations
Stabilizes hover behavior when moving the cursor across items
Caches text-width measurements for repeated strings (like item stack counts)
Improves responsiveness in chests, menus, and modded interfaces

📊 Measured impact

The effect is less redundant work, not more frames — so it's measured as tooltip builds avoided, not FPS. The numbers come from an automated in-game test that opens a real inventory screen, hovers items, and counts the actual tooltip builds it reused instead of rebuilding every frame:

Scenario	Tooltip draws	Real builds with Sodium Relief	Avoided
Resting on one item	2,429	2	99.9%
Scanning 36 items (3 passes)	3,714	38	~99%

Each tooltip build was measured at ~0.1–0.3 ms, so the reuse avoids roughly half a second of CPU work over the ~20-second test — work that would otherwise land as tiny per-frame hitches while you hover. Near-identical across the whole 1.21 – 26.2 range, and reproducible — every measurement is exported as a raw snapshot, and you can capture one yourself any time from the Export Benchmark button in the settings.

🧠 How it works

Sodium Relief optimizes the tooltip pipeline by:

• caching tooltip layout results (LRU + TTL)
• reusing previously computed tooltip data on unchanged hovers
• avoiding unnecessary recomputation during fast cursor movement
• caching repeated text-width measurements instead of recomputing them every frame
• applying lightweight hover-smoothing logic

All optimizations are client-side, safe, and designed to work alongside Sodium. When in doubt about an item or screen, it falls back to vanilla behavior.

🎯 When it helps

You'll notice the biggest improvement when:

• opening large inventories (chests, storage systems)
• quickly hovering over many items
• using mods with heavy or complex tooltips
• experiencing subtle UI micro-stutter

❗ What this mod does NOT do

• ❌ Does NOT increase FPS in the world
• ❌ Does NOT optimize chunks, rendering, or GPU load
• ❌ Does NOT act as a general performance booster

This is a focused GUI-smoothness mod, not a full optimization suite.

🧩 Compatibility

• ✔ Fabric — Minecraft 1.21 – 1.21.11 (Java 21) and 26.1.x / 26.2 (Java 25)
• ✔ Client-side only
• ✔ Requires Fabric API · works best alongside Sodium · Mod Menu optional
• ✔ Server-safe (no gameplay changes)
• 🌍 Available in English, Russian and Ukrainian

💡 Why use Sodium Relief?

Most performance mods focus on rendering or world logic.
Sodium Relief focuses on UI smoothness — solving a small but noticeable source of micro-stutter that's usually ignored.

📦 Installation

1. Install Fabric Loader + Fabric API
2. Download the jar matching your Minecraft version
3. Drop it into your mods/ folder

(Installing through the Modrinth App handles dependencies for you.)

❤️ Support

If you enjoy the mod, consider supporting development or leaving feedback — it directly shapes future versions.

---

Disclaimer

Sodium Relief is an unofficial, independent companion mod. It is not affiliated with, endorsed by, or sponsored by CaffeineMC or the Sodium project, and it does not include or modify any Sodium code.

Sodium is the work of CaffeineMC. Sodium Relief is simply designed to work well alongside it. All product names, logos, and brands are property of their respective owners.