PlayerChatPing

Ever typed someone's name in chat and they just... didn't see it? Yeah. This fixes that.

Write a player's name in chat, with @ or without, and they get pinged. Their name lights up yellow in the message, they hear a ding, and (if you want) a little pop-up shows. Everyone else sees the message exactly as it was. No spam, no extra lines in chat.

What it does 🔔

• Ping by full username, @Name or just Name
• Pinged player sees their name highlighted + hears a sound
• The sender also sees the name highlighted in their own message, and the pinged player lights up in TAB for a few seconds
• Pop-up styles: title, subtitle, actionbar, boss (bossbar that drains as a countdown), everything, or none
• Players can turn pings off with /playerchatping toggle
• Cooldown so nobody can spam-ping (per player or per target, your call)
• Add your own prefixes, !, #, whatever
• Matches nicknames too if you use Essentials nicks (can be turned off)
• Works with your chat plugin. On Paper it hooks into the chat renderer so EssentialsX Chat, CMI, ChatControl and friends keep their formatting

Hooks 🔌

• TAB – the tab highlight is done per viewer through a relational placeholder, so only the sender sees it
• LuckPerms – %prefix% and %suffix% in pop-up messages
• PlaceholderAPI – placeholders inside pop-ups, plus %playerchatping_enabled%, %playerchatping_status%, %playerchatping_cooldown%, %playerchatping_prefixes%

All optional. Nothing breaks if they're missing.

Commands

/playerchatping help
/playerchatping toggle
/playerchatping toggle <player>
/playerchatping cooldown <seconds>
/playerchatping prefix add <prefix>
/playerchatping prefix remove <prefix>
/playerchatping prefix list
/playerchatping info
/playerchatping reload

/pcp and /chatping work as aliases.

Permissions

Permission	Default
playerchatping.use	everyone
playerchatping.receive	everyone
playerchatping.help	everyone
playerchatping.toggle	everyone
playerchatping.toggle.others	op
playerchatping.bypass.cooldown	nobody (grant it)
playerchatping.bypass.toggle	nobody (grant it)
playerchatping.admin (+ .reload .info .cooldown .prefix)	op
playerchatping.*	nobody (grant it)

Config

Clean, no comment walls. Standard & colour codes and &#RRGGBB hex. Everything the commands do can be changed here too.

prefixes:
  - "@"
require-prefix: false
case-sensitive: false

highlight:
  receiver: "&e"
  sender: "&e"

cooldown:
  seconds: 5
  per-target: true

sound:
  name: "entity.experience_orb.pickup"
  volume: 1.0
  pitch: 1.0

popup:
  type: actionbar
  actionbar: "&e%sender% &7mentioned you in chat"

tab:
  color: "&e"
  seconds: 10

Notes

• If you don't run TAB, the tab highlight falls back to briefly recolouring the name for everyone. Set tab.without-tab-plugin: none if you'd rather it didn't.
• Chat plugins that cancel the chat event and send messages themselves won't get the highlight (nothing any plugin can do there), but the sound and pop-up still work if you set chat.ignore-cancelled: false.

Support 💬

Found a bug, need help setting it up, or want something added? Hop into the Discord: https://discord.gg/M48jfjrykS