Mentions

Whenever a channel message contains another player's name, AstralChat fires a mention notification at that player — a sound, a title, and the resolved subtitle from messages.yml. Mentions work across servers via the ChatMentionPacket.

How it triggers

After DefaultChannelChatListener finishes rendering a chat message, it scans the raw text for substrings that match online player names (MentionService). For each match:

If the mentioned player is on the same server, the notification fires locally.
If the mentioned player is on another server, a ChatMentionPacket is published on the astralchat.mentions exchange.

The receiving server reads the packet, looks up the player, and delivers the notification if they are still online and have mentions enabled.

Receiving

A mentioned player who has mentions enabled gets:

Sound minecraft:entity.player.levelup at their location.
A title rendered from mention-title and mention-subtitle in messages.yml.
- %sender% resolves to the sender's name.

The shipped defaults:

mention-title: "%sender%"
mention-subtitle: "Vous avez été mentionné dans un message !"

Toggling

Players control mentions via the toggle-chat-mentions AstralCore action (typically wired to a menu button). The flag lives on PlayerChatData.mentionsEnabled and is persisted by AstralSync.

Confirmation messages: mentions-enabled/mentions-disabled.

The %chat_mentionsEnabled% placeholder returns the current state and is useful for menu visibility:

- type: compare
  value: "%chat_mentionsEnabled% == true"

See Actions for the action reference and Placeholders for the full placeholder list.

Last modified: 25 July 2026