Mentions

Notify players by name with a sound, an action bar message, and an optional title.

When a player types another player's name in chat, zArrowChat can highlight the name and alert the mentioned player. Players can turn their own alerts off, and a cooldown stops mention spam. Everything is set in mentions.yml.

How detection works

zArrowChat matches exact usernames, case-insensitive. Typing Steve and steve both mention the player named Steve. Only real online usernames are matched, so ordinary words are left alone.

A matched name is restyled in the message using highlight-format (by default a bold gold @name).

Notification channels

The mentioned player can be alerted three ways. Each is toggled on its own:

Channel	What it does	Default
`sound`	Plays a sound to the mentioned player	on
`actionbar`	Shows a message above the hotbar	on
`title`	Shows a title and subtitle on screen	off

The action bar and title text use <sender> for the name of the player who sent the mention.

Opt-out and cooldown

Players can turn their own mention alerts off with /togglementions. The choice is saved, so it survives reconnects.

cooldown-seconds sets how long to wait before the same player can be alerted again. This stops rapid repeat pings.

Mention keys

Key	What it controls	Default
`enabled`	Turn mentions on or off	`true`
`toggle-permission`	Permission to toggle your own alerts	`zarrowchat.mentions.toggle`
`notify-permission`	Permission to receive alerts	`zarrowchat.mentions.notify`
`cooldown-seconds`	Per-player cooldown between alerts	`8`
`highlight-format`	How a mention renders in chat	`<gold><bold>@<player></bold></gold>`
`sound.enabled`	Play a sound on mention	`true`
`actionbar.enabled`	Show an action bar on mention	`true`
`title.enabled`	Show a title on mention	`false`

Example config

# mentions.yml
enabled: true
toggle-permission: "zarrowchat.mentions.toggle"
notify-permission: "zarrowchat.mentions.notify"
cooldown-seconds: 8
highlight-format: "<gold><bold>@<player></bold></gold>"

sound:
  enabled: true
  name: "ENTITY_EXPERIENCE_ORB_PICKUP"
  volume: 0.8
  pitch: 1.25

actionbar:
  enabled: true
  text: "<gold><sender></gold> <gray>mentioned you."

title:
  enabled: false
  title: "<gold>Mentioned"
  subtitle: "<gray><sender> mentioned you"

Permissions

Permission	What it grants	Default
`zarrowchat.mentions.toggle`	Toggle your own mention alerts	true
`zarrowchat.mentions.notify`	Receive mention alerts	true