📊 PingPlayer

🚀 A lightweight ping and IP management plugin for Minecraft servers

---

✨ Features

• 🔍 Check Player Ping - View your own or other players' latency with /ping [player]
• 🌐 IP Lookup - Easily access player IP addresses with /ip <player>
• 📋 Tablist Integration - See ping values directly in the tab list with color coding
• ⚙️ Fully Configurable - Customize ping thresholds to suit your server
• 🎯 Permissions Based - Control which players have access to each feature
• 🚦 Visual Indicators - Color-coded ping display makes it easy to identify connection quality

---

📝 Commands

Command	Description
📊 /ping	Check your own ping
📊 /ping <player>	Check another player's ping
🌐 /ip <player>	View a player's IP address
⚙️ /pingplayer reload	Reload the plugin configuration
❓ /pingplayer help	Display admin command help

---

🛡️ Permissions

• pingplayer.ping - Use the ping command
• pingplayer.ip - View player IP addresses
• pingplayer.settings - Access admin commands
• pingplayer.viewping - View ping on tablist

---

🎨 Ping Quality Indicators

PingPlayer automatically color-codes ping values for easy recognition:

• 🟢 Green — Excellent connection (0–50 ms)
• 🟡 Yellow — Good connection (51–100 ms)
• 🟠 Gold — Fair connection (101–200 ms)
• 🔴 Red — Poor connection (201–300 ms)
• 🟣 Dark Red — Terrible connection (301 ms and above)

All thresholds are fully customizable in the config.yml!

---

💻 Installation

1. Download the PingPlayer.jar
2. Drop it into your server's /plugins folder
3. Restart your server
4. Enjoy! 🎉

---

⚙️ Configuration

Simple, straightforward configuration with sensible defaults:

ping-thresholds:
  excellent: 50   # Green
  good: 100       # Yellow
  medium: 200     # Gold
  bad: 300        # Red
  # Anything higher = Dark Red

---

🔄 Compatibility

✅ Compatible with Paper servers and forks of it

✅ Works with Minecraft 1.21+

✅ Supports Folia

---

🤝 Support & Contributions

Having issues or want to contribute? Check out our GitHub repository!

---

📜 License

PingPlayer is available under the MIT License.