⚡ ChatBubble

Ever wanted to know your ping without opening the debug screen? Just type /ping and done.

---

Please contact me on Discord if you have any suggestions or edits.

---

🎯 What Does It Do?

PingCommand adds a simple /ping command that instantly shows your current latency to the server. That's it. No bloat. No lag. Just your ping.

---

⌨️ Commands & Permissions

Command	Access	Description
/pingcommand:use	Everyone	Finds the player
/pingcommand:reload	Operator	Reloads the configuration

---

📁 Config

A folder named PingCommand is created in your plugins folder automatically. Inside you will find a clean config.yml file.

# ============================================================
#                   PingCommand Configuration
# ============================================================
# Useful Placeholders:
# [Ping]   - The player's latency (e.g., 42ms)
# [Player] - The player's username (e.g., Steve)
#
# Support:
# - Hex Colors: &#FFFFFF
# - Legacy Colors: &a, &l, etc.
# ============================================================

# ------------------------------------------------------------
# Section 1: Self Ping Settings
# Configuration for when a player checks their own ping.
# ------------------------------------------------------------
chat-message:
  enabled: true
  text: "&fYour Ping is &a[Ping]"

actionbar-message:
  enabled: false
  text: "&fYour Ping is &a[Ping]"

title-message:
  enabled: false
  text: "&a[Ping]"

# ------------------------------------------------------------
# Section 2: Target Ping Settings
# Configuration for checking another player's ping (/ping <player>).
# Permission: pingcommand.others
# ------------------------------------------------------------
others-check:
  # Enable or disable the ability to check other players' ping.
  # Note: A server restart is required for this change to take effect.
  enabled: true

  # Toggle whether to use the specialized ranges defined in Section 5.
  use-ranges: false

  chat-message:
    enabled: true
    text: "&6[Player]'s &fPing is &a[Ping]"
  
  actionbar-message:
    enabled: false
    text: "&6[Player]'s &fPing is &a[Ping]"
  
  title-message:
    enabled: false
    text: "&6[Player]: &a[Ping]"

# ------------------------------------------------------------
# Section 3: Audio Effects
# Play a sound effect when the command is used.
# Sound list: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
# ------------------------------------------------------------
sound:
  enabled: false
  name: "ENTITY_EXPERIENCE_ORB_PICKUP"

# ------------------------------------------------------------
# Section 4: Self Ping Ranges
# Customize messages based on how much lag the player has.
# ------------------------------------------------------------
ping-ranges:
  enabled: false

  # Low Latency (0 - 299ms)
  good:
    chat-message: {enabled: true, text: "&fYour Ping is &a[Ping]"}
    actionbar-message: {enabled: false, text: "&a[Ping]"}
    title-message: {enabled: false, text: "&a[Ping]"}

  # Medium Latency (300 - 499ms)
  medium:
    chat-message: {enabled: true, text: "&fYour Ping is &e[Ping]"}
    actionbar-message: {enabled: false, text: "&e[Ping]"}
    title-message: {enabled: false, text: "&e[Ping]"}

  # High Latency (500ms+)
  bad:
    chat-message: {enabled: true, text: "&fYour Ping is &c[Ping]"}
    actionbar-message: {enabled: false, text: "&c[Ping]"}
    title-message: {enabled: false, text: "&c[Ping]"}

# ------------------------------------------------------------
# Section 5: Target Ping Ranges
# Customize messages when checking another player's latency.
# Only active if 'use-ranges' in Section 2 is set to true.
# ------------------------------------------------------------
others-ranges:
  good:
    chat-message: {enabled: true, text: "&6[Player]'s &fPing is &a[Ping]"}
    actionbar-message: {enabled: false, text: "&a[Ping]"}
    title-message: {enabled: false, text: "&a[Ping]"}

  medium:
    chat-message: {enabled: true, text: "&6[Player]'s &fPing is &e[Ping]"}
    actionbar-message: {enabled: false, text: "&e[Ping]"}
    title-message: {enabled: false, text: "&e[Ping]"}

  bad:
    chat-message: {enabled: true, text: "&6[Player]'s &fPing is &c[Ping]"}
    actionbar-message: {enabled: false, text: "&c[Ping]"}
    title-message: {enabled: false, text: "&c[Ping]"}

# ------------------------------------------------------------
# Section 6: Plugin Administration
# ------------------------------------------------------------
command-alias:
  # Enable a shorter alias (like /p) for the main command.
  enabled: true
  name: "/p"

---

📥 Installation

1. Download the latest version of PingCommand.
2. Drop the .jar file into your server's plugins folder.
3. Restart your server.
4. Done! No additional setup required.

✅ Supported Versions

• 1.21.x

💻 Supported Platforms

• Paper, Folia, Purpur, Spigot, Bukkit

---

---

© 2026 FindPlayer. All rights reserved to MIT.