Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
PlayerPing Mod
A server-side port of the original PlayerPing plugin by HoneyBerries, for modded Minecraft servers.
For Fabric servers, Fabric API is required.
๐ What's New in 1.2.0
- Supports versions from 1.21.x up to 26.3.
- More accurate ping: the server measures each connection itself once per second, so
/pingnow also shows jitter and packet loss. - The tab list keeps team colors and prefixes instead of replacing the player's name.
- The tab list now refreshes once per second instead of 20 times per second, which is lighter on busy servers.
- New
/ping list: see every online player's ping at once, highest first (admins, also works from the console). - New
/pingplayer reload: apply config changes without restarting. If the file has a mistake, the reload is refused and your current settings stay. - New Placeholder API support, so holograms and similar mods can show a player's ping.
/ipnow says "IP (as seen by the server)" for better clarification.
โจ Features
- ๐ Ping Check -
/pingfor yourself,/ping <player>and/ping listfor admins. - ๐ก Measured Ping - Real round-trip time with jitter and packet loss, instead of Minecraft's smoothed value.
- ๐ IP Lookup -
/ipfor your own IP,/ip <player>for admins. - ๐ Tablist Ping Display - Ping shown in the tab list with quality colors, compatible with scoreboard teams.
- ๐๏ธ Live Threshold Management - Edit ping tiers in-game with
/pingplayer threshold .... - ๐งฉ Placeholders -
%pingplayer:ping%and%pingplayer:quality%for mods that use Placeholder API. - ๐ ๏ธ Debug + Dump Tools - Built-in diagnostics for troubleshooting.
Commands
| Command | Description | Permission |
|---|---|---|
/ping |
Get your own ping | All players |
/ping <player> |
Check another player's ping | Admins |
/ping list |
List every online player's ping | Admins |
/ip |
Get your own IP | All players |
/ip <player> |
Get another player's IP | Admins |
/pingplayer help |
Show admin command help | Admins |
/pingplayer reload |
Reload the config file | Admins |
/pingplayer debug |
Toggle full debug mode on/off | Admins |
/pingplayer dump |
Generate a full diagnostic 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 | Admins |
Admins are vanilla operators, players with the permission playerping.admin, or players whose LuckPerms group weight is at least minLuckPermsWeight (default 8).
Examples
/pingplayer threshold terrible equal-or-more 500/pingplayer threshold fair 101 250/pingplayer reload
โ๏ธ Config
Settings are saved in config/player-ping/config.json. Change the tiers in-game, and edit the other settings in the file followed by /pingplayer reload.
showPingOnTab(defaulttrue): show ping in the tab list.tabRefreshTicks(default20): how often the tab list updates (20 ticks = 1 second).accuratePing(defaulttrue): measure ping with a small packet per player each second. Set tofalseif an anti-cheat objects; Minecraft's normal value is used instead.minLuckPermsWeight(default8): LuckPerms weight that counts as admin.
๐งฉ Placeholders
Install Placeholder API (optional) together with a mod that shows placeholders, such as a hologram mod:
| Placeholder | Example output |
|---|---|
%pingplayer:ping% |
42 ms (colored by tier) |
%pingplayer:quality% |
excellent (colored by tier) |
Example hologram text: Welcome %player:displayname%, your ping is %pingplayer:ping% would show as Welcome Steve, your ping is 10 ms.
๐งช 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 (50 ms or less)
- ๐ก Yellow - Good (51 - 100 ms)
- ๐ Gold - Fair (101 - 200 ms)
- ๐ด Red - Poor (201 - 300 ms)
- ๐ฅ Dark Red - Terrible (301 ms or more)
(Default ranges, configurable in-game.)
๐ป Installation
- Download the
.jarthat matches your loader and Minecraft version. - Place it in your server's
/modsfolder. - Restart the server.
๐ Compatibility
- Fabric: 1.21.x use java 21, 26.1 - 26.3 use java 25.
- NeoForge: WIP.
- Side: server-side only.
- Requires Fabric API on Fabric. Placeholder API is optional.


