⚡ Better Ping & Latency Engine

Better Ping is an intelligent, high-performance network latency compensation and ping utility designed for modern Minecraft servers (Paper, Purpur, Spigot, and Folia).

Equipped with an interactive player network quality GUI, real-time TabList ping formatting, combat lag spike protection, projectile assist compensation, customizable hex latency tiers, and zero tick lag.

---

✨ Feature Highlights

• 📊 Interactive Network Quality & Ping GUI (/ping gui / /ping menu):

  • Full 54-slot interactive player network browser.
  • Displays authentic player heads with color-coded ping, jitter statistics, network quality stars (★★★★★), signal strength bars, and one-click diagnostic ping probes.
  • Server-wide network overview with live TPS, player count, lowest latency player, and overall network average.

• 🏷️ Dynamic TabList Ping Display:

  • Automatically appends player latency to their tab list name (e.g. Player [32ms]).
  • Configurable formatting with custom RGB and hex color codes.

• ⚠️ Combat Lag Spike & Packet Loss Guard:

  • Instant detection when a player's latency surges by over 80ms during gameplay.
  • Alerts players on actionbar so they understand connection instability before unfair PvP deaths occur.

• 🛡️ Adaptive Latency Compensation & Knockback Smoothing:

  • Dynamic profile switching between Casual, Balanced, and Competitive modes.
  • Fair combat grace shields and projectile trajectory assistance for international players.

---

🎮 Commands & Permissions

Command	Permission	Description
/ping	betterping.ping	Check your current latency & server average
/ping gui or /ping menu	betterping.ping	Open interactive Network Quality GUI
/ping <player>	betterping.ping.others	Check another player's latency
/ping hud	betterping.hud	Toggle real-time latency HUD on action bar
/ping top	betterping.top	View lowest & highest latency rankings
/ping test	betterping.test	Run real-time interactive latency probe
/betterping status	betterping.ping	Show detailed ping & jitter profile
/betterping tiers	betterping.admin	View configured latency tiers & hex colors
/betterping gui	betterping.admin	Open Admin Control Panel
/betterping reload	betterping.admin	Reload configuration & adaptive engine

---

🔌 PlaceholderAPI Support

Placeholder	Output
%betterping_ping%	Raw numeric ping (e.g. 45)
%betterping_ping_colored%	Formatted ping with color (e.g. §a45ms)
%betterping_quality%	Quality rating (Excellent, Good, Fair, High)
%betterping_quality_stars%	Star rating (★★★★★, ★★★★☆, ★★★☆☆)
%betterping_bar%	Visual colored signal bar (■■■■■, ■■■□□)
%betterping_jitter%	Latency jitter calculation (e.g. 2.4)
%betterping_spike%	Lag spike detection status (YES / NO)
%betterping_avg%	Overall server average latency

---

⚙️ Compatibility

• Minecraft Versions: 1.20 - 1.21.4+
• Platforms: Paper, Purpur, Spigot, Folia (Folia multi-threading verified).