Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChatPing

Discord-style @mention pings for Paper Minecraft servers. When a player types @Name in chat, the mentioned player gets a highlighted message, an action-bar flash, and a two-note sound chime — so they never miss being tagged.

Features

  • @mention detection in chat (case-insensitive), with the mention re-styled in a configurable colour/bold/italic.
  • Sound + action-bar alert for the pinged player (fully configurable two-note chime).
  • /pingtoggle so players can opt out of being pinged.
  • Cooldown on how often a player can ping (with a bypass permission).
  • Blacklist of names that can never be pinged.
  • Smart tab-completion: type @ in chat and get online player names, sorted, excluding yourself.

Requirements

  • Paper 1.21.8+ (uses the Adventure API and AsyncChatEvent)
  • Java 21

Building

mvn clean package

The compiled plugin will be at target/ChatPing-1.0.jar. Drop it into your server's plugins/ folder and restart.

Commands

Command Aliases Permission Description
/pingtoggle /ptoggle, /pings chatping.toggle Toggle whether others can mention you

Permissions

Permission Default Description
chatping.toggle everyone Allows toggling your own pings
chatping.bypasscooldown op Bypass the mention cooldown

Configuration

config.yml lets you customise the prefix, ping message, mention highlight style, primary/secondary sounds, action-bar message, cooldown, and blacklist. See the generated file for the full list with comments.

Notes

  • Ping toggle state is kept in memory and resets when the server restarts.

License

MIT © 2026 Scappi

About

Discord-style @mention pings for Paper Minecraft servers

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages