pinger

Pinger

Displays each player's real-time ping in the tab list, color-coded by latency threshold. Includes a private /ping command and full runtime control via admin commands.

---

Features

• Live ping indicator in the tab list, refreshed on a configurable interval
• Color-coded thresholds — configurable colors, values, and bracket style
• Private /ping command — response is only visible to the sender
• Runtime toggle for tab display and /ping command without a server restart
• Full internationalization — drop any .yml into lang/ and point config to it
• Bundled languages: English (en_US) and Custom

---

Ping Thresholds

All values and colors are editable in config.yml.

---

Commands

/pinger on and /pinger off without an argument toggle both at once.
Runtime changes reset to config.yml values on /pinger reload.

---

Permissions

---

Configuration

Generated automatically on first launch with full inline documentation.

general:
  enabled: true
  update-interval: 20        # 20 ticks = 1 second
  language: en_US

display:
  show-in-tab: true
  ping-command-enabled: true
  show-ms-suffix: true
  brackets:
    open: "["
    close: "]"
    color: GRAY
    bold: true

thresholds:
  excellent:  { max: 35,   color: GREEN    }
  good:       { max: 99,   color: GOLD     }
  warning:    { max: 999,  color: RED      }
  critical:   { min: 1000, color: DARK_RED, bold: true, text: "CRITICAL" }

---

Custom Language

1. Create plugins/pinger/lang/your_lang.yml — use en_US.yml as a template
2. Set language: your_lang in config.yml
3. Run /pinger reload

& color codes and placeholders ({ping}, {player}, etc.) are fully supported.

---

Requirements

• Paper 1.21+ (or any Paper fork)
• Java 21+