Scribe’s Mention system ensures players never miss a message directed at them, even on busy servers.

Configuration

Mentions are configured globally in config.yml.

mentions:
  enabled: true
  symbol: "@"
  sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
  title-enabled: false
  actionbar-enabled: true
  cooldown-seconds: 5.0
  max-mentions-per-message: 3

Mentioning a Player

To ping someone, a player simply types the symbol followed by the target’s username (or partial username). For example: "Hey @Steve, are you coming?"

Notifications

When mentioned, Scribe immediately notifies the target player:

1. It plays the specified Bukkit sound (e.g. ENTITY_EXPERIENCE_ORB_PICKUP).
2. It sends an ActionBar message (actionbar-enabled: true).
3. It highlights the mention in chat. The visual highlight format is defined in formats.yml:

   # formats.yml
   mentions:
     format: "<primary><b>{mention}</b></primary>"

Spam Prevention

To prevent abuse, Scribe enforces limits:

• cooldown-seconds: Players must wait this long before pinging someone again.
• max-mentions-per-message: Prevents players from pinging the entire server in a single message by capping the amount of valid @ parses.