⚡ Buff Optimizer

Latency Compensation & Prediction

by Diolez

---

What Is Buff Optimizer?

Buff Optimizer is a client-side Fabric mod for Minecraft 1.21.x that attempts to reduce the perceived delay of common gameplay interactions under high ping.

It does this through animation smoothing, client-side visual prediction, and adaptive interpolation — all applied locally on your client. The server is never affected, and no packets are modified.

Note: This mod improves how interactions look and feel on your screen. It does not reduce your actual network latency or guarantee identical behavior to a low-ping connection.

---

What It Does

🎯 Projectile Visual Prediction

Extrapolates the visual position of arrows, ender pearls, splash potions, and fishing rods client-side based on their last known velocity. This reduces the appearance of projectiles "snapping" or stuttering under packet delay.

This is a visual effect only — it does not change where projectiles land.

🏹 Bow & Crossbow Animation Smoothing

Attempts to smooth charge and release animations to better match your actual input timing. Results vary depending on your ping and server tick rate.

🍎 Consumable Animation Compensation

Applies a small client-side offset to eating, drinking, and item-use animation starts to reduce the visual gap between pressing use and seeing the animation begin.

🧈 Hand & Equip Animation Smoothing

Runs hand swing and item equip transitions through an exponential smoothing filter to reduce choppiness caused by inconsistent tick delivery.

📡 Adaptive Ping Tracking

Measures your ping every second using Minecraft's built-in player list data and uses an exponential moving average to drive all compensation systems. Higher ping results in stronger compensation; lower ping results in less.

🐛 Debug HUD

An optional on-screen overlay (enabled in config) showing your current ping, smoothed ping, and active prediction window in milliseconds.

---

Configuration

There is currently no in-game settings screen. All settings are edited manually in:

.minecraft/config/buffs-optimizer.json

This file is created automatically on first launch with default values.

Setting	Default	Description
predictionStrength	0.65	Prediction intensity (0.0–1.0)
smoothingIntensity	0.70	Animation smoothing strength (0.0–1.0)
animationSync	true	Enable animation compensation
projectileOptimization	true	Enable projectile visual prediction
pingAdaptation	true	Scale compensation to measured ping
debugMode	false	Show debug HUD overlay
performanceMode	false	Reduce CPU cost at some accuracy loss
maxPredictionMs	250	Maximum prediction window in ms (50–500)

---

Important Limitations

• All effects are visual only — server-side gameplay is unchanged
• Prediction accuracy depends heavily on connection stability
• Does not work as a substitute for a stable, low-latency connection
• No in-game config screen — JSON editing required
• Results will vary per server and network conditions

---

Installation

1. Install Fabric Loader for Minecraft 1.21.x
2. Install Fabric API
3. Place the Buff Optimizer .jar in your mods/ folder
4. Launch the game — config generates automatically on first run

---

Gallery

Screenshots and demonstration images coming soon. The debug HUD overlay and in-game visual differences will be shown here.

---

Compatibility

Mod	Status
Sodium	✅ Compatible
Lithium	✅ Compatible
FerriteCore	✅ Compatible
Iris Shaders	✅ Compatible
ModMenu	✅ Compatible

---

Credits

Original Author: Diolez Unauthorized redistribution without explicit credit to Diolez is prohibited.