PlayerPing

PlayerPing Mod

A server-side port of the original PlayerPing plugin by HoneyBerries, now available for Fabric and NeoForge modded servers.

For Fabric servers, Fabric API is required.

🆕 What’s New in 1.1.1

• Fixed the critical admin-permission glitch from 1.1.0 that could block /pingplayer commands in-game.
• Fixed the critical glitch causing crashes on multiple versions of fabric servers (1.21.5 to 1.21.11).
• Added support for modern admin permission setups:
• Vanilla OP users
• Permission node: playerping.admin
• LuckPerms weight fallback (minLuckPermsWeight, default: 8)
• Added /ip (self lookup) for all players.
• Added /pingplayer debug to toggle full server-side diagnostics.
• Added /pingplayer dump to generate a full diagnostic report.
• Improved in-game help UI with cleaner formatting and readability.
• Added config header warnings and safer config parsing.

✨ Features

• 🔍 Ping Check – Use /ping for self, /ping <player> for admin checks.
• 🌐 IP Lookup – Use /ip for your own public IP, /ip <player> for admin lookup.
• 📋 Tablist Ping Display – Ping values shown directly in the tab list with quality colors.
• 🎛️ Live Threshold Management – Edit ping tiers in-game with /pingplayer threshold ....
• 🚦 Quality Colors – Clear ping quality indicators (Excellent → Terrible).
• 🛠️ Debug + Dump Tools – Built-in diagnostics for troubleshooting and crash investigation.

Commands

| Command | Description | Permission |
|——–|————-|————|
| /ping | Get your own ping | All players |
| /ping <player> | Check another player’s ping | Admins |
| /ip | Get your own public IP | All players |
| /ip <player> | Get another player’s public IP | Admins |
| /pingplayer help | Show admin command help | Admins |
| /pingplayer debug | Toggle full debug mode on/off | Admins |
| /pingplayer dump | Generate a full diagnostic dump report | Admins |
| /pingplayer threshold <excellent\|good\|fair\|poor\|terrible> | Show current threshold for a tier | Admins |
| /pingplayer threshold <tier> equal-or-more <value> | Set tier to >= value | Admins |
| /pingplayer threshold <tier> equal-or-less <value> | Set tier to <= value | Admins |
| /pingplayer threshold <tier> equal <value> | Set tier to exact value | Admins |
| /pingplayer threshold <tier> <min> <max> | Set tier to a range interval | Admins |

Examples

• /pingplayer threshold terrible equal-or-more 500
• /pingplayer threshold fair 101 250
• /pingplayer debug
• /pingplayer dump

🧪 Diagnostics

When you run /pingplayer dump, the mod creates a full diagnostic report at:

config/player-ping/crash_reports/

Fabric file naming format:
pingplayer_crash_MMddyyyy_fabric.txt

🎨 Ping Quality Indicators

• 🟢 Green — Excellent
• 🟡 Yellow — Good
• 🟠 Gold — Fair
• 🔴 Red — Poor
• 🟥 Dark Red — Terrible

(Default ranges are configurable.)

💻 Installation

1. Download the .jar for your loader.
2. Place it in your server /mods folder.
3. Restart the server.

🔖 Compatibility

• Minecraft: 1.21.x
• Loaders: Fabric, NeoForge
• Side: Server-side
• Java: 21