Описание
## 🚀 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.
[](https://ko-fi.com/erotoro)
### ⚙️ 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](https://github.com/CaffeineMC). Sodium Relief is simply designed to work well alongside it. All product names, logos, and brands are property of their respective owners.